Authentication

The Ticket0 REST API uses bearer tokens for authentication. All API requests must be made over HTTPS.

Base URL: https://app.ticket0.ai/api/v1

Generating an API key

1. Go to Settings → API keys
2. Click New key
3. Give the key a descriptive name, pick the scopes it needs, and optionally set an expiry date
4. Click Create key
5. Copy the key from the confirmation dialog — this is the only time the full key is shown. If you lose it, revoke and create a new one

API keys start with t0_. Only workspace Owners and Admins can create or revoke keys.

Making authenticated requests

Include your key in the Authorization header:

curl https://app.ticket0.ai/api/v1/tickets \
  -H "Authorization: Bearer t0_your_api_key"

Scopes

Each API key is issued with one or more scopes. Request only the scopes your integration needs.

Errors

All errors return a consistent JSON body:

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Valid API key required"
  }
}

Error code values are uppercase, underscore-separated constants — parse them as exact strings (e.g. "UNAUTHORIZED", not "unauthorized"). Common error codes:

Quick start

# List your 10 most recent open tickets
curl "https://app.ticket0.ai/api/v1/tickets?status=open&limit=10" \
  -H "Authorization: Bearer t0_your_api_key"