Skip to main content

Error Codes

API error responses and troubleshooting

HTTP status codes

StatusMeaningAction
200Success—
400Bad requestCheck parameters
401Auth failureCheck API Key
403Permission denied or service not activatedVerify that Memory is activated for the API Key's workspace and that the account has permission to call it
404Not foundVerify ID
429Rate limitedBackoff and retry
500Server errorRetry, contact support if persistent

Error response

{
  "code": "InvalidParameter",
  "message": "user_id is required",
  "request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Retry strategy

Error typeRetry?Interval
4xx (except 429)No—
429 rate limitedYes1s/2s/4s exponential backoff
5xxYes1s/2s/4s, max 3 retries

Troubleshooting

Every response includes request_id. Provide this ID when contacting support for faster resolution.
See Rate limits for throttling details.
Managed Agent API
Flow Agent API
Sandbox API
RAG API
Long-term Memory
ParseX API
Security API
Framework Integration