Reference
Errors
Errors return a JSON body with a stable code you can branch on and a message written for a human reading a log.
Shape
{
"code": "match_in_progress",
"message": "Match g-88213 is STARTED; it cannot be changed"
}Codes
| Status | Code | Meaning |
|---|---|---|
| 401 | missing_api_key | No X-Api-Key header. |
| 401 | invalid_api_key | Key is unknown or has been revoked. |
| 403 | sport_not_licensed | Unrecognised sport, or one your account is not licensed for. |
| 404 | unknown_match | No fixture with that externalId on your account, or no source attached to it. |
| 409 | match_in_progress | The fixture is STARTING, STARTED or ENDED and is locked. |
| 409 | ingest_already_attached | A different source is already attached. Stop it before attaching another. |
| 422 | validation_failed | Well-formed but invalid: a passphrase, a push protocol, a malformed SRT url, over 200 matches, an unknown player ID, or no channel configuration for that sport on your account. The message names the offending field. |
| 500 | internal_error | Our fault. Safe to retry, because every write is idempotent. |