> ## Documentation Index
> Fetch the complete documentation index at: https://docs.copyfy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# get_job_status

> Follow a job started by a Copyfy creation tool.

Returns the status of a job started by a creation tool: [`create_store_from_product`](https://docs.copyfy.io/tools/create-store-from-product), [`import_product_to_shopify`](https://docs.copyfy.io/tools/import-product-to-shopify), [`generate_ad_image`](https://docs.copyfy.io/tools/generate-ad-image), or [`copy_video_ad`](https://docs.copyfy.io/tools/copy-video-ad).

**Cost:** free.

## Arguments

| Argument | Type | Allowed values |
| - | - | - |
| `job_id` | string | The `job.id` returned by the creation tool, for example `img_mcp-6f1c2a9e0b7d4c3a8e5f1b2c3d4e5f60`. |

## Example

```json Tool call theme={null}
{
  "name": "get_job_status",
  "arguments": { "job_id": "img_mcp-6f1c2a9e0b7d4c3a8e5f1b2c3d4e5f60" }
}
```

```json Ad images theme={null}
{
  "job": {
    "id": "img_mcp-6f1c2a9e0b7d4c3a8e5f1b2c3d4e5f60",
    "kind": "ad_image",
    "created_at": "2026-10-27T09:14:02.000Z",
    "status": "succeeded",
    "images": [
      { "index": 0, "image_url": "https://bucket.copyfy.io/ai-creations/0.png", "aspect_ratio": "4:5", "model": "google/gemini-3.1-flash-image" },
      { "index": 1, "image_url": "https://bucket.copyfy.io/ai-creations/1.png", "aspect_ratio": "4:5", "model": "google/gemini-3.1-flash-image" }
    ],
    "dashboard_url": "https://app.copyfy.io/dashboard/creatives-ai",
    "library_url": "https://app.copyfy.io/library"
  }
}
```

```json Store AI theme={null}
{
  "job": {
    "id": "sto_k3v9x2m1q8w7",
    "kind": "store_ai",
    "project": { "id": "k3v9x2m1q8w7", "title": "Example Pet Store", "status": "setup" },
    "status": "action_required",
    "phase": "finish_setup",
    "next_action": { "type": "open_dashboard", "reason": "finish_store_setup", "url": "https://app.copyfy.io/dashboard/store-ai/k3v9x2m1q8w7/setup" },
    "dashboard_url": "https://app.copyfy.io/dashboard/store-ai/k3v9x2m1q8w7/setup"
  }
}
```

## Statuses

| `status` | Meaning |
| - | - |
| `starting` | The job was accepted and has not started yet. Call again after `poll_after_seconds`. |
| `running` | Work is in progress. Call again after `poll_after_seconds`. |
| `action_required` | A Store AI job waits for you in Copyfy: open `next_action.url`. |
| `succeeded` | Done: `images`, `videos`, `shopify_product`, or `dashboard_url` holds the result. |
| `partially_succeeded` | Some images came out and others failed: `images` lists the ones that exist, `failed_count` the others. The AI credits are kept, as in the dashboard. |
| `failed` | The job stopped. For image, video and Shopify import jobs, `error` says why and the MCP credit is given back. A failed generation also has its AI credits refunded, except an image generation that timed out (`generation_timeout`), which keeps them as in the dashboard. |
| `unknown` | Copyfy cannot confirm the outcome, and the MCP credit is kept. A Shopify import lost track of its outcome: check the products in your Shopify admin before importing again. Or a generation started but its results were deleted from your Copyfy library (`results_unavailable`). |

## Results by kind

| `kind` | Started by | Result when it succeeds | Poll every |
| - | - | - | - |
| `ad_image` | [`generate_ad_image`](https://docs.copyfy.io/tools/generate-ad-image) | `images`: `index`, `image_url`, `aspect_ratio`, `model` | 10 s |
| `video_ad` | [`copy_video_ad`](https://docs.copyfy.io/tools/copy-video-ad) | `videos`: `index`, `video_url`, `aspect_ratio`, `model` | 30 s |
| `shopify_import` | [`import_product_to_shopify`](https://docs.copyfy.io/tools/import-product-to-shopify) | `shop_domain`, `shopify_product` (`id`, `handle`, `title`, `status`, `admin_url`), `created_without_images` | 5 s |
| `store_ai` | [`create_store_from_product`](https://docs.copyfy.io/tools/create-store-from-product) | `project`, `phase`, `next_action`, `dashboard_url` | 10 s, 60 s while the store builds |

Stop polling at `succeeded`, `partially_succeeded`, `failed`, `unknown`, or `action_required`. A job id of another account, or an unknown id, returns [`not_found`](https://docs.copyfy.io/errors#not_found). Polls count toward the rate limit of 30 calls per minute.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.