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

> Revoke an S2 access token by ID.

# Revoke an access token.

<Card title="Access token concepts" icon="key" href="/concepts/access-tokens">
  Review token scopes, permissions, expiry, and revocation behavior.
</Card>

<Warning>
  Revocation can take up to 10 minutes to propagate, due to caching.
</Warning>


## OpenAPI

````yaml delete /access-tokens/{id}
openapi: 3.1.0
info:
  title: S2, the durable streams API
  description: Streams as a cloud storage primitive.
  termsOfService: https://s2.dev/terms
  contact:
    email: support@s2.dev
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://aws.s2.dev/v1
security:
  - access_token: []
tags:
  - name: metrics
    description: Usage metrics and data.
  - name: basins
    description: Manage basins
  - name: access-tokens
    description: Manage access tokens
  - name: locations
    description: Manage locations
  - name: streams
    description: Manage streams
  - name: records
    description: Manage records
paths:
  /access-tokens/{id}:
    delete:
      tags:
        - access-tokens
      summary: Revoke an access token.
      operationId: revoke_access_token
      parameters:
        - name: id
          in: path
          description: Access token ID.
          required: true
          schema:
            $ref: '#/components/schemas/AccessTokenIdStr'
      responses:
        '204':
          description: ''
        '400':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorInfo'
        '403':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorInfo'
        '408':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorInfo'
components:
  schemas:
    AccessTokenIdStr:
      type: string
      maxLength: 96
      minLength: 1
    ErrorInfo:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: string
        message:
          type: string
  securitySchemes:
    access_token:
      type: http
      scheme: bearer
      description: >-
        Bearer authentication header of the form `Bearer <token>`, where
        `<token>` is your access token.

````