Skip to main content
GET
Get status for a generation run

Authorizations

Authorization
string
header
required

Can be either an Organization API Key or Personal Access Token (PAT).

Include in the Authorization header as: Bearer YOUR_TOKEN

Path Parameters

modelId
string<uuid>
required

UUID of the shared model the run belongs to

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

runId
string<uuid>
required

UUID of the generation run

Example:

"b2c3d4e5-f6a7-8901-bcde-f12345678901"

Response

The generation run

Represents a single AI model suggestion generation run.

id
string<uuid>
required

The run ID.

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

status
enum<string>
required

Run status. Terminal states are complete and failed.

Available options:
queued,
executing,
complete,
failed
Example:

"complete"

triggerSource
enum<string>
required

Whether the run was triggered manually or by the schedule.

Available options:
manual,
scheduled
Example:

"manual"

triggeredBy
object | null
required

The user who triggered a manual run; null for scheduled runs.

createdAt
string<date-time>
required

ISO 8601 timestamp when the run was created (queued).

Example:

"2026-07-15T14:30:00Z"

executionStartedAt
string<date-time> | null
required

ISO 8601 timestamp when the worker started executing; null while queued.

Example:

"2026-07-15T14:30:05Z"

completedAt
string<date-time> | null
required

ISO 8601 timestamp when the run reached a terminal state.

Example:

"2026-07-15T14:32:30Z"

error
object | null
required

Failure details when status is failed; null otherwise.