Skip to contentSkip to navigationSkip to topbar
Page toolsOn this page
Looking for more inspiration?Visit the

25015: The SCIM PATCH request is invalid


ERROR: 25015

error-25015 page anchor
ERROR

You receive this error when your request to PATCH /scim/v2/Users/{id} does not use the SCIM PATCH structure required by the SCIM API. Your request body must include the urn:ietf:params:scim:api:messages:2.0:PatchOp schema and an Operations array.

Possible causes

possible-causes page anchor
  • The JSON body does not follow the documented SCIM PATCH format for PATCH /scim/v2/Users/{id}.
  • The schemas array is missing urn:ietf:params:scim:api:messages:2.0:PatchOp.
  • The Operations array is missing, empty, or incorrectly structured.
  • The request attempts to patch attributes outside the supported set of fields for this endpoint, or uses unsupported field paths for the operation payload. PATCH support for active, name.givenName, name.familyName, displayName, timezone, locale, emails, and userName.
  • Send the request to PATCH /scim/v2/Users/{id} with a SCIM PATCH body that includes schemas with urn:ietf:params:scim:api:messages:2.0:PatchOp and an Operations array containing each change.
  • Compare your request body against the documented PATCH example and keep the JSON property names and nesting for each operation consistent with that format.
  • Patch only supported fields for this endpoint: active, name.givenName, name.familyName, displayName, timezone, locale, emails, and userName.
  • If you update emails and userName in the same request, make sure the primary email value matches the username.

Additional resources

additional-resources page anchor