update_approval_channel
Destructive
Change an approval channel's name, delivery channels, or timeout so human approval requests reach the right contacts within the correct response window.
Instructions
Update an approval channel. Can change name, channels, or timeout.
ACCESS: needs a Proof account. Set PROOF_API_KEY and restart this server, then call this tool again. start_login does NOT open this tool.
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": {
"id": "<id>"
},
"name": "update_approval_channel"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Approval channel ID | |
| name | No | New name (null to clear) | |
| channels | No | Updated channels | |
| timeout_seconds | No | Updated timeout in seconds (60–86400) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | MongoDB ObjectId | |
| name | No | ||
| status | Yes | Status of a HITL configuration | |
| keypair | Yes | Encryption keypair metadata (null if not configured) | |
| user_id | Yes | Owner user ID (useful for SDK encryption AAD) | |
| channels | Yes | ||
| circle_id | No | Backing Circle for a circle-backed Approvals config (null for channel-list configs) | |
| created_at | Yes | ||
| profile_id | No | ||
| updated_at | Yes | ||
| environment | Yes | ||
| timeout_seconds | Yes |