> ## Documentation Index > Fetch the complete documentation index at: https://docs.flowpayroll.ai/llms.txt > Use this file to discover all available pages before exploring further. # Remove a person's grant on one organisation > Idempotent: removing a grant they do not hold answers the same as removing one they did. Everything else is left alone, including account-wide access — somebody holding it still reaches this organisation afterwards, and the response shows that. 400 `user_access_would_be_empty` when it would leave them reaching nothing at all — grant them another organisation first, or have the account owner remove them with `DELETE /users/{principalId}`. A guest is the exception: taking back the last organisation you granted is exactly how guest access ends, and their own account elsewhere is untouched. 409 `cannot_remove_own_last_access` when the grant is your own last access — ask another administrator. ## OpenAPI ````yaml /api-reference/specs/administration.json delete /users/{principalId}/organisations/{organisationId} openapi: 3.0.1 info: title: Administration API description: >- Manage your Flow Payroll account: the organisations it owns, the people who can sign in to it, the API tokens it holds, its brand, and a feed of recent administration activity. Every resource is scoped to the account your credentials belong to, so no request ever names a customer and the `X-Org-Id` header is not used. version: v1 servers: - url: https://api.sandbox.flowpayroll.ai/v1/administration security: - X-Auth-Token: [] tags: - name: Customer description: >- Your account: the customer every other resource on this API belongs to. Read it and rename it. - name: Organisations description: >- The organisations your account owns: list them with headcounts and your access to each, get one in full, and add one or several at a time. - name: Users description: >- The people who can sign in to your account: list, invite (one or many), resend invitations, and manage each person's direct grants and account-wide access. - name: API tokens description: >- The client credentials your integrations authenticate with: create (the secret is shown once), rename, rotate, revoke, and manage which organisations each token reaches. - name: Activity description: Recent administration actions in your account, newest first. paths: /users/{principalId}/organisations/{organisationId}: delete: tags: - Users summary: Remove a person's grant on one organisation description: >- Idempotent: removing a grant they do not hold answers the same as removing one they did. Everything else is left alone, including account-wide access — somebody holding it still reaches this organisation afterwards, and the response shows that. 400 `user_access_would_be_empty` when it would leave them reaching nothing at all — grant them another organisation first, or have the account owner remove them with `DELETE /users/{principalId}`. A guest is the exception: taking back the last organisation you granted is exactly how guest access ends, and their own account elsewhere is untouched. 409 `cannot_remove_own_last_access` when the grant is your own last access — ask another administrator. operationId: RevokeUserOrganisation parameters: - name: principalId in: path required: true schema: type: string - name: organisationId in: path required: true schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/UserOrganisationsResponseResponseBody' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ObjectResponseBody' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ObjectResponseBody' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ObjectResponseBody' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/ObjectResponseBody' '409': description: Conflict content: application/json: schema: $ref: '#/components/schemas/ObjectResponseBody' components: schemas: UserOrganisationsResponseResponseBody: type: object properties: message: $ref: '#/components/schemas/MessageWithTokenResponse' content: $ref: '#/components/schemas/UserOrganisationsResponseContentResponse' validationIssues: type: array items: $ref: '#/components/schemas/ValidationIssue' nullable: true additionalProperties: false ObjectResponseBody: type: object properties: message: $ref: '#/components/schemas/MessageWithTokenResponse' content: $ref: '#/components/schemas/ObjectContentResponse' validationIssues: type: array items: $ref: '#/components/schemas/ValidationIssue' nullable: true additionalProperties: false MessageWithTokenResponse: type: object properties: text: type: string token: type: string tokenArguments: type: array items: $ref: '#/components/schemas/ValidationIssueArgument' nullable: true additionalProperties: false UserOrganisationsResponseContentResponse: type: object properties: data: $ref: '#/components/schemas/UserOrganisationsResponse' metadata: $ref: '#/components/schemas/ContentMetadataResponse' additionalProperties: false ValidationIssue: type: object properties: field: type: string reason: type: string reasonToken: type: string reasonTokenArguments: type: array items: $ref: '#/components/schemas/ValidationIssueArgument' nullable: true additionalProperties: false ObjectContentResponse: type: object properties: data: nullable: true metadata: $ref: '#/components/schemas/ContentMetadataResponse' additionalProperties: false ValidationIssueArgument: type: object properties: name: type: string value: nullable: true additionalProperties: false UserOrganisationsResponse: type: object properties: principalId: type: string description: The person. organisationIds: type: array items: type: string description: Every organisation they hold a direct grant on. coversWholeCustomer: type: boolean description: >- Whether they also hold account-wide access, which reaches every organisation the account owns, including ones added later. Read this before treating an empty list as no access. Nothing on the organisations collection can create or remove it. additionalProperties: false description: The organisations one person reaches, after a read or a change. ContentMetadataResponse: type: object properties: dateFormat: type: string dateTimeFormat: type: string paginationToken: type: string nullable: true additionalProperties: false securitySchemes: X-Auth-Token: type: apiKey description: FlowPayroll JWT (raw token, no Bearer prefix) name: X-Auth-Token in: header ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.