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

# Revoke an API key

> Revokes an API key so it can no longer authenticate new requests.

## What this endpoint does

Revokes an API key so it can no longer authenticate new requests.

## When to use it

Revoke a key when an integration is retired, compromised, or replaced.

## Before you call

Use API-key administration access and pass a key ID owned by the same tenant account. Ensure another administrator key remains available.

## Money and balance effect

This changes a resource or configuration but does not directly reserve, debit, credit, or settle wallet money.

## States and completion

Revocation is the terminal key state. It does not cancel money operations already accepted.

## Safe retries

DELETE does not use an `Idempotency-Key`. If the response is lost, list the key first. An already revoked or absent key means there is no active credential left to revoke.

Read [API keys](/console/developers) for the complete workflow.


## OpenAPI

````yaml /api-reference/openapi.json delete /v1/api-keys/{id}
openapi: 3.0.0
info:
  title: Wayex API
  description: >-
    Wayex APIs for direct customer payment routes and isolated, prefunded
    Treasury accounts. Each API key is bound to one tenant account and its own
    wallet, settings, webhooks, and reporting.
  version: 1.0.0
  contact: {}
servers:
  - url: https://api.sandbox.wayex.com
    description: Sandbox integration environment
security:
  - Bearer: []
  - ApiKey: []
tags:
  - name: Treasury
    description: >-
      Prefunded AUD and stablecoin wallets for one isolated tenant account.
      Fund, pay, convert, withdraw, track, and reconcile without selecting
      another account.
  - name: Customers
    description: >-
      Onboard end customers, run verification, and manage each customer's
      entitlements.
  - name: Payment routes
    description: >-
      Standing deposit instructions per customer. When a customer funds a route,
      Wayex auto-converts at the live rate and pays out/sends — no quote, no
      lock.
  - name: Transfers
    description: >-
      Read the conversion records produced when customers fund payment routes —
      the live activity feed and per-conversion lifecycle timeline.
  - name: Rates
    description: >-
      The live indicative AUD↔stablecoin rate right now — the all-in rate Wayex
      quotes. Indicative only; the binding price is struck when a route's funds
      land.
  - name: Revenue
    description: Your developer-fee revenue over time.
  - name: Invoices
    description: >-
      Your monthly invoices — Wayex platform fees due, net of your accrued
      developer-fee credit.
  - name: Webhooks
    description: Subscribe to HMAC-signed event webhooks and inspect deliveries.
  - name: API keys
    description: Create, list, and rotate API keys for programmatic access.
  - name: Fees
    description: >-
      Configure your developer fee — the markup withheld from each conversion
      and credited against your monthly invoice.
  - name: Invitations
    description: Accept a team invitation and activate your account.
paths:
  /v1/api-keys/{id}:
    delete:
      tags:
        - API keys
      summary: Revoke an API key
      description: >-
        Revokes an API key so it can no longer authenticate new requests. Revoke
        a key when an integration is retired, compromised, or replaced.
      operationId: ApiKeyController2_revoke_v1
      parameters:
        - name: id
          required: true
          in: path
          schema:
            type: string
      responses:
        '200':
          description: The revoked key.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    minLength: 1
                  counterpartyId:
                    type: string
                    minLength: 1
                  kind:
                    type: string
                    enum:
                      - secret
                      - publishable
                  name:
                    type: string
                    minLength: 1
                  maskedKey:
                    type: string
                    minLength: 1
                  lastFour:
                    type: string
                  status:
                    type: string
                    enum:
                      - active
                      - revoked
                  createdAt:
                    type: string
                    format: date-time
                  revokedAt:
                    type: string
                    format: date-time
                  rotatedToId:
                    type: string
                    minLength: 1
                  scopes:
                    type: array
                    items:
                      type: string
                      enum:
                        - customers:read
                        - customers:write
                        - routes:read
                        - routes:write
                        - transfers:read
                        - transfers:write
                        - treasury:read
                        - treasury:write
                        - rates:read
                        - webhooks:read
                        - webhooks:write
                        - fees:read
                        - fees:write
                        - keys:read
                        - keys:write
                        - settings:read
                        - settings:write
                        - admin:read
                        - admin:write
                  allowedIps:
                    type: array
                    items:
                      type: string
                      minLength: 1
                      maxLength: 49
                      pattern: ^[0-9a-fA-F:.]+(\/\d{1,3})?$
                required:
                  - id
                  - counterpartyId
                  - kind
                  - name
                  - maskedKey
                  - lastFour
                  - status
                  - createdAt
        '403':
          description: No fresh second factor was presented (`step_up_required`).
        '404':
          description: No such API key for this account.
      security:
        - Bearer: []
        - ApiKey: []
components:
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer
      bearerFormat: Wayex API key
      description: 'Send the same Wayex API key as `Authorization: Bearer <key>`.'
    ApiKey:
      type: apiKey
      in: header
      name: X-Api-Key
      description: A Wayex API key. Use a secret key for write operations.

````