---
title: "Update Many Users"
method: PUT
path: "/api/v2/users/update_many"
tags: ["Users"]
---

# Update Many Users

`PUT /api/v2/users/update_many`

## Query parameters

- `ids` string
- `external_ids` string

## Request body

- union
  - object
    - `user` union, required
      - object
        - `agent_brand_ids` integer[]
        - `custom_role_id` integer
        - `email` string, required
        - `external_id` string
        - `identities` object[]
          - `type` string, required
          - `value` string, required
        - `name` string, required
        - `organization` object
          - `name` string, required
        - `organization_id` integer
        - `role` string
      - object
        - `email` string
        - `name` string
        - `organization_id` integer
        - `password` string
      - object
        - `id` integer
  - object
    - `users` UserInput[], required
      - union
        - object
          - `agent_brand_ids` integer[]
          - `custom_role_id` integer
          - `email` string, required
          - `external_id` string
          - `identities` object[]
            - `type` string, required
            - `value` string, required
          - `name` string, required
          - `organization` object
            - `name` string, required
          - `organization_id` integer
          - `role` string
        - object
          - `email` string
          - `name` string
          - `organization_id` integer
          - `password` string
        - object
          - `id` integer

## Response `200`

Successful response

- JobStatusResponse
  - `job_status` JobStatusObject
    - `id` string — Automatically assigned when the job is queued
    - `job_type` string — The type of the job
    - `message` string, nullable — Message from the job worker, if any
    - `progress` integer, nullable — Number of tasks that have already been completed
    - `results` union — Result data from processed tasks. See [Results](#results) below
      - JobStatusResultObject[], nullable
        - union
          - object
            - `id` integer, required — the id of the new resource
            - `index` integer, required — the index number of the resul
          - object
            - `action` string, required — the action the job attempted (`"action": "update"`)
            - `id` integer, required — the id of the resource the job attempted to update
            - `status` string, required — the status (`"status": "Updated"`)
            - `success` boolean, required — whether the action was successful or not (`"success": true`)
          - object
            - `action` string, required — The action the job attempted (`"action": "update"`)
            - `details` string, required — The details of the error
            - `error` string, required — The error message
            - `id` integer, required — The id of the resource the job attempted to update
            - `success` boolean, required — Whether the action was successful or not (`"success": true`)
      - object
        - `success` boolean, required — Whether the action was successful or not
    - `status` string — The current status. One of the following: "queued", "working", "failed", "completed"
    - `total` integer, nullable — The total number of tasks this job is batching through
    - `url` string — The URL to poll for status updates

---

[API](https://skmtc.net/botbrains-io/apis/support-api.md) · [All operations](https://skmtc.net/botbrains-io/apis/support-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/botbrains-io/support-api/versions/d53eac07ba68/schema)