Creative
Betacreative_jobs_wait
Wait for a Creative job to finish in the connected workspace.
Operation: Read-only. The OAuth grant determines the workspace.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
job_id | string | Yes | Creative job ID. |
timeout_seconds | integer | No | Polling deadline in seconds. Range 1–300. Defaults to 45. Keep it below your MCP client request timeout, which is 60 seconds by default in the MCP SDK; raise the client timeout before passing a larger value. |
The tool checks status immediately. Between checks it waits 2, 4, then 8 seconds, with later intervals capped at 10 seconds. When status reports completed, failed, or canceled, or when the polling deadline expires, the tool fetches the job record. The response contains job (the job object from creative_jobs_get) and timed_out (a boolean). timed_out is true if polling reached the deadline before observing a terminal state. If job.status is completed, use creative_jobs_result to fetch its output.
Sample prompt
Wait up to 45 seconds for the image job I just started.