APC APIExample mutationsTeams

Create 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.

Create local team

1mutation {
2  createTeam(
3    name: "Data Engineering"
4    description: "Data engineering team"
5    provider: "local"
6    userIds: ["<user-uuid-1>", "<user-uuid-2>"]
7  ) {
8    team {
9      id
10      name
11      provider
12      description
13      users {
14        id
15        username
16      }
17    }
18    message
19  }
20}

Create IdP team

IdP group sync automatically creates IdP teams, but you can also create them manually:

1mutation {
2  createTeam(
3    name: "engineering-group"
4    description: "Synced from Okta"
5    provider: "okta"
6  ) {
7    team {
8      id
9      name
10      provider
11    }
12    message
13  }
14}

You can’t assign users to IdP teams at creation time. The IdP syncs users to the team.

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