APC APIExample mutationsTeams

Remove a team 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.

Remove by UUID

1mutation {
2  removeTeam(teamUuid: "<team-uuid>") {
3    id
4    name
5  }
6}

Remove by name and provider

1mutation {
2  removeTeam(
3    name: "Data Engineering"
4    provider: "local"
5  ) {
6    id
7    name
8  }
9}

You can only remove IdP teams that have no attached users.

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