← Back to Teeline

Get an API key

The Teeline REST API requires a personal API key for every endpoint except /api/v1/health. Getting one takes about a minute — no separate Teeline account or password to create, and no request to us.

1. Sign in

Go to accounts.tspsolver.com/sign-in and continue with GitHub, GitLab, Google, or an email address — whichever's easiest. There's nothing to install and no separate signup form.

2. Create a key

Signing in takes you straight to the API keys page. From there:

1. Click Add new key.
2. Give it a name you'll recognize later — e.g. my-laptop or ci-pipeline. An expiration date is optional; leave it blank for a key that never expires.
3. Click Create key.

3. Save it now — it's shown once

Your new key (it looks like ak_…) is revealed exactly once, immediately after you create it. Clerk (the identity provider we use) cannot show it to you again.

Copy it straight into a password manager (1Password, Bitwarden, or similar) before you navigate away. If you lose it, there's no way to recover it — you'll need to revoke it from the same page and create a new one.

4. Use it

Send it as a bearer token on every request:

curl -H "Authorization: Bearer ak_your_key_here" \
  https://api.tspsolver.com/api/v1/solvers

An X-Api-Key header works the same way, if that fits your tooling better:

curl -H "X-Api-Key: ak_your_key_here" \
  https://api.tspsolver.com/api/v1/solvers

Managing or revoking a key

Sign back in at the same sign-in link any time — you'll land on the API keys page, where you can add more keys or revoke ones you no longer use.

For the full list of endpoints, request/response shapes, and to try requests directly in the browser, see the API reference (Scalar docs).