Release a held received email
release_received_emailReleases a held received message so the domain delivers it and the approval row is marked decided. Pass a reason to record the decision on the audit row.
Instructions
Purpose: release one received message that a domain is holding. The arrival webhook fires once, and the approval row is marked decided. NOT for: mail that was not held. A clear message is already delivered. Pass a reason; it is kept on the audit row. Returns: the message, including held=false and inbound_verdict.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"received_id": "<received_id>",
"reason": "<reason>"
},
"name": "release_received_email"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| reason | Yes | Why this message is being released. | |
| received_id | Yes | The id of the held message. | |
| idempotency_key | No | Your own key for this action. Retrying with the same key returns the first result instead of doing it twice — send one whenever a retry could double the effect. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Identifier. | |
| held | No | False after a release. | |
| error | No | Present instead of the fields above when the call was refused: code, message, fix, docs_url, retryable and, when waiting helps, retry_after_seconds. | |
| verdict | No | clear, review, or unavailable. |