---
title: "Bulk update"
method: PATCH
path: "/people/bulk"
tags: ["People"]
---

# Bulk update

`PATCH /people/bulk`

## Request

- Base URL: `https://api.modem.dev/v1`
- URL: `https://api.modem.dev/v1/people/bulk`
- Auth: HTTP bearer

Batch endpoint: update fields on one or more people (displayName, avatarUrl, description, isVip, primaryEmail, connections). Supports partial success - each person is updated independently. Use the single-resource PATCH /people/{personId} for one person.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `people` object[], required
    - `avatarUrl` string, uri, nullable
    - `connections` object
      - `github` string, nullable
      - `linkedin` string, nullable
      - `phone` string, nullable
      - `title` string, nullable
      - `twitter` string, nullable
      - `website` string, nullable
    - `description` string, nullable
    - `displayName` string
    - `isVip` boolean
    - `personId` string, required
    - `primaryEmail` string, email, nullable

## Response `200`

OK

- object
  - `results` object[], required
    - `data` object
      - `avatarUrl` string, uri, nullable, required: Avatar image URL for the person.
      - `connections` object, required
        - `github` string, nullable, required
        - `linkedin` string, nullable, required
        - `phone` string, nullable, required
        - `title` string, nullable, required
        - `twitter` string, nullable, required
        - `website` string, nullable, required
      - `description` string, nullable, required
      - `displayName` string, required: Display name for the person.
      - `id` string, required
      - `isVip` boolean, required
      - `primaryEmail` string, email, nullable, required
    - `error` string
    - `personId` string, required
    - `success` boolean, required

## Other responses

- `400`: Invalid request (validation failed).
- `401`: Missing or invalid API key.
- `403`: The API key does not have access to this resource.
- `404`: The requested resource was not found.
- `409`: The request conflicts with an existing resource or idempotency operation.
- `429`: Rate limit exceeded.
- `500`: Internal server error.

---

[API](https://skmtc.dev/modem/apis/modem-api.md) · [All operations](https://skmtc.dev/modem/apis/modem-api/llms.txt) · [OpenAPI document](https://skmtc.dev/modem/apis/modem-api/revisions/f889038a1048?raw)