---
title: "Bulk add/remove labels and types, or set the assignee"
method: POST
path: "/modules/{moduleSlug}/records/bulk"
tags: ["Records"]
---

# Bulk add/remove labels and types, or set the assignee

`POST /modules/{moduleSlug}/records/bulk`

## Request

- Base URL: `https://api.getcoherence.io/v1`
- URL: `https://api.getcoherence.io/v1/modules/{moduleSlug}/records/bulk`
- Auth: HTTP bearer

Add or remove labels and types, or set the assignee, across up to 100 records in one call. Each record's assignee is set as a single-record update would set it. Requires the `records:write` scope.

## Request body

- object
  - `recordIds` string[], required
  - `addLabelIds` string[]
  - `removeLabelIds` string[]
  - `addTypeIds` string[]
  - `removeTypeIds` string[]
  - `assigneeUserId` string, uuid, nullable: The records' new assignee (their module's assignee field), an active member of the workspace; null unassigns.

## Response `200`

Updated records

- object
  - `records` Record[]
    - `recordId` string, uuid
    - `moduleId` string, uuid
    - `moduleSlug` string
    - `displayName` string
    - `fields` object
    - `createdDateTime` string, date-time
    - `updatedDateTime` string, date-time

## Other responses

- `400`: The request body failed validation.
- `401`: Authentication failed or missing.

---

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