Account

Create an API key

Mints a new scoped key for the caller's own customer. The raw key value is returned ONCE and is never retrievable again — store it immediately. Requires the write scope.

post/v1/account/keys

Request

  • Base URL: https://api.talonic.com
  • URL: https://api.talonic.com/v1/account/keys
  • Auth: HTTP bearer

Request body

namestring required
scopesstring[]

Subset of: extract, read, write, operations, billing, delivery, usage, records_write. Defaults to the calling key's own scopes. Every requested scope must already be held by the calling key; requesting one it lacks is rejected with 403 (scope_not_grantable) — a key can only ever narrow its own privilege on a newly minted key, never widen it. usage, records_write and billing are granted de novo only through owner+ key management, never through self-serve key creation.

Example request

{
  "name": "ci-pipeline"
}

Response

Newly created key. The key field is shown only here.

idstring uuid
namestring
keystring

The raw secret. Shown once. Never returned again.

masked_prefixstring
scopesstring[]
created_atstring date-time
warningstring

Example response

{
  "key": "tlnc_0123456789abcdef0123456789abcdef"
}

Changes

No recorded changes to this operation across all 1 revision of this API.