Skip to main content
The Slack side is in Approvals, questions and plans. An ask’s id is ak_ followed by 12 characters. The runner opens approval and question asks only. Body fields: API schema.

Status

The first close wins. closedBy is the actor and closedAt the time. A message sent with ifBusy: "queue" leaves asks open; see Turns.

Find open asks

asks.list params:

Answer

asks.answer (POST /sessions/{id}/asks/{askId}/answer) closes the ask with an answer. Over HTTP the request body is the answer itself. It needs the asks:answer scope, as does asks.dismiss.
The result is the closed ask and the seq of its ask.closed event. The prompt message in Slack is deleted or updated, naming who answered.

Dismiss

asks.dismiss (POST /sessions/{id}/asks/{askId}/dismiss) closes an ask with no answer; the agent reads it as a denial. An optional message (up to 2,000 characters) is passed along.