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

# Void Document Request

> Cancel and permanently deactivate a document request.

Permanently deactivate a document request. This action expires the request and voids the secure upload link provided to the recipient. Once voided, the recipient will no longer be able to access the upload page or upload any further files.

<Note>
  This endpoint requires the **Document Requests** feature to be enabled for your organisation. If you receive a `403` with `request.organisations.module.not-enabled`, contact your organisation admin to have it activated. [Learn more](/guides/feature-modules).
</Note>

## Immediate Voiding

The guest access token associated with the request is invalidated immediately upon deletion. This is useful for cancelling requests that are no longer needed or were sent to the wrong recipient in error.

## File Retention

Any files that were already uploaded via the request before deletion remain in the associated case and are not removed from the system.

## Best Practices

1. **Confirm Before Deletion**: Provide a confirmation step in your UI before permanently voiding a request to prevent accidental deactivation.
2. **Use for Cancellation**: Proactively void requests that are no longer required to maintain security hygiene and prevent unauthorised uploads.


## OpenAPI

````yaml DELETE /document-requests/{id}
openapi: 3.1.0
info:
  title: Veridox Core API
  description: Veridox Core Platform API
  version: 0.0.1
  contact: {}
servers:
  - url: https://api.uk.veridox.ai
    description: Live (UK)
  - url: https://api.ca.veridox.ai
    description: Live (CA)
security: []
tags:
  - name: Status
    description: System status and health check endpoints
  - name: Cases
    description: Case and case file management
  - name: Organisations
    description: Organisation management
  - name: Document Requests
    description: Document request management
  - name: Search
    description: Search functionality
  - name: Admin
    description: Administrative endpoints
paths:
  /document-requests/{id}:
    delete:
      tags:
        - Document Requests
      summary: Void document request
      description: >-
        Permanently deactivates a document request link. The link will no longer
        be usable by the guest.
      operationId: DocumentRequestsController_deleteDocumentRequest
      parameters:
        - name: id
          required: true
          in: path
          description: Document request ID
          schema:
            type: string
      responses:
        '204':
          description: Document request voided successfully
        '401':
          description: Unauthorized (invalid or missing authentication token)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDto'
        '404':
          description: Document request not found or not owned by user
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDto'
        '429':
          description: Too many requests (rate limit exceeded)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDto'
      security:
        - api-key: []
components:
  schemas:
    ErrorDto:
      type: object
      properties:
        error_code:
          type: string
          description: Machine-readable error code for programmatic handling
          examples:
            - request.cases.file.missing-risk-score
            - request.authentication.invalid-token
            - request.forbidden
            - request.cases.case.not-found
            - request.cases.case.already-locked
        error_message:
          type: string
          description: Human-readable error message explaining what went wrong
          example: >-
            User tried to perform an invalid operation on a file without a risk
            score.
        error_details:
          type: object
          example:
            field: email_address
      required:
        - error_code
        - error_message
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: x-api-key

````