Queues multiple blocks for asynchronous creation and connects them to one or more channels. Returns immediately with a batch_id that can be used to poll for status via GET /v3/blocks/batch/{batch_id}.

Designed for import use cases such as migrating from other services or re-importing Are.na exports.

Each block in the blocks array follows the same format as single block creation. Blocks are processed sequentially in the background and partial success is supported — if some blocks fail, the successful ones are still created.

Limits:

• Maximum 50 blocks per request
• Maximum 20 channels per request
• All channels must be private

Batch results are available for 24 hours after submission.

⚠️ Premium Only: This endpoint requires a Premium subscription.