Changelog

Validation errors from the v2 API now return details in a single, predictable shape. Previously this field could appear as an index-keyed object, a list of error objects, a bare string, or null, which made it hard to parse reliably.

For validation errors, details is now always a list of error objects (each with parameter, location, and message), or null when there is no field-level detail:

1
{
2
  "errors": [
3
    {
4
      "type": "validation_error",
5
      "message": "invalid articles data",
6
      "details": [
7
        {
8
          "parameter": "$[0].knowledge_source_id",
9
          "location": "body",
10
          "message": "Knowledge source with id 'bogus_id' does not exist."
11
        }
12
      ]
13
    }
14
  ]
15
}

If your integration parses details, update it to expect this list-of-error-objects shape.