integrations_set_thread_context
Turn signed thread context on or off for an HTTP-API integration. When on, each call an agent makes to it from inside a conversation carries the conversation's DialogBrain thread id, a timestamp and an HMAC-SHA256 signature made with secret (headers X-DialogBrain-Thread-Id, X-DialogBrain-Timestamp, X-DialogBrain-Context-Signature), so the integration can trust which chat the call comes from. secret (32-128 characters, generated by the integration) is required to turn it on, stored encrypted and never shown back. For a person's own client (API key or MCP) with the admin role; an agent cannot call it.
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": {
"integration_id": "<integration_id>",
"enabled": "<enabled>"
},
"name": "integrations_set_thread_context"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| secret | No | The HMAC key, 32-128 printable characters, generated by the integration. Required when enabled=true; write-only. | |
| enabled | Yes | true: sign calls with the thread context. false: stop. | |
| in_workspace | No | Run this one call in this workspace id instead of the session's. Nothing is stored; other sessions are not affected. | |
| integration_id | Yes | The HTTP-API integration's id (from integrations.list). |