mcp

Get Job Status

Lean status probe for a story, revision, asset, article, or chat op.

is_terminal is the only terminal signal clients should use. Prefer wait_for_status over a client poll loop.

post/api/mcp/get_job_status

Request

  • Base URL: https://writer.swapp1990.org (the document declares no server; this is the origin it was published from)
  • URL: https://writer.swapp1990.org/api/mcp/get_job_status
  • Auth: none declared

Request body

job_idstring required

The story job ID.

kindstring

Which job family to probe: story | revision | chat_operation | asset | chapter_cover | cover_image | article. job_id is the id of that family (story id, asset job id, cover_job_id, operation_id, or article id).

include_debugboolean

Include noisy revision debug fields when kind=revision.

Response

Successful Response

job_idstring nullable
kindstring nullable
idstring nullable
statusstring nullable
current_stepstring nullable
revision_statusstring nullable
chapters_doneinteger nullable
chapter_countinteger nullable
is_terminalboolean nullable
timed_outboolean nullable
requested_timeout_secondsnumber nullable
effective_timeout_secondsnumber nullable
created_atstring nullable
updated_atstring nullable
story_urlstring nullable
article_urlstring nullable
resultunknown
errorunknown
progressunknown
current_segmentunknown

Changes

No recorded changes to this operation across all 1 revision of this API.