Get status for a generation run
Organization Admin permissions are required to use this endpoint.
Retrieve the status of a specific generation run. Poll until status is terminal (complete or failed), then re-fetch the suggestions list.
Authorizations
Can be either an Organization API Key or Personal Access Token (PAT).
Include in the Authorization header as: Bearer YOUR_TOKEN
Path Parameters
UUID of the shared model the run belongs to
"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
UUID of the generation run
"b2c3d4e5-f6a7-8901-bcde-f12345678901"
Response
The generation run
Represents a single AI model suggestion generation run.
The run ID.
"a1b2c3d4-e5f6-7890-abcd-ef1234567890"
Run status. Terminal states are complete and failed.
queued, executing, complete, failed "complete"
Whether the run was triggered manually or by the schedule.
manual, scheduled "manual"
The user who triggered a manual run; null for scheduled runs.
ISO 8601 timestamp when the run was created (queued).
"2026-07-15T14:30:00Z"
ISO 8601 timestamp when the worker started executing; null while queued.
"2026-07-15T14:30:05Z"
ISO 8601 timestamp when the run reached a terminal state.
"2026-07-15T14:32:30Z"
Failure details when status is failed; null otherwise.

