> ## 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 Workspace Access Token ID

> Converts a sensitive workspace-level access token into its stable identifier (access_token_id) within the specified workspace. 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/workspaces/{workspace_id}/access-tokens/lookup
openapi: 3.1.0
info:
  title: AskUI Workspaces API
  version: 0.2.15
servers: []
security: []
paths:
  /api/v1/workspaces/{workspace_id}/access-tokens/lookup:
    post:
      tags:
        - access-tokens
      summary: Lookup Workspace Access Token ID
      description: >-
        Converts a sensitive workspace-level access token into its stable
        identifier (access_token_id) within the specified workspace. 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_workspace_access_token_api_v1_workspaces__workspace_id__access_tokens_lookup_post
      parameters:
        - name: workspace_id
          in: path
          required: true
          schema:
            type: string
            format: uuid4
            title: Workspace Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LookupWorkspaceAccessTokenCommand'
      responses:
        '200':
          description: >-
            Access token ID lookup successful. Returns a stable, non-sensitive
            identifier for the provided workspace access token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LookupWorkspaceAccessTokenResponseDto'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StringErrorResponse'
        '403':
          description: Permission denied
          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:
    LookupWorkspaceAccessTokenCommand:
      properties:
        accessToken:
          type: string
          minLength: 1
          title: Accesstoken
      type: object
      required:
        - accessToken
      title: LookupWorkspaceAccessTokenCommand
    LookupWorkspaceAccessTokenResponseDto:
      properties:
        accessTokenId:
          type: string
          format: uuid4
          title: Accesstokenid
      type: object
      required:
        - accessTokenId
      title: LookupWorkspaceAccessTokenResponseDto
    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

````