Read authoritative upload, preflight, import, and bulk progress

GET 
/api/v1/paperless-imports/:import_id

Requires migration.manage and exact household scope. Returns the durable workflow snapshot, including immutable bulk operations, preflight report, progress, bounded failure, and restart instructions.

Request

Responses

200

Authoritative workflow status

Response Headers

X-Request-Id

Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.

401

The opaque credential is absent, ambiguous, malformed, expired, revoked, or invalid

Response Headers

X-Request-Id

Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.

404

The resource is unknown or outside the authenticated household scope

Response Headers

X-Request-Id

Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.

421

The request authority or direct peer is outside the configured Jiandu ingress boundary

Response Headers

X-Request-Id

Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.

503

A required core dependency is unavailable; retry with bounded backoff

Response Headers

X-Request-Id

Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.