Troubleshooting

Note

Partly written. This page is organised by the symptom a customer sees, not by the subsystem at fault — they don’t know which subsystem it is. The sections marked TODO below are the parts still to come.

401 Unauthorized on every request

Check that the header is Authorization: Bearer <key>, that the key hasn’t been revoked, and that you’re not sending a key from a different environment. See Authentication.

Requests suddenly return 429

You’ve hit a rate limit. See Rate limits & quotas.

A job never leaves its initial state

Intermittent 5xx

Retry with backoff. If it persists, check Status & incidents before opening a ticket.