Skip to content
Elicitly

elicit_status

A non-blocking status read for an approval request — the polling alternative to elicit_await’s long-poll. Part of the Approval Flow.

When to use

Section titled “When to use”

You want the current status now, without waiting — a quick check between other work, or a host whose tool-call budget can’t afford a long-poll. If you have nothing else to do until the decision lands, prefer elicit_await over calling this in a loop.

Input

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

Output

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

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

  • Returns immediately with the current status; never waits.
  • Read-only and repeatable — it never consumes the result.
Section titled “Related”