AskUI Access Tokens API
The access-tokens API from AskUI — 6 operation(s) for access-tokens.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/askui:askui-access-tokens-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: AskUI Workspaces Access Tokens API
version: 0.2.15
tags:
- name: Access Tokens
paths:
/api/v1/access-tokens:
post:
tags:
- Access Tokens
summary: Create Access Token
operationId: create_access_token_api_v1_access_tokens_post
security:
- Bearer: []
- Basic: []
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CreateSubjectAccessTokenCommand'
responses:
'201':
description: Access token created successfully
content:
application/json:
schema:
$ref: '#/components/schemas/CreateSubjectAccessTokenResponseDto'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/StringErrorResponse'
'403':
description: Permission denied
content:
application/json:
schema:
$ref: '#/components/schemas/StringErrorResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/StringErrorResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
get:
tags:
- Access Tokens
summary: List Access Tokens
operationId: list_access_tokens_api_v1_access_tokens_get
security:
- Bearer: []
- Basic: []
parameters:
- name: subject_id
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Subject Id
- name: skip
in: query
required: false
schema:
type: integer
minimum: 0
default: 0
title: Skip
- name: limit
in: query
required: false
schema:
type: integer
maximum: 100
minimum: 1
default: 100
title: Limit
responses:
'200':
description: Access tokens fetched successfully
content:
application/json:
schema:
$ref: '#/components/schemas/ListSubjectAccessTokensResponseDto'
'401':
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/StringErrorResponse'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/StringErrorResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/access-tokens/{token_id}:
delete:
tags:
- Access Tokens
summary: Delete Access Token
operationId: delete_access_token_api_v1_access_tokens__token_id__delete
security:
- Bearer: []
- Basic: []
parameters:
- name: token_id
in: path
required: true
schema:
type: string
format: uuid4
title: Token Id
responses:
'204':
description: Access token deleted successfully
'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'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/StringErrorResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/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'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/StringErrorResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- Bearer: []
- Basic: []
/api/v1/workspaces/{workspace_id}/access-tokens:
post:
tags:
- Access Tokens
summary: Create Access Token
operationId: create_access_token_api_v1_workspaces__workspace_id__access_tokens_post
security:
- Bearer: []
- Basic: []
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/CreateWorkspaceAccessTokenRequestDto'
responses:
'201':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/CreateWorkspaceAccessTokenResponseDto'
'404':
description: Workspace membership not found
content:
application/json:
example:
detail:
- msg: Workspace membership not found
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
get:
tags:
- Access Tokens
summary: List Access Tokens
operationId: list_access_tokens_api_v1_workspaces__workspace_id__access_tokens_get
security:
- Bearer: []
- Basic: []
parameters:
- name: workspace_id
in: path
required: true
schema:
type: string
format: uuid4
title: Workspace Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/ListAccessTokenResponseDto'
title: Response List Access Tokens Api V1 Workspaces Workspace Id Access Tokens Get
'404':
description: Workspace membership not found
content:
application/json:
example:
detail:
- msg: Workspace membership not found
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/workspaces/{workspace_id}/access-tokens/{token_id}:
delete:
tags:
- Access Tokens
summary: Delete Access Token
operationId: delete_access_token_api_v1_workspaces__workspace_id__access_tokens__token_id__delete
security:
- Bearer: []
- Basic: []
parameters:
- name: workspace_id
in: path
required: true
schema:
type: string
format: uuid4
title: Workspace Id
- name: token_id
in: path
required: true
schema:
type: string
format: uuid4
title: Token Id
responses:
'204':
description: Successful Response
'404':
description: Workspace membership not found
content:
application/json:
example:
detail:
- msg: Workspace membership not found
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/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
security:
- Bearer: []
- Basic: []
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'
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/StringErrorResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
StringErrorResponse:
properties:
detail:
type: string
title: Detail
type: object
required:
- detail
title: StringErrorResponse
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
LookupWorkspaceAccessTokenCommand:
properties:
accessToken:
type: string
minLength: 1
title: Accesstoken
type: object
required:
- accessToken
title: LookupWorkspaceAccessTokenCommand
CreateSubjectAccessTokenCommand:
properties:
name:
type: string
maxLength: 128
minLength: 1
title: Name
expiresAt:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Expiresat
type: object
required:
- name
title: CreateSubjectAccessTokenCommand
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
SubjectAccessTokenResponseDto:
properties:
id:
type: string
format: uuid4
title: Id
createdAt:
type: string
format: date-time
title: Createdat
name:
type: string
title: Name
expiresAt:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Expiresat
creatorId:
type: string
title: Creatorid
type: object
required:
- name
- expiresAt
- creatorId
title: SubjectAccessTokenResponseDto
CreateWorkspaceAccessTokenResponseDto:
properties:
privateToken:
$ref: '#/components/schemas/AccessTokenResponseDto'
tokenString:
type: string
title: Tokenstring
type: object
required:
- privateToken
- tokenString
title: CreateWorkspaceAccessTokenResponseDto
ListAccessTokenResponseDto:
properties:
id:
type: string
format: uuid4
title: Id
name:
type: string
title: Name
createdAt:
type: string
format: date-time
title: Createdat
expiresAt:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Expiresat
type: object
required:
- id
- name
- createdAt
title: ListAccessTokenResponseDto
ListSubjectAccessTokensResponseDto:
properties:
data:
items:
$ref: '#/components/schemas/SubjectAccessTokenResponseDto'
type: array
title: Data
type: object
required:
- data
title: ListSubjectAccessTokensResponseDto
CreateWorkspaceAccessTokenRequestDto:
properties:
name:
type: string
maxLength: 128
minLength: 1
title: Name
expiresAt:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Expiresat
type: object
required:
- name
title: CreateWorkspaceAccessTokenRequestDto
LookupAccessTokenCommand:
properties:
accessToken:
type: string
minLength: 1
title: Accesstoken
type: object
required:
- accessToken
title: LookupAccessTokenCommand
CreateSubjectAccessTokenResponseDto:
properties:
token:
$ref: '#/components/schemas/SubjectAccessTokenResponseDto'
tokenString:
type: string
title: Tokenstring
type: object
required:
- token
- tokenString
title: CreateSubjectAccessTokenResponseDto
LookupAccessTokenResponseDto:
properties:
accessTokenId:
type: string
format: uuid4
title: Accesstokenid
type: object
required:
- accessTokenId
title: LookupAccessTokenResponseDto
AccessTokenResponseDto:
properties:
createdAt:
type: string
format: date-time
title: Createdat
id:
type: string
format: uuid4
title: Id
name:
type: string
title: Name
expiresAt:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Expiresat
type: object
required:
- id
- name
title: AccessTokenResponseDto
LookupWorkspaceAccessTokenResponseDto:
properties:
accessTokenId:
type: string
format: uuid4
title: Accesstokenid
type: object
required:
- accessTokenId
title: LookupWorkspaceAccessTokenResponseDto
securitySchemes:
Bearer:
type: http
scheme: bearer
Basic:
type: apiKey
in: header
name: Authorization
x-provenance:
method: harvested
publisher: AskUI
source: https://workspaces.askui.com/openapi.json
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)