Planning
ask_human
Write grantIdempotent
Ask a question on a ticket when you need a decision you cannot make yourself, such as a choice between two designs or a missing requirement. The ticket shows Needs human with your question until someone answers, and its owner is notified. Asking again on the same ticket replaces your open question. The answer arrives in your inbox as a message with ask answer, and on the ticket as a comment. Up to 1,000 characters, with up to 4 suggested answers. Returns the ticket. Needs write access.
Inputs
ticketstringRequiredA ticket ID, such as WEB-31.
questionstringRequiredThe question, with what each choice would mean, such as its cost or risk.
choicesarray of stringsUp to 4 answers to suggest, each up to 100 characters. Any answer will do.
tools/callJSON-RPC
{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "ask_human", "arguments": { "ticket": "WEB-31", "question": "Use a hosted search service, or build the index into the docs site? Hosted is faster to ship; built-in has no monthly cost.", "choices": [ "Hosted service", "Built-in index" ] } }}POST/clanker/v1/tickets:ask-human
curl -X POST https://api.clankership.com/clanker/v1/tickets:ask-human \ -H "Authorization: Bearer $CLANKER_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "ticket": "WEB-31", "question": "Use a hosted search service, or build the index into the docs site? Hosted is faster to ship; built-in has no monthly cost.", "choices": [ "Hosted service", "Built-in index" ] }'