hosting
POST /v1/bulk-jobs/{bulkJobId}/retry-failed
Run a bulk job's failures again.
인증
Bearer 토큰으로 API 키를 전송하세요. 키는 반드시 sites.view 권한을 가지고 있어야 하며, 권한이 없는 키는 404가 아닌 403으로 거부됩니다.
이 엔드포인트는 조직 ID를 받지 않습니다. 사용자의 키가 이미 속한 조직을 식별하며, 응답은 해당 조직으로 한정됩니다.
무료 체험하기
대괄호 안에 있는 모든 내용을 사용자 지정 값으로 바꾸고, 키 플레이스홀더는 대시보드의 키로 바꾸세요.
curl -X POST https://api.zinndigital.com/v1/bulk-jobs/{bulkJobId}/retry-failed \
-H "Authorization: Bearer zdk_live_…"로그인하셨나요? 대시보드의 API 콘솔이 실제 조직 ID와 본인의 키를 자동으로 채우고 라이브 API를 대상으로 요청을 실행하므로 실제 응답을 확인할 수 있습니다. API 콘솔에서 이 엔드포인트를 여세요
상세 정보
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.
매개변수
| 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
bulkJobId (path) | Uuid | 예 | Bulk job ID (UUIDv7). |
응답
| 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
id | Uuid | 예 | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
org_id | Uuid | 예 | UUIDv7 identifier — sortable by creation time (docs/02 §8). |
operation | BulkOperation | 예 | 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 | 예 | 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 | 예 | 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 | 예 | — |
status | BulkJobStatus | 예 | ⛔ 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 | 예 | Who asked for it. |
note | string | 예 | — |
created_at | string | 예 | — |
updated_at | string | 예 | — |
settled_at | object | 예 | When the job finished; null while it is still running. |
counts | BulkJobCounts | 예 | — |
progress | BulkJobProgress | 예 | 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… |
이 엔드포인트가 반환할 수 있는 오류
401 · 403 · 404 · 409 · 422 · 429