API Authentication

How to authenticate to the Torii API

The Torii API uses Bearer token authentication. Every request must include your API key in the Authorization header:

Where to get your API key

Generate an API key in Torii under Settings → API Access (https://app.toriihq.com/team/settings/apiAccess). You'll need admin permissions to create one. Copy the key when it's shown — it can't be viewed again later.

Get started

Verify your key works by fetching your organization profile with GET /orgs/my:

curl https://api.toriihq.com/v1.0/orgs/my -H "Authorization: Bearer YOUR_API_KEY"

A successful response returns your organization:

{
  "org": {
    "id": 123,
    "companyName": "Acme Inc."
  }
}