Skip to main content
GET
Read execution state

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

DreamLayer-Version
string
required
Allowed value: "1"

Path Parameters

execution_id
string<uuid>
required

Response

Canonical execution state

execution_id
string<uuid>
required
conversation_id
string<uuid>
required
status
enum<string>
required
Available options:
needs_input,
queued,
running,
completed,
failed,
cancelled
image_job
object | null
required
question
object | null
required

The outstanding clarification, so a client that reconnected or never held the stream can still answer it. Null whenever nothing is outstanding, which includes an execution whose question has already been answered: answering creates a new execution and the one that asked stays at status needs_input with a null question. A non-null question is the only reliable signal that a turn is still waiting. Additive: treat a missing field as null.

error
object | null
required

Public admission failure when status is failed; otherwise null.