Duplicate many records in one call.

Duplicate many records in one call.

Copies each selected record the way POST /object/data/{objectSlug}/{recordSlug}/duplicate does. The report lists the new records' slugs in created_slugs, in selection order.

Choose the records in one of two ways:

• record_slugs — the slugs of the records, one by one.
• select_all: true — every record the credential can see that matches scope, the same filters a record list takes (search, filters or filter_tree, admin_slugs, unassigned). Omit scope to select every record the credential can see.

excluded_record_slugs removes records from either form. Sending both record_slugs and select_all answers 400 (code: BULK_SELECTION_AMBIGUOUS).

Up to 100 selected records run during the request: the response is 200 with data.mode sync and the finished report. A larger selection is queued: the response is 202 with data.mode async and a job_id; poll GET /object/data/{objectSlug}/bulk-actions/{jobId} for the report. Each record is checked and written on its own, so one failure does not stop the rest; failed records are listed in report.failed with a reason. Nothing is rolled back.

Send an Idempotency-Key header (up to 200 characters) to make retries safe: for 24 hours, a request with the same key returns the first request's job instead of copying again.

Available only when GET /object/features reports record_duplicate: true; otherwise 404.

Scope: create.<object slug>, for example create.contacts.

Errors:

• 400 — the selection is empty (code: BULK_EMPTY_SELECTION) or ambiguous (code: BULK_SELECTION_AMBIGUOUS), or the Idempotency-Key is longer than 200 characters (code: BULK_IDEMPOTENCY_KEY_TOO_LONG).
• 422 — the body is invalid, for example record_slugs is empty.

Request:

{
  "select_all": true,
  "scope": { "search": "acme" },
  "excluded_record_slugs": ["7b0d3e9c4a18"]
}

Response 200:

{
  "status": 200,
  "message": "Bulk action completed",
  "data": {
    "mode": "sync",
    "report": {
      "job_id": "e52a8c1d9f37",
      "status": "completed",
      "kind": "duplicate",
      "object_slug": "contacts",
      "total": 2,
      "succeeded": 2,
      "failed": [],
      "created_slugs": ["1a7e4c9b0d52", "8f3b6d2a5e19"],
      "chunks_done": 1,
      "chunks_total": 1,
      "started_by": 17,
      "started_at": "2026-09-14T10:00:00.000Z",
      "finished_at": "2026-09-14T10:00:02.000Z"
    }
  }
}