---
title: "Reconcile an existing private video request status"
method: GET
path: "/jobs/{job_id}/private-video-diagnostic"
---

# Reconcile an existing private video request status

`GET /jobs/{job_id}/private-video-diagnostic`

## Request

- Base URL: `https://api.bamf.ai/v1`
- URL: `https://api.bamf.ai/v1/jobs/{job_id}/private-video-diagnostic`
- Auth: HTTP bearer

Read-only status reconciliation for an already-failed private video job. Requires a signed-in user JWT with images:generate and ownership of the job's exact creator/project/private-keyframe scope. Performs one provider status GET for the request ID already stored on the job; it does not submit, retry, cancel, or mutate a job. Provider detail is reduced to closed reason and detail enums; no raw provider response or request ID is returned.

## Path parameters

- `job_id` string, uuid, required

## Response `200`

Bounded provider status diagnostic.

- PrivateVideoDiagnosticResponse
  - `data` object, required
    - `provider` 'higgsfield', required
    - `status` 'queued' | 'in_progress' | 'completed' | 'failed' | 'nsfw' | 'canceled' | 'unknown' | 'null', nullable, required
    - `reason` 'moderated' | 'cancelled' | 'insufficient_balance' | 'capacity_or_rate_limit' | 'invalid_request' | 'provider_failed' | 'upstream_http_error' | 'provider_unreachable' | 'unknown', required: Conservative normalized category inferred from provider status/error text; these are not provider-defined error codes.
    - `detail` 'source_fetch_failed' | 'source_media_invalid' | 'unsupported_model' | 'provider_internal_error' | 'generation_failed' | 'unknown', required: Coarse closed category inferred from explicit provider wording patterns; not a verified root cause, provider code, or raw provider text.
    - `httpStatus` integer, nullable, required

## Other responses

- `400`: Malformed job UUID.
- `401`: Valid signed-in user session required.
- `403`: Signed-in user or scope required.
- `404`: No eligible private video job was found in this user's scope.
- `503`: Server-side diagnostic credentials are unavailable. Provider status transport failures return a bounded 200 diagnostic.

---

[API](https://skmtc.dev/bamf/apis/bamf-developer-platform-api.md) · [All operations](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/revisions/a390dd3294bd?raw)