Errors

Every error response has the same shape:


{
  "error": {
    "code": "invalid_request",
    "message": "title is required"
  }
}

Error codes

Code	Status	Meaning
`unauthorized`	401	Missing, malformed, revoked, or unknown API key.
`forbidden`	403	Valid key, but the plan doesn’t allow this action (writes require a paid plan).
`invalid_request`	400	Validation failed — bad JSON, missing field, or invalid query parameter.
`not_found`	404	Unknown route or no resource with that id in your project.
`limit_reached`	429	Monthly submission quota exhausted.
`rate_limited`	429	Too many requests in the current window — back off and retry.
`internal_error`	500	Something failed on our side. Safe to retry.

This list is exhaustive — the API returns no other codes.