Skip to main content

Errors

The API uses conventional HTTP status codes. Errors come in two shapes.

Single-message errors

Most failures return an object with one error string:

Validation errors

When a request body fails validation the API returns 422 with a list of field errors:
field is the field’s internal name, not the JSON key. From refers to the from property, MediaURL to mediaUrl, and so on. Fix every entry and resend. Validation stops the request before anything happens, so a 422 never has side effects.
An empty or unreadable JSON body returns 422 with a single object instead: