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

# Lookup Global Access Token ID

> Converts a sensitive global-level access token into its stable identifier (access_token_id). The access token can be base64 encoded (similar to Authorization header) or passed raw. This enables clients to reference tokens without transmitting sensitive values, e.g., when trying to delete the token or retrieve usage for the token.



## OpenAPI

````yaml post /api/v1/access-tokens/lookup
openapi: 3.1.0
info:
  title: AskUI Workspaces API
  version: 0.2.15
servers: []
security: []
paths:
  /api/v1/access-tokens/lookup:
    post:
      tags:
        - access-tokens
      summary: Lookup Global Access Token ID
      description: >-
        Converts a sensitive global-level access token into its stable
        identifier (access_token_id). The access token can be base64 encoded
        (similar to Authorization header) or passed raw. This enables clients to
        reference tokens without transmitting sensitive values, e.g., when
        trying to delete the token or retrieve usage for the token.
      operationId: lookup_access_token_api_v1_access_tokens_lookup_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LookupAccessTokenCommand'
        required: true
      responses:
        '200':
          description: >-
            Access token ID lookup successful. Returns a stable, non-sensitive
            identifier for the provided access token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LookupAccessTokenResponseDto'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StringErrorResponse'
        '404':
          description: Access token not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StringErrorResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StringErrorResponse'
      security:
        - Bearer: []
        - Basic: []
components:
  schemas:
    LookupAccessTokenCommand:
      properties:
        accessToken:
          type: string
          minLength: 1
          title: Accesstoken
      type: object
      required:
        - accessToken
      title: LookupAccessTokenCommand
    LookupAccessTokenResponseDto:
      properties:
        accessTokenId:
          type: string
          format: uuid4
          title: Accesstokenid
      type: object
      required:
        - accessTokenId
      title: LookupAccessTokenResponseDto
    StringErrorResponse:
      properties:
        detail:
          type: string
          title: Detail
      type: object
      required:
        - detail
      title: StringErrorResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer
    Basic:
      type: apiKey
      in: header
      name: Authorization

````