> ## Documentation Index
> Fetch the complete documentation index at: https://actianvectorai-ml-crtx-1153-academy-tutorial-rewrites.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete access token

> Deletes an access token by its ID. The token is immediately invalidated and can no longer be used for authentication.

Requires `auth_enabled=true` and an admin access token or admin JWT.




## OpenAPI

````yaml delete /auth/access_token/{token_id}
openapi: 3.0.3
info:
  title: Actian VectorAI DB - Authentication API
  description: Access token and admin user management for VectorAI DB.
  version: 1.0.0
  contact:
    name: Actian Corporation
    url: https://www.actian.com
servers:
  - url: http://localhost:6573
    description: Local development server (REST API)
  - url: https://api.vectorai.actian.com
    description: Production server
security:
  - bearerAuth: []
tags:
  - name: Access Tokens
    description: Create, list, rotate, and delete access tokens.
  - name: Admin User
    description: Create and manage the admin user, login, and authentication settings.
paths:
  /auth/access_token/{token_id}:
    delete:
      tags:
        - Access Tokens
      summary: Delete access token
      description: >
        Deletes an access token by its ID. The token is immediately invalidated
        and can no longer be used for authentication.


        Requires `auth_enabled=true` and an admin access token or admin JWT.
      operationId: delete_access_token
      parameters:
        - name: token_id
          in: path
          required: true
          schema:
            type: integer
          description: The unique identifier of the access token to delete.
        - name: Authorization
          in: header
          required: true
          schema:
            type: string
          description: >-
            Admin JWT or admin access token. Format `Bearer
            <admin-jwt-or-access-token>`.
      responses:
        '200':
          description: Token deleted successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StatusResponse'
              examples:
                success:
                  value:
                    status: success
                    message: Access token deleted successfully
        '401':
          description: Missing or invalid authorization credentials.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                unauthorized:
                  value:
                    status: error
                    message: Invalid or missing authorization token
        '403':
          description: Authentication is not enabled on the server.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                auth_disabled:
                  value:
                    status: error
                    message: Access token API requires auth_enabled=true
        '404':
          description: Token not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                not_found:
                  value:
                    status: error
                    message: Access token not found
      x-codeSamples:
        - lang: cURL
          label: Delete access token
          source: |
            curl -X DELETE http://localhost:6575/auth/access_token/12 \
              -H "Accept: application/json" \
              -H 'Authorization: Bearer <admin-jwt-or-access-token>'
components:
  schemas:
    StatusResponse:
      type: object
      properties:
        status:
          type: string
          description: Operation result status.
        message:
          type: string
          description: Human-readable status message.
    ErrorResponse:
      type: object
      properties:
        status:
          type: string
          description: Error status indicator.
        message:
          type: string
          description: Human-readable error description.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Admin JWT obtained from the login endpoint.

````