elicit_result
Fetch the outcome of a decided request — the final step of the Approval Flow.
When to use
Section titled “When to use”After elicit_await or
elicit_status reports a decision. Calling it
earlier errors: while the request is still pending, and also after it
has expired undecided. Once the reviewer has decided, it succeeds for
either outcome — approved or rejected — both are fetchable, not
just approvals.
| Parameter | Type | Required | Description |
|---|---|---|---|
elicitationId |
string | yes | The id returned when the request was created. |
{ "elicitationId": "…" }Behavior
Section titled “Behavior”Idempotent: every fetch is recorded as a consumed audit event, and
repeat calls return the same result — for as long as the record is retained
(90 days; see Data Retention).
Output
Section titled “Output”{ "status": "consumed", "decision": "approved", "context": { "target": "prod" }, "formSubmission": { "approver": "Ada", "confidence": 95 }}decision— the reviewer’sapproved/rejectedchoice.context— the read-only payload fromelicit_approval(orelicit_proposal), echoed back verbatim (nullif none was supplied). Never a value the agent re-supplies — the human approved what actually runs.formSubmission— the reviewer’s validated field values, keyed byrequestedSchemaproperty name (nullin JSON mode, i.e. when norequestedSchemawas given).
Per-tool overlays
Section titled “Per-tool overlays”elicit_selectionaddsselectedIds— the chosen optionids, present whendecisionisapproved.elicit_proposaladdsaction("submit"whendecisionisapproved,"cancel"whenrejected) and, on submit,values(only the fields the reviewer included). A cancelled proposal is fetchable like any other decided request — it returns{ "action": "cancel", "decision": "rejected", … }rather than erroring.
Related
Section titled “Related”elicit_await/elicit_status— reach a decided state firstelicit_history— recover a lostelicitationId