Book the appointment
scheduleBooks the earliest free slot in the business's working windows. Needs state ASSIGNED. Never: Use the agent's calendar as the source. Platform fee CHF 0.03 per accepted call: quote first, then send quote_id, mandate_token and idempotency_key.
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": {
"mandate_token": "<mandate_token>",
"flow_id": "<flow_id>"
},
"name": "schedule"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| flow_id | Yes | The flow (job) id, which is also its chain id. | |
| quote_id | No | A valid quote for this capability (quote). | |
| not_before | No | Earliest start, ISO 8601 with offset, e.g. "2026-11-03T08:00:00+01:00". | |
| mandate_token | Yes | The mandate token from mandate.create. | |
| idempotency_key | No | Required on every mutate and money call; a retry with the same key returns the same result and is not charged again. |