# Update users in bulk

Updates user's attributfoes or delete users on a bulk basis.

When setting attributes, any of the user's existing attributes not specified in the payload will be left in-place.

Endpoint: POST /v4/user-updates
Version: 2026-01-08
Security: ZephrHmacHttp

## Request fields (application/json):

  - `updates` (array)
    Array of combination of identifier and actions.

  - `updates.identifier` (object)
    Identifier of the user. User either the User ID or Foreign Key.

  - `updates.identifier.user_id` (string)
    Unique Id of the user.

  - `updates.identifier.foreign_key` (object)
    Foreign key object.

  - `updates.identifier.foreign_key.foreign-system` (string)
    The foreign key of the user.

  - `updates.actions` (array)
    The actions to be taken for the user. Available actions are attribute update and user deletion.

  - `updates.actions.type` (string)
    The user update action to be taken.
    Enum: "delete-user", "set-attribute"

  - `updates.actions.attribute` (object)
    Details of the attribute update.

  - `updates.actions.attribute.field` (string, required)
    The slug of the attribute.

  - `updates.actions.attribute.value` (string, required)
    The updated value of the attribute.

## Response 202 fields (application/json):

  - `message` (string)
    Returned message indicating the status of the operation.

  - `job_id` (string)
    Id of the job.

## Response 400 fields (application/json):

  - `error` (string)

## Response 401 fields (application/json):

  - `error` (string)