--- title: companyLocationRevokeRoles - GraphQL Admin description: Revokes roles on a company location. api_version: 2025-10 api_name: admin type: mutation api_type: graphql source_url: html: https://shopify.dev/docs/api/admin-graphql/latest/mutations/companylocationrevokeroles md: https://shopify.dev/docs/api/admin-graphql/latest/mutations/companylocationrevokeroles.md --- # company​Location​Revoke​Roles mutation Requires `write_customers` access scope or `write_companies` access scope. Also: The API client must be installed on a Shopify Plus store. Revokes roles on a company location. ## Arguments * company​Location​Id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) required The location whose roles are being revoked. * roles​To​Revoke [\[ID!\]!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) required The current roles to revoke. *** ## Company​Location​Revoke​Roles​Payload returns * revoked​Role​Assignment​Ids [\[ID!\]](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) A list of role assignment IDs that were removed from the company location. * user​Errors [\[Business​Customer​User​Error!\]!](https://shopify.dev/docs/api/admin-graphql/latest/objects/BusinessCustomerUserError) non-null The list of errors that occurred from executing the mutation. *** ## Examples * ### companyLocationRevokeRoles reference ## Mutation Reference ```graphql mutation companyLocationRevokeRoles($companyLocationId: ID!, $rolesToRevoke: [ID!]!) { companyLocationRevokeRoles(companyLocationId: $companyLocationId, rolesToRevoke: $rolesToRevoke) { revokedRoleAssignmentIds userErrors { field message } } } ``` ## Input ##### Variables ```json { "companyLocationId": "gid://shopify//10079785100", "rolesToRevoke": [ "gid://shopify//10079785100" ] } ```