v1

latestOpenAPI 3.1.02026-07-2618690613.4 KB

AI Model Suggestions

Get status for a generation run

<Note> **Organization Admin** permissions are required to use this endpoint. </Note>

Retrieve the status of a specific generation run. Poll until status is terminal (complete or failed), then re-fetch the suggestions list.

get/v1/models/{modelId}/suggestions/runs/{runId}

Path parameters

modelIdstring uuid required

UUID of the shared model the run belongs to

Example:a1b2c3d4-e5f6-7890-abcd-ef1234567890

UUID of the shared model the run belongs to

runIdstring uuid required

UUID of the generation run

Example:b2c3d4e5-f6a7-8901-bcde-f12345678901

UUID of the generation run

Response

The generation run

idstring uuid required

The run ID.

status'queued' | 'executing' | 'complete' | 'failed' required

Run status. Terminal states are complete and failed.

triggerSource'manual' | 'scheduled' required

Whether the run was triggered manually or by the schedule.

createdAtstring date-time required

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

executionStartedAtstring date-time nullable required

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

completedAtstring date-time nullable required

ISO 8601 timestamp when the run reached a terminal state.

errorobject nullable required

Failure details when status is failed; null otherwise.

Example response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "complete",
  "triggerSource": "manual",
  "triggeredBy": {
    "userId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "name": "Jane Doe"
  },
  "createdAt": "2026-07-15T14:30:00Z",
  "executionStartedAt": "2026-07-15T14:30:05Z",
  "completedAt": "2026-07-15T14:32:30Z"
}