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

# Revoke an OAuth authorization

> Revokes the authenticated caller's authorization for a third-party OAuth app,
identified by client_id in the path. This removes the consent and immediately
revokes all of that app's live access and refresh tokens for this user, so the app's
next API call fails and it must request authorization again. Returns a revoked flag
and tokens_revoked count, or 404 if the caller has no authorization for that
client_id. Scoped strictly to the caller's own grant; it never affects other users
or apps.



## OpenAPI

````yaml DELETE /v1/api/oauth/authorizations/{client_id}
openapi: 3.1.0
info:
  title: HQ API
  description: >-
    Public HTTP API for HQ. Authenticate with a Personal Access Token
    (`Authorization: Bearer hq_pat_...`) for server-side integrations, or an
    OAuth 2.1 authorization-code + PKCE flow for browser apps acting on a user's
    behalf. Both grant from the same resource:action scope vocabulary; an
    endpoint's required scope is listed under its `security`.
  license:
    name: Apache-2.0
    identifier: Apache-2.0
  version: 1.0.0
servers:
  - url: https://api.hq.zone
    description: HQ API (production)
security: []
tags:
  - name: me
    description: The signed-in user's own account
  - name: conversations
    description: Conversations and their messages
  - name: documents
    description: The content-addressed documents library
  - name: schedules
    description: Scheduled prompts and recurring tasks
  - name: agents
    description: Agents, their skills and integrations
  - name: memory
    description: What the assistant remembers (L5 governance)
  - name: tokens
    description: Personal Access Token management
  - name: billing
    description: Usage and billing
  - name: notifications
    description: In-app notification center
  - name: admin
    description: Workspace administration
  - name: integrations
    description: Workspace integrations (Slack, MCP, skills)
  - name: onboarding
    description: New-workspace onboarding wizard
  - name: auth
    description: Sign-in, sessions, and OAuth
paths:
  /v1/api/oauth/authorizations/{client_id}:
    delete:
      tags:
        - tokens
      summary: Revoke an OAuth authorization
      description: >-
        Revokes the authenticated caller's authorization for a third-party OAuth
        app,

        identified by client_id in the path. This removes the consent and
        immediately

        revokes all of that app's live access and refresh tokens for this user,
        so the app's

        next API call fails and it must request authorization again. Returns a
        revoked flag

        and tokens_revoked count, or 404 if the caller has no authorization for
        that

        client_id. Scoped strictly to the caller's own grant; it never affects
        other users

        or apps.
      operationId: revoke_authorization
      parameters:
        - name: client_id
          in: path
          description: OAuth client id to revoke access for
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Access revoked
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RevokedResp'
        '404':
          description: No such authorization for the caller
      security:
        - bearer_pat: []
        - oauth2: []
components:
  schemas:
    RevokedResp:
      type: object
      required:
        - revoked
        - tokens_revoked
      properties:
        revoked:
          type: boolean
        tokens_revoked:
          type: integer
          format: int64
          description: How many live tokens issued by this app to the caller were revoked.
          minimum: 0
  securitySchemes:
    bearer_pat:
      type: http
      scheme: bearer
      bearerFormat: hq_pat
      description: 'Personal Access Token. Send as `Authorization: Bearer hq_pat_...`.'
    oauth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://app.hq.zone/v1/oauth/authorize
          tokenUrl: https://api.hq.zone/v1/oauth/token
          refreshUrl: https://api.hq.zone/v1/oauth/token
          scopes:
            admin: Administer the workspace (users, settings, integrations)
            agents:read: View the agents in your workspace
            agents:write: Create and configure agents
            billing:read: View usage and billing information
            conversations:read: Read your conversations and their messages
            conversations:write: Start conversations and send messages on your behalf
            documents:read: Read your documents library
            documents:write: Upload and manage documents in your library
            memory:read: Read what the assistant remembers about you
            memory:write: Correct or delete what the assistant remembers
            schedules:read: View your scheduled tasks
            schedules:write: Create and manage scheduled tasks
            tables:read: Read your tables and their rows
            tables:write: Create tables and add, edit, or delete rows

````