Fetch and delete job result (free)
codex_job_consume_resultFetch a completed background Codex job's result and remove its stored record, preventing redundant polling and keeping state clean.
Instructions
Fetch a finished background Codex job's result and delete the stored record.
Same envelope as codex_job_result (matching the job's kind — branch on tool),
then removes completed job state — but only once the stored result has been read
intact and validated (a success or the job's own error envelope): a stored result
this release cannot read (job_result_incompatible or a corruption internal_error)
is NOT deleted, so it stays inspectable via codex_job_result. Deletion precedes
the response, so a response lost in transit does not restore the record; a failed
removal retains the record until its TTL (codex_job_status still shows it). Use
only when you no longer need to poll or re-read the job. Non-done jobs are not
deleted. Free — no model call.
detail works as in codex_job_result (#56).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| detail | No | Response verbosity: 'summary' (default) omits the raw model text; 'full' includes it. | summary |
| job_id | Yes | The job_id from an *_async call or a sync call's meta.job_id; recover lost ids with codex_job_list. | |
| workspace_root | No | Absolute path to the target repo root — pass it (or an MCP root) to target the intended repo; otherwise the call falls back to the server's own cwd and sets meta.workspace_warning. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | true = success result, false = error result |