Authentication

The API accepts an organization-scoped API key as a bearer token:

Authorization: Bearer tk_live_...

Create keys in Settings → API keys. The secret is shown once, at creation: Taktoria stores only a SHA-256 hash of it, so a lost key must be rotated rather than recovered.

Scopes

A key carries a list of scopes. * grants everything; launches:* grants every launches action.

ScopeGrants
launches:read / launches:writeLaunches, including the launch button
steps:read / steps:writeLaunch steps, decisions, nudges, review queues
artifacts:read / artifacts:writePress releases, dashboards, learnings
insights:read / insights:writePost-launch learnings
teams:read / teams:writeFunctional and organizational teams
templates:read / templates:writeThe launch step template
members:readOrganization members
seats:read / seats:writePer-app seat assignment
apps:readApps and subscription state

Subscriptions

App endpoints also require the organization to hold an active subscription for that app. Without one you get 402 subscription_required.