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.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
