hosting
POST /v1/bulk-jobs/{bulkJobId}/retry-failed
Run a bulk job's failures again.
Autentizace
Zašlete API klíč jako nosný token (bearer token). Klíč musí mít oprávnění sites.view; klíč bez něj je odmítnut s kódem 403, nikoli 404.
Tento koncový bod nevyžaduje žádné ID organizace. Váš klíč již identifikuje organizaci, ke které patří, a odpověď je na ni omezena.
Vyzvednout
Nahraďte cokoli v závorkách vlastními hodnotami a zástupný symbol klíče klíčem z vašeho řídicího panelu.
curl -X POST https://api.zinndigital.com/v1/bulk-jobs/{bulkJobId}/retry-failed \
-H "Authorization: Bearer zdk_live_…"Přihlášeni? Konzole API ve vašem dashboardu automaticky doplní vaše skutečné ID organizace i váš vlastní klíč a odešle požadavek na živé API, abyste viděli reálnou odpověď. Otevřete tento koncový bod v konzoli API
Podrobnosti
Puts the failed and skipped items back to pending and restarts the job's workflow. ⭐ unsupported items are not reopened, and that is deliberate: a platform with no shell will not grow one because somebody pressed a button, so a retry that provably does nothing is how a control stops being believed. A job that is still running is a 409 — the restart reuses the job's own workflow id, so this cannot start a second pass over the same rows. A job with nothing left to retry is a 422. Requires sites.view plus the operation's own key.
Parametry
| Název | Typ | Požadováno | Co to je |
|---|---|---|---|
bulkJobId (path) | Uuid | Ano | Bulk job ID (UUIDv7). |
Odpověď
| Název | Typ | Požadováno | Co to je |
|---|---|---|---|
id | Uuid | Ano | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
org_id | Uuid | Ano | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
operation | BulkOperation | Ano | What a bulk job does to each of its sites. ⛔ One job model with an operation discriminator, not eight job models. A selection, a frozen work-list, a durable pass and a per-site… |
params | BulkJobParams | Ano | The operation's arguments. Which keys are read depends on operation: plugin_install takes slugs + activate; plugin_activate, plugin_deactivate and plugin_remove take… |
selector | BulkSelector | Ano | Which sites a job targets. ⛔ There is no all. A job belongs to exactly one organization and all would span every tenant on the platform; the fleet-wide act is a staff… |
selector_value | string | Ano | — |
status | BulkJobStatus | Ano | ⛔ partial is a real outcome, not a rounding of the other two. A job where 4 of 900 sites failed is neither a success nor a failure, and reporting it as either is how a bulk… |
requested_by | string | Ano | Who asked for it. |
note | string | Ano | — |
created_at | string | Ano | — |
updated_at | string | Ano | — |
settled_at | object | Ano | When the job finished; null while it is still running. |
counts | BulkJobCounts | Ano | — |
progress | BulkJobProgress | Ano | How far along a job is, how fast it is going and how much longer it has. ⛔⛔ Every estimate here is nullable, and a null must never be rendered as 0. rate_per_minute: 0… |
Chyby, které může tento koncový bod vrátit
401 · 403 · 404 · 409 · 422 · 429