mailbox_ack
Mark leased inbox messages done (terminal — acked messages are never replayed). Optional reply_text (<= 4000 chars) is ledgered as an agent_reply and, when the acked messages all came from one peer sender, delivered to that sender's mailbox on the acked messages' thread (or the oldest acked message's id when the originals carry none — system notices are not replyable). Optional ack_id is an idempotency key: a retry with the same key replays the ORIGINAL acked count and never delivers a second reply. Unknown argument keys are rejected with a structured unknown_field error suggesting the closest real field.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ack_id | No | Optional idempotency key (1-128 chars, non-blank). A retry carrying the same ack_id replays the ORIGINAL acked count and never delivers a second reply — use it when the transport ate your ack's response. | |
| reply_text | No | Optional reply (<= 4000 chars). Ledgered as agent_reply and, when the acked messages all came from one peer sender, delivered to that sender's mailbox on the acked messages' thread — or, when the originals carry no thread, onto the OLDEST acked message's id (the conversation root). System notices are not replyable. | |
| message_ids | Yes | Message ids from mailbox_claim / mailbox_check. |