error object. Branch on code, which stays
stable. message is written for people and can change.
{
"error": {
"type": "invalid_request",
"code": "parameter_missing",
"message": "Missing required parameter: repository.",
"param": "repository",
"doc_url": "https://gecko.security/docs/api-reference/errors#parameter_missing",
"request_id": "…"
}
}
| Field | Meaning |
|---|---|
type | The error family. Each type maps to one HTTP status. |
code | The specific failure, listed on this page. |
message | A readable explanation. |
param | The offending parameter, when there is one. |
doc_url | A link to this page, at the entry for code. |
request_id | The ID to include when you contact support. It matches the X-Request-Id response header. |
Authentication errors
Typeauthentication_error, status 401.
Authorization errors
Typeauthorization_error, status 403.
Invalid requests
Typeinvalid_request, status 400.
Not found
Typenot_found, status 404.
Conflicts
Typeconflict, status 409.
Rate limits
Typerate_limit_error, status 429.
| Code | Meaning | What to do |
|---|---|---|
rate_limit_exceeded | The key reached its hourly limit. | Wait for the number of seconds in the Retry-After header. |
limit_exceeded | The request hit a usage limit. The message says which. | Reduce usage, or upgrade the plan. |
Server errors
Typeapi_error, status 500.
MCP endpoint
The MCP server can also reject a request before it reaches a tool. These errors have typeinvalid_request and no doc_url.