v1
latestOpenAPI 3.0.02026-07-141,4077,1665.2 MBTeams
Add a user to a team
Add a user to a team.
Note: Each team has a setting that determines who is allowed to modify membership of the team. The user_access_manage permission generally grants access to modify membership of any team. To get the full picture, see Team Membership documentation.
post/api/v2/team/{team_id}/memberships
Path parameters
team_idstring required
None
Request body
Example request
{
"data": {
"relationships": {
"team": {
"data": {
"id": "d7e15d9d-d346-43da-81d8-3d9e71d9a5e9",
"type": "team"
}
},
"user": {
"data": {
"id": "b8626d7e-cedd-11eb-abf5-da7ad0900001",
"type": "users"
}
}
},
"type": "team_memberships"
}
}Response
Represents a user's association to a team
Example response
{
"data": {
"id": "TeamMembership-aeadc05e-98a8-11ec-ac2c-da7ad0900001-38835",
"relationships": {
"team": {
"data": {
"id": "d7e15d9d-d346-43da-81d8-3d9e71d9a5e9",
"type": "team"
}
},
"user": {
"data": {
"id": "b8626d7e-cedd-11eb-abf5-da7ad0900001",
"type": "users"
}
}
},
"type": "team_memberships"
},
"included": [
{
"relationships": {
"org": {
"data": {
"id": "00000000-0000-beef-0000-000000000000",
"type": "orgs"
}
},
"other_orgs": {
"data": []
},
"other_users": {
"data": []
},
"roles": {
"data": [
{
"id": "3653d3c6-0c75-11ea-ad28-fb5701eabc7d",
"type": "roles"
}
]
}
},
"type": "users"
}
]
}