Skip to content

Add a user to a team

POST
/teams/{id}/members

Requires teams.admin. Idempotent — adding an existing member is a no-op.

id
required
string format: uuid
object
user_ref
required
integer format: int64

Added

Malformed request

object
error
required

Human-readable error summary

string
Example
the request could not be completed

Authentication required, missing, or invalid

object
error
required

Human-readable error summary

string
Example
the request could not be completed
Example
{
"error": "authentication required: sign in and retry with a valid session or API token"
}

Authenticated but missing required capabilities

object
error
required

Human-readable error summary

string
Example
the request could not be completed

Resource not found

object
error
required

Human-readable error summary

string
Example
the request could not be completed