Update a team's role with the APC API

The examples on this page show common ways to use the APC API — they’re not a complete API reference. For the full, interactive API documentation for your installation, including every available query, mutation, and type, go to https://houston.<your-base-domain>/v1, and click on the Docs tab. See Develop and test APC API queries for more on using the built-in GraphQL explorer.

Update a team’s workspace role

1mutation {
2 workspaceUpdateTeamRole(
3 teamUuid: "<team-uuid>"
4 workspaceUuid: "<workspace-uuid>"
5 role: WORKSPACE_ADMIN
6 )
7}

Update a team’s Deployment role

1mutation {
2 deploymentUpdateTeamRole(
3 teamUuid: "<team-uuid>"
4 deploymentUuid: "<deployment-uuid>"
5 role: DEPLOYMENT_ADMIN
6 ) {
7 id
8 role
9 }
10}

For the full teams model, roles, and error reference, see team management reference.