Wait for review decisions
board_waitWaits for a person to approve or send back the cards you handed to review on this board, and returns each decision with the reviewer's note. It returns as soon as there is a decision after since, or after timeout_seconds with none. Call it after moving work to review instead of polling board_read. Pass next_since from the previous reply to continue where you left off; timeout_seconds 0 checks without waiting. A card sent back to you is marked as picked up, so the reviewer sees you got 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": {
"doc_id": "<doc_id>"
},
"name": "board_wait"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent | No | Whose hand-offs to watch. Defaults to this API key's name. | |
| since | No | ISO time to look after. Default: the last 24 hours. | |
| doc_id | Yes | The board's document id, as returned by board_create or nodiom_list_docs. | |
| timeout_seconds | No | How long to wait for a decision. Default 30, at most 45. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| next | No | ||
| decisions | Yes | ||
| next_since | Yes | Pass this as since next time. | |
| waited_seconds | No |