Skip to main content
GET
/
v1
/
runs
/
{runId}
/
wait
Wait For Run
curl --request GET \
  --url https://app.uselamina.ai/v1/runs/{runId}/wait \
  --header 'x-api-key: <api-key>'
{
  "data": {
    "runId": "fc32ae7d-6840-4be3-8fb1-539a60e33fc3",
    "workflowId": "80d4d454-8844-489f-b903-2ad65a414482",
    "status": "completed",
    "outputs": [
      {
        "id": "aiDesignerNode-1773051929782",
        "label": "AI Designer",
        "type": "image",
        "value": "https://storage.example.com/output.png",
        "status": "completed",
        "error": null
      }
    ],
    "completedAt": "2026-04-18T14:32:15.000Z"
  }
}
Long-poll endpoint that blocks until the execution finishes or the timeout expires. Simpler alternative to SSE streaming for agents and HTTP clients that cannot consume event streams. Use this when your agent runtime does not support EventSource or SSE. The server polls internally and returns once the execution reaches completed, failed, or cancelled. If the timeout expires first, the response includes timeout: true alongside the current execution state — this is not an error.
  • Image workflows: timeout=60 (default)
  • Video workflows: timeout=120

​
Compared to other result delivery methods

MethodWhen to use
Wait (this endpoint)Agent can make HTTP calls but not consume SSE. Simplest integration.
SSE streamNeed real-time progress events (node completions, intermediate status).
WebhookProduction workloads where you don’t want open connections.
PollingFallback when none of the above fit. Poll every 3-5 seconds.

Authorizations

​
x-api-key
string
header
required

Workspace API key. Prefix: lma_. Example: lma_abc123...

Path Parameters

​
runId
string<uuid>
required

The run ID returned from the Run App or Content Create endpoint

Query Parameters

​
timeout
integer
default:60

Maximum seconds to wait before returning (default 60, max 120)

Required range: 1 <= x <= 120

Response

Execution status. If timeout is true, the execution has not yet reached a terminal state — poll again or wait longer.

​
data
object

Poll until status is completed or failed.

​
timeout
boolean

true if the wait timed out before the execution finished