---
title: creative_jobs_wait
description: Wait for a Creative job to finish in the connected workspace.
canonical_url: https://orchestor.io/docs/en/mcp/tools/creative/creative_jobs_wait
markdown_url: https://orchestor.io/docs/en/mcp/tools/creative/creative_jobs_wait.md
contentType: reference
---

# creative_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

```text
Wait up to 45 seconds for the image job I just started.
```

[Creative](https://orchestor.io/docs/en/mcp/tools/creative.md) · [Tools](https://orchestor.io/docs/en/mcp/tools.md)

---

[Documentation index](https://orchestor.io/docs/llms.txt)
