The table below lists errors that can be returned when working with the Agent Platform APIs.
Status codeError typeTriggerResponse
400Bad RequestRequest body or parameters are malformed (e.g., invalid JSON, missing required field).{ "detail": "Invalid request payload" }
401UnauthorizedMissing or invalid Bearer token.{ "detail": "Not authenticated" }
403ForbiddenUser request rejected due to missing/invalid auth.{ "detail": "Not authenticated" }
404Not FoundRequested resource doesn’t exist (e.g., /api/v1/trajectories/{id} with unknown id).{ "detail": "Resource not found" }
409ConflictResource already exists, or invalid state transition.{ "detail": "Conflict: agent already exists" }
422Unprocessable EntityValidation errors (schema validation fails).{ "detail": [ { "loc": ["body","field"], "msg": "field required", "type": "value_error.missing" } ] }
429Too Many RequestsRate limiting / quota exceeded.{ "detail": "Rate limit exceeded, try again later" }
500Internal Server ErrorUnexpected server-side failure.{ "detail": "Internal server error" }
503Service UnavailableAPI temporarily unavailable (e.g., during deployment or outage).{ "detail": "Service unavailable, please try again later" }
202AcceptedRequest accepted but processing is asynchronous (e.g., updating status, user interactions).{} (empty body or task acknowledgment)
204No ContentRequest succeeded but no data to return (e.g., no trajectory changes since last index).(empty response body)