CreateTeamMember

POST/api/v1/teams/{team}/members

Add a user to a team, which grants them everything the team has access to.

Example request

US
Europe

curl -X POST \
  -H "Authorization: Bearer ${OBLIQUE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{ "member": "string" }' \
  "https://us.oblique.security/api/v1/teams/{team}/members"

Set OBLIQUE_API_KEY to your API key.

curl -X POST \
  -H "Authorization: Bearer ${OBLIQUE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{ "member": "string" }' \
  "https://eu.oblique.security/api/v1/teams/{team}/members"

Set OBLIQUE_API_KEY to your API key.

Path parameters

parentstringrequired
ID of the parent.

Format: teams/{team}

Query parameters

teamMemberIdstring
ID of the team to create. This value should be 4-63 characters. Valid characters are /[a-z][0-9]-/.

Request body

namestring
Assigned by Oblique. The name of the membership. Memberships are always child resources of a given team. The {member} component is an arbitrary identifier, and doesn’t correspond to the actual member.

Format: teams/{team}/members/{member}
managementManagement
How this membership is managed. Inherited from the parent team: memberships of Terraform-managed teams are themselves Terraform managed and can only be created, updated, or deleted through the Terraform provider; manage the parent team to change this. Omitted from responses when the parent team is manually managed (the default).
- managerstring
  Allowed values: TERRAFORM
  How the resource is managed. Set automatically by the server based on the caller: Terraform clients produce TERRAFORM; for all other clients the management field is left unset on the response.
- repoUristring
  URI of the VCS repository that holds the Terraform configuration for this resource. Populated by the Oblique Terraform provider.
- repoDirstring
  Optionally, the subdirectory within repo_uri that holds the Terraform configuration for this resource. Populated by the Oblique Terraform provider.
createTimestring (date-time)read-only
Create and update timestamps.
updateTimestring (date-time)read-only
memberstringrequired
The name of the member. This currently only supports users, but will be expanded to support teams as well. Immutable after creation.

Format: users/{user}
justificationstring
Why the user is part of the team.
requeststringread-only
If present, the request that most recently created or updated this membership.

Format: requests/{request}

Response

200TeamMember

A membership in a team.

namestring
Assigned by Oblique. The name of the membership. Memberships are always child resources of a given team. The {member} component is an arbitrary identifier, and doesn’t correspond to the actual member.

Format: teams/{team}/members/{member}
managementManagement
How this membership is managed. Inherited from the parent team: memberships of Terraform-managed teams are themselves Terraform managed and can only be created, updated, or deleted through the Terraform provider; manage the parent team to change this. Omitted from responses when the parent team is manually managed (the default).
- managerstring
  Allowed values: TERRAFORM
  How the resource is managed. Set automatically by the server based on the caller: Terraform clients produce TERRAFORM; for all other clients the management field is left unset on the response.
- repoUristring
  URI of the VCS repository that holds the Terraform configuration for this resource. Populated by the Oblique Terraform provider.
- repoDirstring
  Optionally, the subdirectory within repo_uri that holds the Terraform configuration for this resource. Populated by the Oblique Terraform provider.
createTimestring (date-time)read-only
Create and update timestamps.
updateTimestring (date-time)read-only
memberstringrequired
The name of the member. This currently only supports users, but will be expanded to support teams as well. Immutable after creation.

Format: users/{user}
justificationstring
Why the user is part of the team.
requeststringread-only
If present, the request that most recently created or updated this membership.

Format: requests/{request}

Errors

Status	Meaning
`400`	Malformed request
`401`	Missing or invalid API key
`403`	Not allowed for this API key
`404`	Not found
`429`	Too many requests
`500`	Internal server error