To help partners quickly diagnose and resolve issues, all APIs return a structured error response. This model is consistent across endpoints and includes enough context for debugging, without exposing internal details. Every error response follows the same basic format: 
{
  "code": "<error_code>",
  "title": "<error_title>",
  "message": "<error_message>"
}

​
Field definitions

  • code: A unique, stable identifier for the error.
  • title: A brief summary of what went wrong.
  • message: A human-readable message explaining how to fix it.
Always use the code field to programmatically identify errors. Titles and messages may evolve to improve clarity.

​
Field-level validation errors

When an issue is related to specific fields in the request payload, the response includes a fields object with more granular information.

​
Examples

{
  "code": "IDE-0009",
  "title": "Missing Fields in Request",
  "message": "Your request is missing one or more required fields. Please refer to the documentation to ensure all necessary fields are included in your request.",
  "fields": {
    "document": "document is a required field"
  }
}