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

# Delete a Processor Key

> Revoke a key and remove it from your account

# Delete a Processor Key

Revoke the stored key and remove it. The response is `204` with no body. An `id` that is not yours, or that no longer exists, returns `404`.

## Deleting a default key

Deleting a default key is always allowed. A payment type it covered falls back to a default `both` key if you have one. Only the types no other default covers are affected: until you [add](/api-reference/payments/create-payment-connection) or [promote](/api-reference/payments/update-payment-connection#make-a-key-the-default) another default for them, borrowers enrolled without a `merchant_ref` are skipped on those types. `GET /v1/payment_connections` lists them in `missing_default_rails`.

<Tip>
  To swap credentials on a key that is in use, [replace the key](/api-reference/payments/update-payment-connection#replace-a-key) instead of deleting and re-adding it. The tag and default status carry over, and there is no moment with no key.
</Tip>

Payment results already read through this key are kept.


## OpenAPI

````yaml DELETE /v1/payment_connections/{id}
openapi: 3.1.0
info:
  title: Rightfoot API
  description: >-
    Submit a batch of authorizers for balance checks, retrieve processed
    balances, and check the status of a batch.
  version: 0.3.0-alpha
servers:
  - url: https://api.rightfoot.com
security:
  - BearerAuth: []
tags:
  - name: General Availability
    description: |
      **General Availability** indicates that the endpoint is production-ready.
  - name: Early Access
    description: >
      **Early Access** indicates that the endpoint is available for early access
      customers and is being actively refined.
  - name: In Development
    description: >
      **In Development** indicates that the endpoint is currently being built
      and will be available in an upcoming release.
paths:
  /v1/payment_connections/{id}:
    delete:
      tags:
        - In Development
      summary: Delete a processor key
      description: |
        Revoke the stored key and remove it. Responds `204` with no body.

        Deleting a default key is always allowed. Until you add or promote
        another default for the payment types it covered, borrowers enrolled
        without a `merchant_ref` are skipped on those types —
        `GET /v1/payment_connections` lists them in `missing_default_rails`.

        Payment results already read through this key are kept.
      operationId: delete_payment_connection
      parameters:
        - in: path
          name: id
          required: true
          schema:
            type: string
            format: uuid
          description: The key's `id`, as returned when it was added or listed.
      responses:
        '204':
          description: The key was revoked and removed.
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          description: No key with this id for your account.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiErrorResponse'
              example:
                status: error
                status_code: 404
                error:
                  code: NOT_FOUND
                  message: No payment connection with that id for this requester
                  timestamp: '2026-08-28T15:06:02Z'
                  suggestion: ''
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  responses:
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiErrorResponse'
          example:
            status: error
            status_code: 401
            error:
              code: UNAUTHORIZED
              message: Invalid API key provided.
              timestamp: '2024-09-16T12:01:00Z'
              suggestion: Please check your API key.
            documentation_url: https://api.rightfoot.com/docs
    InternalServerError:
      description: Internal Server Error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiErrorResponse'
          example:
            status: error
            status_code: 500
            error:
              code: INTERNAL_SERVER_ERROR
              message: An unexpected error occurred while retrieving the balances.
              timestamp: '2024-09-16T12:11:00Z'
              suggestion: >-
                Please try again later. If the problem persists, contact our
                support team.
            documentation_url: https://api.rightfoot.com/docs
  schemas:
    ApiErrorResponse:
      type: object
      properties:
        status:
          type: string
          description: Status of the error, either "error" or "success"
        status_code:
          type: integer
          description: HTTP status code of the error
        error:
          type: object
          properties:
            code:
              type: string
              description: Error code (e.g., "RESOURCE_NOT_FOUND")
            message:
              type: string
              description: Detailed error message.
            details:
              type: string
              description: Additional details about the error
            timestamp:
              type: string
              format: date-time
              description: Time the error occurred
            suggestion:
              type: string
              description: Suggested action to resolve the error
        documentation_url:
          type: string
          format: uri
          description: URL to the documentation for the error
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >
        Authentication to the API is performed via Bearer Token Authentication.
        Provide your API key as the bearer token in the Authorization header.


        All API requests must be made over HTTPS. Calls made over plain HTTP
        will fail. API requests without authentication will also fail.

````