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

# Revoke Delegation

> Revokes a delegation owned by the authenticated user and cascade-revokes its linked permissions. For Visa delegations the linked VGS intent is cancelled best-effort. Requires a Nevermined API key.



## OpenAPI

````yaml DELETE /delegation/{delegationId}
openapi: 3.1.0
info:
  title: Nevermined API
  description: >-
    API for managing AI agents, payment plans, and x402 payments in the
    Nevermined ecosystem.


    ## Prerequisites


    You need a Nevermined API Key to authenticate. Get one at
    [nevermined.app](https://nevermined.app) under **Settings > API Keys**.


    See the [5-Minute Setup Guide](/docs/integrate/quickstart/5-minute-setup)
    for detailed instructions.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.sandbox.nevermined.app/api/v1
    description: Sandbox (Testing) - Base Sepolia
  - url: https://api.live.nevermined.app/api/v1
    description: Live (Production) - Base Mainnet
security:
  - bearerAuth: []
tags:
  - name: Protocol - Agents
    description: Endpoints for registering and managing AI agents
  - name: Protocol - Plans
    description: Endpoints for creating and managing payment plans
  - name: Protocol - Credits
    description: Endpoints for minting and redeeming credits
  - name: Protocol - Access
    description: Endpoints for access tokens and request validation
  - name: X402 - Permissions
    description: Endpoints for x402 delegated permissions
paths:
  /delegation/{delegationId}:
    delete:
      tags:
        - Delegation
      summary: Revoke a delegation
      description: >-
        Revokes a delegation owned by the authenticated user and cascade-revokes
        its linked permissions. For Visa delegations the linked VGS intent is
        cancelled best-effort. Requires a Nevermined API key.
      operationId: DelegationController_revokeDelegation
      parameters:
        - name: delegationId
          required: true
          in: path
          description: UUID v4 of the delegation to revoke.
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: 'The revoke result (`{ success: true }`)'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/_NvmAPIResultDto'
        '404':
          description: Delegation not found
components:
  schemas:
    _NvmAPIResultDto:
      type: object
      properties:
        success:
          type: boolean
          example: true
          description: Indicates whether the API call was successful
        message:
          type: string
          example: Successfully minted
          description: Message describing the result of the API call
        txHash:
          type: string
          example: '0x923812b3c4d5e6f7890abcdef1234567890abcdef1234567890abcdef12345678'
          description: Blockchain transaction hash associated with the API call
        httpStatus:
          type: number
          example: 200
          description: HTTP status code of the API response
        data:
          type: object
          description: Additional parameters related to the API call
          additionalProperties: true
        when:
          format: date-time
          type: string
          description: Timestamp when the API call was made
      required:
        - success
        - message
        - txHash
        - httpStatus
        - data
        - when
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Your Nevermined API Key (starts with 'nvm:'). Get one at
        [nevermined.app](https://nevermined.app) under **Settings > API Keys**.

````

## Related topics

- [x402 Delegation Extension](/docs/specs/x402-card-delegation.md)
- [Delegations](/docs/products/payments/mandates.md)
- [Revoke Permission](/docs/api-reference/x402/revoke-permission.md)
- [Delegation Selection](/docs/products/payments/mandate-selection.md)
- [Revoke Payment Method](/docs/api-reference/payment-methods/revoke-payment-method.md)
