list_tokens #
On this page
Generated automatically from the published contract sources.
A script calls this action over HTTPS at POST https://turnzero.ai/api/v1/list_tokens, with a bearer credential and the action's payload as the JSON body. It also accepts GET. An MCP connection lists this action as the tool list_tokens.
OAuth access tokens and minted tokens, including the turnzero command's computer token, are bearer credentials. The action determines which kinds, scopes and grants it accepts (Sign-in, sessions, and tokens).
Build metadata: Registered in this build. Registration describes the default dispatcher in this build. It does not guarantee that a caller has the required credential or grant, that a tool is listed for that connection, or that the required service is configured.
Contract description #
List your account's API tokens and, where your credential permits, its sign-in connections. Tokens include their id, scope, grants, label, creation, expiry, revocation and last-use times, never their values. authorized_computer: true marks a token the turnzero command keeps on a computer it authorized. Its label defaults to that computer's host name. Connections include their id, client, address, sign-in time, last renewal, and expiry, never a token. A token limited by a narrow grant gets its tokens alone. To end a token or connection, use revoke_token with id or connection respectively.
More about this action #
List your account's connections: each connection's id, client, address, sign-in time, last renewal, and expiry, never a token.
Access and action metadata #
{
"name": "list_tokens",
"resource": "token",
"tier": "observe",
"surface": "account",
"addresses": [
"tzcloud"
],
"clients": [
"bearer",
"browser_session"
],
"admits": [
"synthetic_estate",
"issues",
"tzmesh",
"tztrack"
],
"summary": "The account's minted tokens: identities, scopes, grants, labels, stamps, and a space grant's space and level, and `authorized_computer`, true on an authorized computer's token, never values. If no narrow grant bounds the credential, it also returns the account's live connections. Each row gives the tool's refresh family, client, sign-in, last renewal and expiry, never a token.",
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"openWorldHint": false,
"idempotentHint": true
}
}
MCP catalog entry #
{
"name": "list_tokens",
"title": "List access tokens",
"tier": "observe",
"summary": "List your account's API tokens and, where your credential permits, its sign-in connections. Tokens include their id, scope, grants, label, creation, expiry, revocation and last-use times, never their values. `authorized_computer: true` marks a token the turnzero command keeps on a computer it authorized. Its label defaults to that computer's host name. Connections include their id, client, address, sign-in time, last renewal, and expiry, never a token. A token limited by a narrow grant gets its tokens alone. To end a token or connection, use `revoke_token` with `id` or `connection` respectively.",
"owners": [
"API-L0-05",
"MAPI-14",
"API-L0-21",
"ACS-L0-11",
"MCP-10"
],
"scenario": "API-L0-05"
}
request #
| JSON pointer | Description and constraints |
|---|---|
| "" (root) | Type: object |
response #
| JSON pointer | Description and constraints |
|---|---|
| "" (root) | Type: object Required fields: ["contract_version","tokens"] Additional properties: false |
| / |
Required value: 1 |
| / |
Type: array |
| / |
Type: object Required fields: ["id","scope_kind","application","grants","label","created_at","expires_at","revoked_at","last_used_at"] Additional properties: false |
| / |
Type: string |
| / |
Allowed values: ["account","application"] |
| / |
Type: ["string","null"] |
| / |
Type: array |
| / |
Allowed values: ["destructive","super_admin","synthetic_seed_purge","synthetic_estate","publication","feedback_queue","issues","tzmesh","tztrack","test_end_users","support_read"] |
| / |
Type: ["string","null"] |
| / |
Whether the token is an authorized computer's: true on a token the turnzero command keeps on a computer it authorized, false on every other. Type: boolean |
| / |
The space the issues grant applies to; you get it only on a token that holds the grant. Type: string Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ |
| / |
The level the issues grant reaches its space at, report, contribute, or owner, or a tzmesh or tztrack token's level, read, chat, or admin, a mark that bounds no call of its product. You get it only on a token that holds one of the three grants.Allowed values: ["report","contribute","owner","read","chat","admin"] |
| / |
Type: string |
| / |
Type: ["string","null"] |
| / |
Type: ["string","null"] |
| / |
Type: ["string","null"] |
| / |
On a product token alone, one holding the tzmesh or tztrack grant: a sentence saying the last-use time counts only requests made to this platform. The product's own service checks the token without asking this platform, so its uses there are not recorded and a null time does not mean the token is unused.Type: string |
| / |
Your account's connections, each its id, client, address, sign-in time, last renewal, and expiry, never a token. Absent under a token a narrow grant bounds. Type: array |
| / |
Type: object Required fields: ["id","client_id","client_name","client_host","signed_in_at","renewed_at","expires_at","address"] Additional properties: false |
| / |
The connection's identity: its refresh family, which you pass to revoke_token with connection.Type: string |
| / |
The registered client the connection was issued to. Type: string |
| / |
The name the client's tool registered, or null where it registered none. Type: ["string","null"] |
| / |
The host of the address the client's tool registered, or null where it registered none. Type: ["string","null"] |
| / |
The instant of the sign-in that opened the connection. Type: string |
| / |
The instant of the last renewal, or null where none was made. Type: ["string","null"] |
| / |
When the connection's newest refresh credential expires. Type: string |
| / |
The address the connection was made at: turnzero for turnzero.ai/mcp, tzcloud, or tztools. tzop is the address Turn Zero's own operators use; no customer account shows it.Type: string Allowed values: ["turnzero","tzcloud","tztools","tzop"] |
Complete payload contract #
{
"request": {
"type": "object",
"properties": {}
},
"response": {
"type": "object",
"required": [
"contract_version",
"tokens"
],
"properties": {
"contract_version": {
"const": 1
},
"tokens": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"scope_kind",
"application",
"grants",
"label",
"created_at",
"expires_at",
"revoked_at",
"last_used_at"
],
"properties": {
"id": {
"type": "string"
},
"scope_kind": {
"enum": [
"account",
"application"
]
},
"application": {
"type": [
"string",
"null"
]
},
"grants": {
"type": "array",
"items": {
"enum": [
"destructive",
"super_admin",
"synthetic_seed_purge",
"synthetic_estate",
"publication",
"feedback_queue",
"issues",
"tzmesh",
"tztrack",
"test_end_users",
"support_read"
]
}
},
"label": {
"type": [
"string",
"null"
]
},
"authorized_computer": {
"type": "boolean",
"description": "Whether the token is an authorized computer's: true on a token the turnzero command keeps on a computer it authorized, false on every other."
},
"space": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
"description": "The space the issues grant applies to; you get it only on a token that holds the grant."
},
"level": {
"enum": [
"report",
"contribute",
"owner",
"read",
"chat",
"admin"
],
"description": "The level the issues grant reaches its space at, report, contribute, or owner, or a `tzmesh` or `tztrack` token's level, read, chat, or admin, a mark that bounds no call of its product. You get it only on a token that holds one of the three grants."
},
"created_at": {
"type": "string"
},
"expires_at": {
"type": [
"string",
"null"
]
},
"revoked_at": {
"type": [
"string",
"null"
]
},
"last_used_at": {
"type": [
"string",
"null"
]
},
"last_used_note": {
"type": "string",
"description": "On a product token alone, one holding the `tzmesh` or `tztrack` grant: a sentence saying the last-use time counts only requests made to this platform. The product's own service checks the token without asking this platform, so its uses there are not recorded and a null time does not mean the token is unused."
}
},
"additionalProperties": false
}
},
"connections": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"client_id",
"client_name",
"client_host",
"signed_in_at",
"renewed_at",
"expires_at",
"address"
],
"properties": {
"id": {
"type": "string",
"description": "The connection's identity: its refresh family, which you pass to `revoke_token` with `connection`."
},
"client_id": {
"type": "string",
"description": "The registered client the connection was issued to."
},
"client_name": {
"type": [
"string",
"null"
],
"description": "The name the client's tool registered, or null where it registered none."
},
"client_host": {
"type": [
"string",
"null"
],
"description": "The host of the address the client's tool registered, or null where it registered none."
},
"signed_in_at": {
"type": "string",
"description": "The instant of the sign-in that opened the connection."
},
"renewed_at": {
"type": [
"string",
"null"
],
"description": "The instant of the last renewal, or null where none was made."
},
"expires_at": {
"type": "string",
"description": "When the connection's newest refresh credential expires."
},
"address": {
"type": "string",
"enum": [
"turnzero",
"tzcloud",
"tztools",
"tzop"
],
"description": "The address the connection was made at: `turnzero` for turnzero.ai/mcp, `tzcloud`, or `tztools`. `tzop` is the address Turn Zero's own operators use; no customer account shows it."
}
},
"additionalProperties": false
},
"description": "Your account's connections, each its id, client, address, sign-in time, last renewal, and expiry, never a token. Absent under a token a narrow grant bounds."
}
},
"additionalProperties": false
}
}
Shared contracts #
- Refusals: every refusal, by surface, with its cause and its remedy
- schemas/wire_error.schema.json
- schemas/wire_errors.json
- schemas/action_payloads.json (includes shared shapes)
- management_api_contract.md