> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mangrovesystems.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Revoke an auditor

> Withdraws an auditor's access to one report, addressed by email. The report stops being reachable for them on their next request. Access to any other report shared with the same auditor is untouched.

Requires Audit Hub to be enabled on the account, and a token with Accounting and Reporting write permission.



## OpenAPI

````yaml DELETE /reports/{report_id}/revoke
openapi: 3.1.0
info:
  title: Mangrove - API
  version: 1.1.0
servers:
  - url: https://app.gomangrove.com/api/v1
security:
  - sec0: []
paths:
  /reports/{report_id}/revoke:
    delete:
      summary: Revoke an auditor's access
      description: >-
        Withdraws an auditor's access to one report, addressed by email. The
        report stops being reachable for them on their next request. Access to
        any other report shared with the same auditor is untouched.


        Requires Audit Hub to be enabled on the account, and a token with
        Accounting and Reporting write permission.
      operationId: revoke-report-auditor
      parameters:
        - name: report_id
          in: path
          schema:
            type: string
          required: true
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - auditor
              properties:
                auditor:
                  type: object
                  required:
                    - email
                  properties:
                    email:
                      type: string
                      format: email
            examples:
              Request Example:
                value:
                  auditor:
                    email: auditor@example.com
      responses:
        '204':
          description: '204'
        '403':
          description: '403'
          content:
            application/json:
              examples:
                Result:
                  value:
                    errors:
                      - message: Auditor invitations are not enabled for this account
        '404':
          description: '404'
          content:
            application/json:
              examples:
                No active auditor:
                  value:
                    errors:
                      - message: No active auditor for that email on this report
                Unknown report:
                  value:
                    errors:
                      - message: Record not found
      deprecated: false
components:
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      name: Authorization
      x-bearer-format: ''

````