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

# Revoke a report

> Withdraw one of your reports, for example because you overturned the ban on appeal. The entry stops matching at once and is deleted after 30 days. Revoke as soon as a ban is overturned, because other members may be refusing the person because of it.

Withdraw one of your reports, for example when you overturn the ban on appeal. Revoking an entry that is already revoked returns it unchanged. See [Revoke a report](/registry/reporting#revoke-a-report).


## OpenAPI

````yaml api-reference/openapi.json POST /api/v1/registry/entries/{id}/revoke
openapi: 3.1.0
info:
  title: Omnifence API
  description: >-
    Content moderation API. Clients submit images or videos which pass through a
    classification pipeline and receive a pass/reject decision.
  version: 1.0.0
  contact:
    email: support@omnifence.ai
servers:
  - url: http://localhost:3051
    description: Local development
security:
  - bearerAuth: []
tags:
  - name: Moderation
    description: Submit moderation jobs
  - name: Jobs
    description: Query job status and progress
  - name: Webhooks
    description: Webhook registration
  - name: Shared Registry
    description: >-
      Cross-platform banned-user registry for vetted members (requires
      registry:check or registry:submit)
  - name: Account
    description: Authenticated client account settings
paths:
  /api/v1/registry/entries/{id}/revoke:
    post:
      tags:
        - Shared Registry
      summary: Revoke a report
      description: >-
        Withdraw one of your reports, for example because you overturned the ban
        on appeal. The entry stops matching at once and is deleted after 30
        days. Revoke as soon as a ban is overturned, because other members may
        be refusing the person because of it.
      operationId: revokeRegistryEntry
      parameters:
        - schema:
            type: string
            format: uuid
          in: path
          name: id
          required: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
                - reason
              properties:
                reason:
                  type: string
                  minLength: 1
                  maxLength: 500
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  entry_id:
                    type: string
                    format: uuid
                  identifier_type:
                    type: string
                  category:
                    type: string
                    enum:
                      - payment_fraud
                      - prohibited_content
                      - ban_evasion
                  member_case_ref:
                    type: string
                  status:
                    type: string
                    enum:
                      - active
                      - disputed
                      - revoked
                      - expired
                  has_open_dispute:
                    type: boolean
                  created_at:
                    type: string
                    format: date-time
                  updated_at:
                    type: string
                    format: date-time
                  expires_at:
                    type: string
                    format: date-time
                  revoked_at:
                    type:
                      - 'null'
                      - string
                    format: date-time
                  revoke_reason:
                    type:
                      - 'null'
                      - string
                required:
                  - entry_id
                  - identifier_type
                  - category
                  - member_case_ref
                  - status
                  - has_open_dispute
                  - created_at
                  - updated_at
                  - expires_at
                  - revoked_at
                  - revoke_reason
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key from the Omnifence dashboard

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.