API keys

API keys let other systems query the Tire Library REST API using a single static token, without a logged-in user session.

API keys require the API Monthly subscription ($250/month). You need Can manage billing permission to create or revoke keys.

Create a key

  1. Sign in.
  2. Go to ApiKeys.
  3. Click Create API key.
  4. Enter a name (e.g. "POS integration") so you can identify the key later.
  5. Click Create.

The full key is displayed once, immediately after creation. Copy it now — the system doesn't store the unencrypted value and you can't retrieve it later.

The key prefix (e.g. tl_live_a3kQ) is shown in the list so you can identify which key is which without exposing the secret.

Use a key

Include the header on every request:

GET https://app.tireweblibrary.com/api/v1/tires/catalog
x-api-key: tl_live_a3kQZ...
Accept: application/json

API-key-authenticated requests are rate-limited under the API tier policy. Default is 200 requests per minute per key.

Revoke a key

  1. Go to ApiKeys.
  2. Find the key in the list.
  3. Click Revoke.
  4. Confirm.

The key stops working immediately. Any system still using it will start getting 401 or 403 responses.

Rate limits

  • Default: 200 requests / 60s per key
  • Sliding window
  • Over the limit: HTTP 429 with a "Too many requests" message

For high-volume use cases, contact support to negotiate a higher limit.

Troubleshooting

"API keys cannot be created during a trial."

Trial-mode companies cannot create keys. Upgrade to a paid API plan.

"API access is not enabled."

Your subscription doesn't include API access. Upgrade to API Monthly.

Newly-created key doesn't work

  • Make sure you copied the full key including the tl_live_ prefix.
  • Confirm the header name is exactly x-api-key.
  • Confirm HTTPS — keys are only accepted over TLS.

See also