ActionReadApi

Get action batch

Changed on

Read persisted Actions data for the authorized account. Unbound keys require exactly one active account; account_id cannot select among multiple accounts.

get/agent/workspaces/{workspace}/action-batches/{actionBatch}

Request

  • Base URL: https://plainrouter.com/api/v1
  • URL: https://plainrouter.com/api/v1/agent/workspaces/{workspace}/action-batches/{actionBatch}
  • Auth: HTTP bearer

Path parameters

workspaceinteger required

The workspace ID

actionBatchstring required

Query parameters

account_idinteger

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.

cursorinteger

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

limitinteger

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

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.

Changes

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property ///// to the response with the status