Check job status (free)
kimi_job_statusCheck a background job's lifecycle state after an async call, returning status, elapsed time, expiry, and result availability. Detect stored failures without fetching the full result.
Instructions
Check a background job's lifecycle state without fetching the full result.
Use after any *_async call (kimi_delegate_async, kimi_consult_async,
kimi_review_changes_async) or any sync consult/review/delegate (whose meta.job_id
names its record). Returns status, elapsed time, expiry, and result_available; when
it is true, call kimi_job_result. result_ok reports a done job's producer-declared
outcome — true (success), false (a stored error envelope), or null (running, no stored
envelope, an unclassifiable payload, or a record finalized before this field) — so you
can spot a stored FAILURE without fetching it. It does not guarantee the payload is
still fetchable; a cross-release record may report an outcome yet fail kimi_job_result
with job_result_incompatible. Free — no model call.
Honor poll_after_ms between polls — for a running job it GROWS with elapsed
runtime (bounded), so following it backs you off instead of tight-looping (a
delegate often runs ~20s). expires_at is null while running and is set once the
job finishes; results are then retained ttl_seconds past that completion.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| job_id | Yes | The job_id from an *_async call or a sync call's meta.job_id; recover lost ids with kimi_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 |