---
title: "Bulk update"
method: PATCH
path: "/companies/bulk"
tags: ["Companies"]
---

# Bulk update

`PATCH /companies/bulk`

## Request

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

Batch endpoint: update fields on one or more companies (name, logoUrl, isVip, primaryDomain, connections). Supports partial success - each company is updated independently. Use the single-resource PATCH /companies/{companyId} for one company.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `companies` object[], required
    - `companyId` string, required
    - `connections` object
      - `email` string, nullable
      - `github` string, nullable
      - `linkedin` string, nullable
      - `phone` string, nullable
      - `twitter` string, nullable
    - `isVip` boolean
    - `logoUrl` string, uri, nullable
    - `name` string
    - `primaryDomain` string, nullable

## Response `200`

OK

- object
  - `results` object[], required
    - `companyId` union, required
      - string
      - string
    - `data` object
      - `connections` object, required
        - `email` string, nullable, required
        - `github` string, nullable, required
        - `linkedin` string, nullable, required
        - `phone` string, nullable, required
        - `twitter` string, nullable, required
      - `id` string, required
      - `isVip` boolean, required
      - `logoUrl` string, uri, nullable, required: Company logo image URL.
      - `name` string, required: Company name.
      - `primaryDomain` string, nullable, required
    - `error` string
    - `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)