API Keys / Tokens
GET
/v1/orgs/{org_id}/tokensList Tokens
List tokens for an organization, optionally filtered by project/type.
Admin tokenscope: org:adminoperation_id: tokens.list
Authentication
Create via POST /v1/orgs/{org_id}/tokens/admin. Org-wide scope — keep tightly held.
SDK install
pip install znyx-sdknpm install @znyx/sdkPath parameters
| Name | Type | Required | Description |
|---|---|---|---|
| org_id#path | string | required | — |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
| project_id#query | string | null | optional | — |
| key_type#query | string | null | optional | — |
Header parameters
| Name | Type | Required | Description |
|---|---|---|---|
| X-API-Key#header | string | null | optional | — |
| authorization#header | string | null | optional | — |
Responses
| Status | Description |
|---|---|
| 200 | Successful Response |
| 422 | Validation Error |
Response schema
idrequiredinteger
key_prefixrequiredstring
key_typerequiredstring
org_idstring | null
project_idstring | null
environment_idstring | null
scopesstring[]
is_activerequiredboolean
expires_atstring | null
created_atrequiredstring
Errors & what triggers them
| Code | Trigger | Fix |
|---|---|---|
| 401 | Missing or expired Authorization header. | — |
| 403 | Token does not have org access (wrong org_id, or insufficient role). | — |
| 404 | Resource does not exist in this org. | — |
Request
curl -X GET 'https://api.znyx.ai/v1/orgs/00000000-0000-0000-0000-000000000000/tokens' \ -H 'Authorization: Bearer $ZNYX_TOKEN'
Response
application/json
Successful Response
[
{
"id": 0,
"key_prefix": "string",
"key_type": "string",
"org_id": null,
"project_id": null,
"environment_id": null,
"scopes": [
"string"
],
"is_active": false,
"expires_at": null,
"created_at": "string"
}
]Schema: TokenResponse[]