Platform API Errors

Find the stable ProblemDetail.code returned by the Platform API, then open its reference page for likely causes, remediation, retry guidance, and an example response.

Find an error

Enter a code such as invalid_cursor, an HTTP status such as 429, or a keyword such as permissions.

23 documented errors

Error code	HTTP status	What it means
`invalid_request`	`400`	The request could not be processed because the payload, parameters, or request structure is invalid.
`missing_required_field`	`400`	The request is missing a field that the endpoint requires.
`invalid_parameter`	`400`	A request parameter or field is present but has an invalid value.
`invalid_cursor`	`400`	The pagination cursor cannot be used for this request.
`expired_cursor`	`400`	The pagination cursor was valid previously but is no longer usable.
`invalid_filter`	`400`	A filter in the request is not valid for the endpoint or datasource scope.
`invalid_datasource`	`400`	The requested datasource scope is unknown, inaccessible, or not valid for the operation.
`authentication_required`	`401`	The API request did not include valid authentication credentials.
`token_expired`	`401`	The authentication token was valid but has expired.
`insufficient_permissions`	`403`	The caller is authenticated but is not allowed to perform the requested operation.
`spend_limit_exceeded`	`403`	The request was rejected because a configured spend limit for the deployment has been reached.
`resource_not_found`	`404`	The requested resource or endpoint could not be found or is not visible to the caller.
`method_not_allowed`	`405`	The endpoint exists but does not support the HTTP method used by the request.
`request_timeout`	`408`	The server timed out while processing the request.
`request_too_large`	`413`	The request body is larger than the API accepts.
`token_limit_exceeded`	`413`	The request exceeded the model's token limit, which caps how much content the model can process in one operation.
`conflict`	`409`	The request conflicts with the current state of the resource.
`gone`	`410`	The resource or operation is no longer available.
`unprocessable_query`	`422`	The API understood the request shape but could not process the query semantics.
`tools_unauthorized`	`422`	The request targets an agent that uses tools the end user has not authorized, so the run cannot start.
`rate_limit_exceeded`	`429`	The caller has sent too many requests in a time window.
`internal_error`	`500`	The API encountered an unexpected error while processing the request.
`service_unavailable`	`503`	The API is temporarily unable to serve the request.