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

# Revoke a Console agent principal

> Supply the credential in the form body, never a URL. This terminally revokes the principal and any remaining assertion. Unknown or already revoked credentials return 200 without revealing their existence. A fresh key requires the existing authorized human workflow.



## OpenAPI

````yaml /console-openapi.json post /v1/console/agent-auth/revoke
openapi: 3.1.1
info:
  title: Altss Console machine API
  version: '2026-11-11'
  description: >-
    A separate description of the deployed protected Console REST, MCP and
    agent-authorization interfaces. The public website and documentation readers
    remain anonymous and are described separately. company.read is necessary but
    not sufficient: approved channels, verified tenant admission, current terms,
    per-tool eligibility, data rights, spending limits, explicit purchase
    approval and confirmed funding remain enforced. OAuth grant extensions below
    describe implemented protocols; generic OpenAPI tools may ignore extensions
    and cannot infer an authorization-code or device flow.
  x-altss-source-commit: d2432ba2f34a58ed7936598fb5b42dfbf50c6637
servers:
  - url: https://console.altss.com
security: []
tags:
  - name: Console REST
  - name: Console MCP
  - name: Console authorization
externalDocs:
  url: https://console.altss.com/auth.md
  description: Authoritative Console authorization and human-approval guide
paths:
  /v1/console/agent-auth/revoke:
    post:
      tags:
        - Console authorization
      summary: Revoke a Console agent principal
      description: >-
        Supply the credential in the form body, never a URL. This terminally
        revokes the principal and any remaining assertion. Unknown or already
        revoked credentials return 200 without revealing their existence. A
        fresh key requires the existing authorized human workflow.
      operationId: revokeConsoleAgentCredential
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/Revocation'
      responses:
        '200':
          description: Revocation processed, or token unknown/already revoked. Empty body.
        '400':
          description: >-
            Protocol refusal, including invalid_request, invalid_grant,
            invalid_target, authorization_pending, slow_down or expired_token.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
                additionalProperties: false
        '403':
          description: Human or organization authority denied.
        '429':
          description: Rate limit exceeded.
        '503':
          description: >-
            Temporarily unavailable; token issuance cannot be replayed safely
            after an uncertain response.
      security: []
components:
  schemas:
    Revocation:
      type: object
      properties:
        token:
          type: string
          minLength: 1
          maxLength: 4096
        token_type_hint:
          const: access_token
      required:
        - token
      additionalProperties: false

````

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