PATCH /organizations/{name}/teams/{team}/users/{email}

This operation can be used to modify the role of a user within a team.

Only administrators of the team can invoke this operation.

Resource URL

https://api.cavellc.io/organizations/{name}/teams/{team}/users/{email}

Resource Information

The data must be formatted as JSON, with the following fields:

Field Description Notes
role The role the user should have for this team Mandatory

The request must be authenticated with a valid user token, as obtained from a login operation. See POST /users/login for details. The token can be passed as the username (with an empty password) following the Basic Authentication scheme of the HTTP protocol. Alternatively, the same token can be accepted as a Bearer Token, similar to the OAuth2 specification.

Example Request

curl -i -u 8b896055-c295-4a30-a29c-5a97d15f1818: \
     -X PATCH  -H "Content-Type: application/json" \
     -d '{ "role": "admin" }' \
     https://api.cavellc.io/organizations/acme/users/teams/runners/vdumitrescu%40gilt.com

Example Response

HTTP/1.1 202 Accepted
Content-Length: 0
Connection: keep-alive

See Also

Back to Teams

Back to API Main Page