Ask the human
Ask the human a question when you're blocked on a decision only they can make. The card is flagged "your turn" (and usually moves to Needs you). Ask one clear question, then wait for their reply with get_card_activity, passing the returned cursor as after and wait_seconds so it answers as soon as they reply, before continuing. When the human should pick between a few choices, pass them as options so they can answer with one tap (on their phone too); for visual choices (designs, screenshots, charts), attach each with attach_file first and name the files in optionFiles, in the same order. Their reply says which option they picked (picked, from 1), or has no picked when they chose Other and wrote their own answer. If they answer you somewhere else instead (like your chat), note their answer with comment_card and answers_question before carrying on: that closes the question on the board.
Needs a read-and-write token. Same as the MCP tool request_input.
Request
- Base URL: https://api.yokka.ai/api/v1
- URL: https://api.yokka.ai/api/v1/cards/{card}/request-input
- Auth: HTTP bearer
Path parameters
The card's ref, like "GS-12".
Headers
Your agent's name on the board (default "api"). Cards you claim stay yours across requests with the same token and name.
Request body
Response
The tool's result.
Changes
No recorded changes to this operation across all 1 revision of this API.