tokens
Open an operation to see its authentication, its parameters and the fields of its request and response.
3 operations
GET/v1/tokens
Tokens, masked: owners and admins see all, other members their own MCP tokens.
/v1/tokensAuthentication: Dashboard session
Parameters
| Name | Type | Description |
|---|---|---|
workspace_idquery | string | |
kindquery | enum | Values runner | mcp |
include_revokedquery | boolean | enum | Values 0 | 1 | true | false |
Response 200
| Name | Type | Description |
|---|---|---|
itemsrequired | array of object | |
items[].idrequired | string | |
items[].org_idrequired | string | |
items[].workspace_idrequired | string | |
items[].user_idrequired | string | |
items[].kindrequired | enum | Values runner | mcp |
items[].namerequired | string | |
items[].last4required | string | |
items[].expires_atrequired | string (date-time) | |
items[].last_used_atrequired | string (date-time) | |
items[].revoked_atrequired | string (date-time) | |
items[].created_by_user_idrequired | string | |
items[].created_atrequired | string (date-time) |
POST/v1/tokens
Creates a runner token (owner, admin) or a personal MCP token for one workspace.
/v1/tokensAuthentication: Dashboard session
Request body
| Name | Type | Description |
|---|---|---|
kindrequired | enum | Values runner | mcp |
namerequired | string | |
workspace_idrequired | string | |
expires_in_days | integer |
Response 201
| Name | Type | Description |
|---|---|---|
tokenrequired | object | |
token.idrequired | string | |
token.org_idrequired | string | |
token.workspace_idrequired | string | |
token.user_idrequired | string | |
token.kindrequired | enum | Values runner | mcp |
token.namerequired | string | |
token.last4required | string | |
token.expires_atrequired | string (date-time) | |
token.last_used_atrequired | string (date-time) | |
token.revoked_atrequired | string (date-time) | |
token.created_by_user_idrequired | string | |
token.created_atrequired | string (date-time) | |
secretrequired | string |
DELETE/v1/tokens/{id}
Revokes a token at once.
/v1/tokens/{id}Authentication: Dashboard session
Parameters
| Name | Type | Description |
|---|---|---|
idpathrequired | string |
Response 200
| Name | Type | Description |
|---|---|---|
idrequired | string | |
org_idrequired | string | |
workspace_idrequired | string | |
user_idrequired | string | |
kindrequired | enum | Values runner | mcp |
namerequired | string | |
last4required | string | |
expires_atrequired | string (date-time) | |
last_used_atrequired | string (date-time) | |
revoked_atrequired | string (date-time) | |
created_by_user_idrequired | string | |
created_atrequired | string (date-time) |