clear_start_after
Clears a card's start_after only when the read schedule still matches; changed cards are refused with a conflict, preventing stale overwrites.
Instructions
Clear a card's start_after only if it is still exactly the schedule you read (compare-and-clear). Pass the start_after, version, start_after_origin and start_after_receipt_id from get_task. A changed card is refused with 409 cas_conflict and its current values — nothing is written; re-read before deciding anything. Repeating a call with the same idempotency_key returns the first receipt (replayed=true). Does not touch human gates, dependencies, waits or due_date.
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": {
"task_id": "<task_id>",
"expected_start_after": "<expected_start_after>",
"expected_version": "<expected_version>"
},
"name": "clear_start_after"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| reason | No | Why the date is no longer needed, max 500 chars; stored on the clear receipt. | |
| task_id | Yes | The card (UUID or 6-12 hex short id). | |
| expected_origin | No | The card's start_after_origin as you read it: agent_evidence, human_explicit or legacy_unknown. Required for an agent. | |
| idempotency_key | No | Key of this clear, max 200 chars; reuse it when you repeat the same call. Generated when omitted. | |
| expected_version | Yes | The card's version as you read it. | |
| schedule_receipt_id | No | The card's start_after_receipt_id as you read it. Required for an agent unless the origin is legacy_unknown. | |
| expected_start_after | Yes | The card's start_after as you read it, RFC3339. |