Skip to main content
GET
Get action batch

Authorizations

Authorization
string
header
required

Workspace key with read-actions for reads or propose-actions for writes. Optional positive account ID. A bound key may name only its own account; a different ID returns 422. An unbound key requires exactly one active available advertising account with an active connection; omission uses that account and a supplied ID must match it. Multiple active accounts return 422 even when account_id is supplied.

Path Parameters

workspace
integer
required

The workspace ID

actionBatch
string
required

Query Parameters

account_id
integer

Optional positive account ID. A bound key may name only its own account; a different ID returns 422. An unbound key requires exactly one active available advertising account with an active connection; omission uses that account and a supplied ID must match it. Multiple active accounts return 422 even when account_id is supplied.

Required range: x >= 1
cursor
integer

Continue using next_cursor with the same filters; rule lists use an immutable rule ID, other lists an offset or object ID.

Required range: x >= 0
limit
integer
default:25

Maximum complete rows; the byte budget may return fewer. Defaults to 25.

Required range: 1 <= x <= 100

Response

Authorized Actions resource. Result projections share the 80,000-byte MCP JSON budget; defaults are bounded, next_cursor continues complete rows, and oversized single rows are explicitly refused. Plan creative continuation uses the read endpoint; proposal continuation uses the batch read endpoint.

data
object
required

Complete projection rows are paged within 80,000 JSON bytes, accounting for both MCP representations. Defaults are bounded. Follow next_cursor with the same scope and filters. One oversized row is explicitly refused; fields are never silently clipped.