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

# Cancel a collection request

> Invalidates a single live collection link (the token id surfaced in `pending_requests`) so it can no longer authorize a collect submit. Idempotent: re-cancelling an already-gone request (consumed, cancelled, or expired) is a success no-op. A request id not belonging to the named Beneficiary in the caller's tenant is not found.



## OpenAPI

````yaml DELETE /v1/beneficiaries/{id}/collection-requests/{requestId}
openapi: 3.0.0
info:
  title: Cleff API
  description: >-
    Payout orchestration platform. All endpoints under /v1/ require an API key
    in the Authorization header (Bearer ck_<env>_<id>_<secret>).
  version: 0.0.1
  contact: {}
servers: []
security: []
tags: []
paths:
  /v1/beneficiaries/{id}/collection-requests/{requestId}:
    delete:
      tags:
        - Beneficiaries
      summary: Cancel a pending collection request
      description: >-
        Invalidates a single live collection link (the token id surfaced in
        `pending_requests`) so it can no longer authorize a collect submit.
        Idempotent: re-cancelling an already-gone request (consumed, cancelled,
        or expired) is a success no-op. A request id not belonging to the named
        Beneficiary in the caller's tenant is not found.
      operationId: BeneficiariesController_cancelCollectionRequest
      parameters:
        - name: id
          required: true
          in: path
          schema:
            type: string
        - name: requestId
          required: true
          in: path
          schema:
            type: string
      responses:
        '204':
          description: Request cancelled (or already gone — idempotent)
        '401':
          description: Missing or invalid credentials
        '404':
          description: Beneficiary or collection request not found
      security:
        - api_key: []
components:
  securitySchemes:
    api_key:
      scheme: bearer
      bearerFormat: ck_<env>_<id>_<secret>
      type: http
      description: >-
        Cleff API key issued to a Business that self-registers via POST
        /v1/registration

````