---
title: "Poll a queued operation"
method: GET
path: "/api/v1/jobs/{id}"
tags: ["Editing"]
---

# Poll a queued operation

`GET /api/v1/jobs/{id}`

## Request

- Base URL: `https://app.mondovo.com`
- URL: `https://app.mondovo.com/api/v1/jobs/{id}`
- Auth: HTTP bearer

Returns the status of an operation queued by refine, add-page, or `create_visual`. Poll about every 10s until `status` is `completed` or `failed`. A `completed` job can still carry per-item failures in `failed`. Requires `sites:read` for site-build jobs or `creative:read` for generation jobs.

## Response `200`

Job status.

- object
  - `job_id` string, uuid, required
  - `site_id` string, uuid
  - `status` 'pending' | 'processing' | 'completed' | 'failed', required
  - `phase` 'refine' | 'pages' | 'addons' | 'features' | 'collections' | 'nav' | 'done'
  - `progress` object
    - `refinements_applied` integer
    - `refinements_total` integer
    - `pages_created` integer
    - `pages_total` integer
  - `current_label` string
  - `failed` object[]: Per-item failures. Present even on a completed job.
    - `section` 'refine' | 'pages' | 'addons' | 'features' | 'collections'
    - `ref` string
    - `message` string
  - `error` string, nullable
  - `created_at` string, date-time
  - `completed_at` string, date-time, nullable
  - `message` string

## Other responses

- `401`: Authentication failed. Error codes: `invalid_api_key` (missing/unknown key), `key_revoked`, `key_expired`.
- `403`: Authenticated but not allowed. Error codes: `addon_required` (the API key’s workspace no longer has the Agency add-on — checked on every request, not just at key creation) and `missing_scope` (the key lacks the scope this endpoint needs).
- `404`: `job_not_found` — no such job, or it belongs to another workspace.
- `429`: Rate limit exceeded (`rate_limit_exceeded`). The body includes `retry_after_seconds`, `limit`, and `window` ("minute" or "hour"); a `Retry-After` header is also set.

---

[API](https://skmtc.dev/mondovo/apis/mondovo-public-api.md) · [All operations](https://skmtc.dev/mondovo/apis/mondovo-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mondovo/apis/mondovo-public-api/revisions/1baa3e2865ba?raw)