Append one checksummed bounded export-file chunk

PATCH 
/api/v1/paperless-imports/:import_id/files/:ordinal

Requires migration.manage and an exact same-origin proof for cookie requests. The supplied offset must equal durable state and every bounded chunk must carry a matching SHA-256 checksum; failure rolls the file back and success advances the offset only after durable sync.

Request

Responses

204

Chunk is durable and Upload-Offset advanced

Response Headers

Upload-Length

Declared file length

Upload-Offset

Next durable byte offset

X-Request-Id

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

400

The request syntax, headers, body, or validated input is malformed or invalid

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.

403

The browser mutation did not originate from this application, or the authenticated member lacks the required permission

Response Headers

X-Request-Id

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

409

The request conflicts with the current resource, revision, lease, credential, or idempotency state

Response Headers

X-Request-Id

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

413

A configured streaming body or per-file size limit was exceeded. A transport-level rejection may omit the JSON body.

Response Headers

X-Request-Id

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

415

The payload media type is not accepted for this operation, or the file's actual content type is unsupported

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.

460

Chunk checksum mismatch

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.