# 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-09-18
Security: ZephrHmacHttp

## Security:

  - `ZephrHmacHttp` (unknown)
    http ZEPHR-HMAC-*

## 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:

  - `202` (unknown)
    OK

## Response 202 fields (application/json):

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

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

## Response 400:

  - `400` (unknown)
    The request is invalid. A required attribute is missing or an attribute did not meet the expected criteria.

## Response 400 fields (application/json):

  - `error` (string)

## Response 401:

  - `401` (unknown)
    Authentication credentials were not provided or are invalid.

## Response 401 fields (application/json):

  - `error` (string)

## Response 400 examples:

  - `missingName` (unknown)

  - `invalidType` (unknown)

## Response 401 examples:

  - `missingCredentials` (unknown)