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

# Disconnect an app

> Disconnect an app you authorized: its access ends at once on every Pomerado MCP it reaches, and the jobs it started stop. The app can connect again only when you authorize it again. An API key may disconnect only an app whose used permissions it holds itself.

**Authentication:** `Authorization: Bearer <token>` with Dashboard session, Pomerado MCP OAuth token, API key.

**Permission:** any signed-in member, on their own records; an API key also needs `api_keys:manage`.

**Effect:** Destructive: replaces or removes something, and cannot be undone.

**Errors:** [`invalid_request`](/errors#invalid_request) (400), [`unauthorized`](/errors#unauthorized) (401), [`reauthentication_required`](/errors#reauthentication_required) (401), [`permission_not_held`](/errors#permission_not_held) (403), [`forbidden`](/errors#forbidden) (403), [`not_found`](/errors#not_found) (404), [`internal_error`](/errors#internal_error) (500), [`temporarily_unavailable`](/errors#temporarily_unavailable) (503). Every error has the same [envelope](/errors).


## OpenAPI

````yaml /api-reference/openapi.json delete /v1/connected-apps/{id}
openapi: 3.1.0
info:
  title: Pomerado API
  version: '1'
  description: >-
    Run and build website tools, follow their jobs, and manage logins, API keys
    and webhooks. Authenticate with a Pomerado API key (pom_…), an MCP OAuth
    token or a Dashboard session as a Bearer token.
servers:
  - url: https://api.pomerado.ai
security: []
tags:
  - name: account
    x-group: Account
  - name: api_keys
    x-group: API keys
  - name: connected_apps
    x-group: Connected apps
  - name: usage
    x-group: Usage
  - name: quota
    x-group: Quota
  - name: billing
    x-group: Billing
  - name: integrations
    x-group: Integrations
  - name: connect
    x-group: Connect
  - name: logins
    x-group: Logins
  - name: tools
    x-group: Tools
  - name: webhooks
    x-group: Webhooks
  - name: runs
    x-group: Runs
  - name: builds
    x-group: Builds
  - name: jobs
    x-group: Jobs
  - name: support
    x-group: Support
paths:
  /v1/connected-apps/{id}:
    delete:
      tags:
        - connected_apps
      summary: Disconnect an app
      description: >-
        Disconnect an app you authorized: its access ends at once on every
        Pomerado MCP it reaches, and the jobs it started stop. The app can
        connect again only when you authorize it again. An API key may
        disconnect only an app whose used permissions it holds itself.
      operationId: connected_apps.revoke
      parameters:
        - name: id
          in: path
          required: true
          description: 'a connected app ID: app_ and 32 lowercase hex digits'
          schema:
            type: string
            examples:
              - app_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190
      responses:
        '204':
          description: Disconnected
        '400':
          description: invalid_request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: unauthorized, reauthentication_required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: permission_not_held, forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: not_found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: internal_error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: temporarily_unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - bearer: []
components:
  schemas:
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
            - retryable
            - docs_url
          properties:
            code:
              type: string
            message:
              type: string
            retryable:
              type: boolean
            docs_url:
              type: string
            details:
              type: object
              required: []
              properties: {}
              additionalProperties:
                $id: /schemas/unknown
          additionalProperties: false
      additionalProperties: false
  securitySchemes:
    bearer:
      type: http
      scheme: bearer

````

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