Bulk categorize bank lines

Bulk categorize, step 2: books many bank lines to the ledger in one call. Send the same items and Idempotency-Key as bankTransaction.bulkCategorize.preview and its confirmation_token (a different body answers 412; a used token confirmation_already_claimed). Answers 202 with operation_id, status queued and total, the number of ready lines the job will book; nothing is booked inside the request. A job then books each ready line on its own, as bankTransaction.categorize would, rechecking it first: a line booked, excluded or changed since the preview, or in a period locked since, ends refused with its code (changed_since_preview when the line or its exchange rate moved); refused preview items are never booked. Poll bankTransaction.bulkCategorize.status until succeeded. A replay with the same Idempotency-Key answers the stored 202 and starts no second operation. At most 3 bulk categorize operations per person and client may be queued or running at once (409 bulk_categorize_busy). Over MCP an AI agent sends its own work lease (work.claim) as the top-level lease_id argument, as on every write, never in the body; the commit keeps it for the job, which checks the company STOP, the run pause and other agents' leases before every line. Counts as one request toward the rate limit and the daily cap, whatever the number of lines. Requires Idempotency-Key, the bank-transactions:action OAuth scope and update_bank_accounts. Answers 503 with Retry-After while bulk categorize is switched off.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Confirmed values used to bulk categorize bank lines, including the confirmation token returned by bankTransaction.bulkCategorize.preview.

Bulk categorize, step 2 (MCP agent feedback P5): the preview's items
unchanged and its confirmation_token. An AI agent sends its own work
lease (work.claim) as the top-level lease_id of the call, as on every
write, never in this body: the commit keeps it for the job, which checks
the leases again before every line.

string
required
length ≤ 8192

The confirmation_token from bankTransaction.bulkCategorize.preview, called with the same items and Idempotency-Key.

items
array of objects
required
length between 1 and 50

The bank lines to categorize: 1 to 50 items, each line once, each with the body bankTransaction.categorize takes.

items*
Headers
string
required
length ≤ 191

Required unique key whose request hash and terminal response are stored durably for 24 hours.

Responses

Language
Credentials
OAuth2
Missing 1 required scope
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
*/*