207

A Multi-Status response conveys information about multiple resources in situations where multiple status codes might be appropriate.

This should not be used unless in exceptional circumstances

Example response

@TODO: Define this format

{
  "multistatus": {
    "200": [{"example":"value"}],
    "400": [
      {
        "payload": {"example":"value"},
        "error": {
          "type": "https://example.net/validation-error",
          "title": "Your request parameters didn't validate.",
          "instance": "<trace_id>",
          "invalid_parameters": [
            {
              "name": "age",
              "reason": "must be a positive integer"
            },
            {
              "name": "color",
              "reason": "must be 'green', 'red' or 'blue'"
            }
          ]
        }
      }
    ]
  }
}