Remove a Deployment user 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.

Use the deploymentRemoveUserRole mutation to remove a user from a Deployment entirely:

1 mutation {
2   deploymentRemoveUserRole(
3     deploymentId: "<deployment-id>"
4     email: "<user-email>"
5   ) {
6     id
7   }
8 }

After the role binding is removed, the user retains their previous access until their JWT expires (up to 24 hours by default).

For the full role-assignment flow, see Manage users on Astro Private Cloud.