v50

latestOpenAPI 3.1.0Proprietaryraw.githubusercontent.com2026-07-112650216.3 KB

Accounts

Create API key

Creates an API key for apps, scripts, agents, and backend jobs. The full token is returned once. Plan apiTokens limits apply to active keys; revoked keys do not count.

post/v1/account/api-keys

Request body

namestring required

Example request

{
  "name": "Production scraper"
}

Response

API key created.

tokenstring required

nextActionsstring[] required

Example response

{
  "apiKey": {
    "id": "api_key_a1b2c3d4e5f6",
    "name": "Production scraper",
    "tokenPrefix": "tovuk_key_8Qm2",
    "createdAt": "2026-06-23T12:00:00Z",
    "lastUsedAt": null,
    "revokedAt": null,
    "currentDayRequestCount": 42,
    "currentMonthRequestCount": 5160
  },
  "token": "tovuk_key_example_token_shown_once",
  "nextActions": [
    "Save this key now. Tovuk will not show it again."
  ]
}