Skip to content
Elicitly

elicit_await

Block until an approval request is decided, or the wait bound elapses — the long-poll at the heart of the Approval Flow.

When to use

Section titled “When to use”

The agent has nothing useful to do until the human decides. One elicit_await loop replaces a busy elicit_status poll: each call parks server-side and returns the instant a decision lands (or the bound elapses).

Input

Section titled “Input”
Parameter Type Required Description
elicitationId string yes The id returned when the request was created. 
{ "elicitationId": "…" }

Behavior

Section titled “Behavior”
  • A bounded long-poll: waits up to min(server bound, time until expiry), returning the instant a decision lands.
  • If it returns "pending", the wait bound was hit before a decision — just call it again. That single loop works on every host: the call always returns before the host’s tool-call timeout.

Output

Section titled “Output”
{ "status": "approved" }

status is one of pending · approved · rejected · consumed · expired.

Section titled “Related”