---
title: "Lookup Global Access Token ID"
method: POST
path: "/api/v1/access-tokens/lookup"
tags: ["access-tokens"]
---

# Lookup Global Access Token ID

`POST /api/v1/access-tokens/lookup`

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.

## Request body

- LookupAccessTokenCommand
  - `accessToken` string, required

## Response `200`

Access token ID lookup successful. Returns a stable, non-sensitive identifier for the provided access token.

- LookupAccessTokenResponseDto
  - `accessTokenId` string, uuid4, required

## Other responses

- `401` — Unauthorized
- `404` — Access token not found
- `422` — Validation Error
- `500` — Internal server error

---

[API](https://skmtc.dev/askui/apis/askui-workspaces-api.md) · [All operations](https://skmtc.dev/askui/apis/askui-workspaces-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/askui/askui-workspaces-api/revisions/b796c74292ac/schema)