{
  "topic": "errors.UNSUPPORTED_MEDIA_TYPE",
  "path": [
    "errors",
    "UNSUPPORTED_MEDIA_TYPE"
  ],
  "title": "UNSUPPORTED_MEDIA_TYPE — PATCH format or Content-Type not supported",
  "synopsis": "Returned by PATCH in two situations:",
  "body": "# errors.UNSUPPORTED_MEDIA_TYPE\n\n## NAME\n\nUNSUPPORTED_MEDIA_TYPE — the PATCH request used a format or `Content-Type` that is not supported.\n\n## SYNOPSIS\n\nHTTP: `415` `Unsupported Media Type`. Retryable: `no`.\n\n## DESCRIPTION\n\nReturned by PATCH in two situations:\n\n- The `{format}` path segment is not `JSON`. Merge patch is JSON-only; other format values (e.g. `CSV`) are not accepted for PATCH requests.\n- The `Content-Type` header names a patch dialect that is not recognised. Only `application/merge-patch+json` (RFC 7386) is implemented.\n\nNote that `application/json-patch+json` (RFC 6902, JSON Patch) is a recognised dialect but is not implemented; requests using that content type receive `501 NOT_IMPLEMENTED`, not `415`.\n\nNot retryable as-is — the same request produces the same error until the format or content type is corrected.\n\n## RECOVERY\n\nUse `JSON` as the `{format}` path segment and set `Content-Type: application/merge-patch+json` in the request. Merge patch (RFC 7386) describes the delta as a JSON object whose keys are merged into the stored entity; keys present in the patch overwrite stored values, and keys explicitly set to `null` remove the field.\n\n## SEE ALSO\n\n- errors\n- errors.NOT_IMPLEMENTED\n- errors.BAD_REQUEST\n",
  "sections": [
    {
      "name": "NAME",
      "body": "UNSUPPORTED_MEDIA_TYPE — the PATCH request used a format or `Content-Type` that is not supported."
    },
    {
      "name": "SYNOPSIS",
      "body": "HTTP: `415` `Unsupported Media Type`. Retryable: `no`."
    },
    {
      "name": "DESCRIPTION",
      "body": "Returned by PATCH in two situations:\n\n- The `{format}` path segment is not `JSON`. Merge patch is JSON-only; other format values (e.g. `CSV`) are not accepted for PATCH requests.\n- The `Content-Type` header names a patch dialect that is not recognised. Only `application/merge-patch+json` (RFC 7386) is implemented.\n\nNote that `application/json-patch+json` (RFC 6902, JSON Patch) is a recognised dialect but is not implemented; requests using that content type receive `501 NOT_IMPLEMENTED`, not `415`.\n\nNot retryable as-is — the same request produces the same error until the format or content type is corrected."
    },
    {
      "name": "RECOVERY",
      "body": "Use `JSON` as the `{format}` path segment and set `Content-Type: application/merge-patch+json` in the request. Merge patch (RFC 7386) describes the delta as a JSON object whose keys are merged into the stored entity; keys present in the patch overwrite stored values, and keys explicitly set to `null` remove the field."
    },
    {
      "name": "SEE ALSO",
      "body": "- errors\n- errors.NOT_IMPLEMENTED\n- errors.BAD_REQUEST"
    }
  ],
  "see_also": [
    "errors",
    "errors.NOT_IMPLEMENTED",
    "errors.BAD_REQUEST"
  ],
  "stability": "stable",
  "actions": []
}
