Skip to main content
GET
cURL

Authorizations

x-api-key
string
header
required

Your Recoup API key. Learn more.

Path Parameters

runId
string
required

The durable workflow run id returned by POST /api/chat/runs.

Response

Run status snapshot

Point-in-time status of an asynchronous chat-generation run.

runId
string
required

The durable workflow run id.

Example:

"wrun_01KVWZNM82NA7XKNEWWHG8VPHJ"

status
enum<string>
required

Lifecycle state of the run. Read the produced content via the chat (chatId from the start response).

Available options:
queued,
running,
completed,
failed,
cancelled
createdAt
string<date-time>

When the workflow run was created.

Example:

"2026-08-25T19:33:56.000Z"

startedAt
string<date-time> | null

When the workflow run started executing; null while queued.

Example:

"2026-08-25T19:34:16.386Z"

completedAt
string<date-time> | null

When the workflow run reached a terminal state; null while queued or running.

Example:

"2026-08-25T20:15:55.000Z"

durationMs
integer | null

completedAt - startedAt in milliseconds; null until the run is terminal.

Example:

2498614