Çağla Cabaoğlu Gallery

Developer Portal

Çağla Cabaoğlu Gallery API Error Codes

Every error returned by the Çağla Cabaoğlu Gallery REST API and MCP server is an RFC 9457 Problem Details document. The `type` member links to the matching anchor on this page, so an agent can follow it and correct the request.

Error response shape

{ "type": "https://caglacabaoglu.com/docs/errors#QUERY_TOO_LONG", "title": "Query too long", "status": 400, "detail": "Query exceeds maximum length of 64 characters.", "code": "QUERY_TOO_LONG", "hint": "Please provide a query between 2 and 64 characters." }

Served as `application/problem+json`. Rate-limited responses additionally carry `RateLimit-*` and `Retry-After` headers.

Error codes

CodeHTTPMeaningWhat to do
NOT_FOUND404The requested endpoint or record does not existCheck /openapi.json for the endpoint list, or call /api/v1 for the endpoint index.
VALIDATION_FAILED400One or more request fields failed validationRead `detail` for the offending field and resend with a corrected payload.
MISSING_REQUIRED_FIELDS400A required field was absent from the request bodyCompare the payload with the request schema in /openapi.json.
INVALID_JSON400The request body is not valid JSONSend `Content-Type: application/json` with a well-formed JSON body.
QUERY_TOO_LONG400The search query exceeds the maximum lengthUse a query between 2 and 64 characters.
SEARCH_FAILED500The search index could not answer the queryRetry once after a short delay; if it persists, fall back to /api/v1/artists or /api/v1/exhibitions.
RATE_LIMITED429Too many requests for the free public tierHonour `Retry-After` and `RateLimit-Reset` (seconds). The free tier allows 120 requests/minute.
RATE_LIMIT_CONFIG_MISSING503Rate limiting is temporarily unavailableA server-side configuration issue. Retry later; do not treat it as a client error.
REGISTRATION_FAILED400Agent registration could not be completedVerify the registration payload documented at /openapi.json under registerAgentV1.
SUBMISSION_FAILED500The contact submission could not be deliveredRetry once, then email contactgallery@caglacabaoglu.com directly.
EMAIL_SERVICE_CONFIG_MISSING503The transactional email service is unavailableServer-side configuration issue. Retry later.
INTERNAL_ERROR500Unexpected server errorRetry with exponential backoff. Report persistent failures to contactgallery@caglacabaoglu.com.