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

# Revoke an API or TradingView key

> 200 revoked:true confirms revocation.

<Note>Preview contract. Production availability remains subject to activation and release qualification. Examples are synthetic; the documentation cannot submit requests.</Note>

## Authorization

Authenticated Liftx Settings session; available after entitlement expiry.

## Behavior

200 revoked:true confirms revocation. REVOCATION\_UNCERTAIN means an attempted update could not be confirmed; inspect metadata before any explicit retry. New handoffs are blocked once authority is revoked; owned protections and termination are not interrupted.

This is a session-owned application contract, not an ordinary API-key endpoint. Use [Settings → Integrations](https://app.liftx.io/settings/integrations). The public API base URL does not grant session access.

## JSON body example

The following shows the request shape, not live credentials or executable market defaults. Replace timestamps only when creating a new reviewed intent; never mutate them on a command retry.

```json theme={null}
{
  "id": "77777777-7777-4777-8777-777777777777"
}
```

## Response and errors

The generated response schema below is the wire contract. Preserve fixed-point strings, nullable fields and endpoint-specific envelopes. Inspect HTTP status and Content-Type before decoding failures; reused trading routes may return JSON or plain text. Authentication, entitlement and exact link/instrument restrictions apply in addition to endpoint validation. See [errors and recovery](/api/errors-and-limits).

Do not automatically repeat a mutation after transport ambiguity. Trading commands reuse the exact immutable identity; credential issuance and template writes require their documented metadata/read reconciliation.

Read the [related guide](/api/settings-contract) for lifecycle, units and recovery semantics.


## OpenAPI

````yaml api/openapi.json POST /integrations/credentials/revoke
openapi: 3.1.0
info:
  title: Liftx integrations
  version: 1.0.0
  description: >-
    Preview contract for the Liftx API, TradingView webhook and session-owned
    integration settings. Production availability is pending activation and
    release qualification. External access requires Pro or trial entitlement and
    is unmetered within bounded resource limits. Receipt acceptance does not
    confirm execution completion. MCP is not active.
servers:
  - url: https://api.liftx.io
security: []
paths:
  /integrations/credentials/revoke:
    post:
      summary: Revoke credentials
      description: >-
        Session-owned Settings contract. Ordinary API keys and TradingView
        capabilities cannot authenticate this route. Use the Liftx Settings
        application; this is not a third-party bot endpoint. A confirmed result
        is 200 with revoked:true. A database update with an unreadable outcome
        returns 503 REVOCATION_UNCERTAIN: inspect credential metadata before an
        explicit retry. The requesting user's matching streams are closed and
        authority reconciliation is signaled even for this uncertain outcome. No
        automatic mutation retry.
      operationId: post_integrations_credentials_revoke
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                id:
                  type: string
                  format: uuid
              required:
                - id
              additionalProperties: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  revoked:
                    const: true
                required:
                  - revoked
                additionalProperties: false
              examples:
                synthetic:
                  summary: Confirmed revocation response shape
                  description: >-
                    Synthetic documentation data, not an account snapshot,
                    executable market configuration or production-availability
                    assertion. IDs, quantities, prices, times and values are
                    illustrative.
                  value:
                    revoked: true
        default:
          description: >-
            Integration errors use Error; existing trading handlers retain their
            own JSON or text/plain error codec. Inspect status and content type.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
            text/plain:
              schema:
                type: string
      security:
        - SessionBearer: []
components:
  schemas:
    Error:
      type: object
      properties:
        success:
          const: false
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
          required:
            - code
            - message
          additionalProperties: false
      required:
        - success
        - error
      additionalProperties: false
  securitySchemes:
    SessionBearer:
      type: http
      scheme: bearer
      bearerFormat: existing authenticated Liftx session

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.