Skip to main content
POST
TypeScript SDK
Each operation is authorized and applied independently. Poll the returned status_url to retrieve the completed batch result.

Completed batch result

When the task succeeds, result is an agent_batch_result with a results array. Each entry includes index, action, agent_id, and outcome; use index to match it to the request because an agent can appear more than once.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Notion-Version
enum<string>
required

The API version to use for this request. The latest version is 2026-03-11.

Available options:
2026-03-11

Body

application/json
operations
object[]
required

The operations to apply, at least one and at most 100. Operations are applied in the order given, and the batch is not atomic: each operation succeeds or fails on its own, and per-operation outcomes are reported in the async task's result.

Required array length: 1 - 100 elements

One action to apply to one agent. Each operation is authorized and applied on its own.

Response

object
string
required
Allowed value: "async_task"
id
string
required
Minimum string length: 1
status_url
string
required
Minimum string length: 1
created_time
string<date-time>
required
operation
object
required
status
enum<string>
required
Available options:
queued,
running,
retrying
poll_after_seconds
integer
required
Required range: x >= 0