Bulk operations

Bulk endpoints allow you to create, update, delete, publish, or unpublish multiple resources in a single request. All bulk operations are executed within a transaction and support up to 100 resources per request.

Response format

All bulk endpoints return a detailed response with per-item results:

{
  "data": {
    "created": [ { "id": "xR4mN2vBwQy7", "index": 0 } ],
    "failed": [ { "index": 2, "errors": { "message": "..." } } ]
  },
  "meta": {
    "total": 3,
    "created": 2,
    "failed": 1
  }
}

If all items succeed, the response status is 201 Created (for bulk create) or 200 OK. If some items fail, the status is 207 Multi-Status.

Bulk create

POST /v2/resources/{blueprint}/bulk

Requires the create ability.

Request body

{
  "resources": [
    {
      "attributes": {
        "title": "Post 1",
        "slug": "post-1"
      }
    },
    {
      "attributes": {
        "title": "Post 2",
        "slug": "post-2"
      }
    }
  ]
}

Bulk update

PATCH /v2/resources/{blueprint}/bulk

Requires the update ability.

Request body

{
  "updates": [
    {
      "id": "gKqv6dx6pBk9",
      "attributes": {
        "title": "Updated title"
      }
    },
    {
      "id": "xR4mN2vBwQy7",
      "attributes": {
        "title": "Another update"
      }
    }
  ]
}

Bulk delete

DELETE /v2/resources/{blueprint}/bulk

Requires the delete ability.

Request body

{
  "ids": ["gKqv6dx6pBk9", "xR4mN2vBwQy7"]
}

Bulk publish

POST /v2/resources/{blueprint}/bulk-publish

Requires the publish ability.

Request body

{
  "ids": ["gKqv6dx6pBk9", "xR4mN2vBwQy7"],
  "published_at": "2026-02-01T12:00:00Z"
}

If published_at is omitted, the current date and time is used.

Bulk unpublish

POST /v2/resources/{blueprint}/bulk-unpublish

Requires the publish ability.

Request body

{
  "ids": ["gKqv6dx6pBk9", "xR4mN2vBwQy7"]
}