Delete an extracted document
Permanently deletes an extracted document, its line items, and its stored source and extraction files. There is no undo, which is the point: this is the endpoint for honoring a data deletion request at document granularity. The processing job record and the originally uploaded file can be shared with other documents from the same upload, so those go when the loan is deleted rather than here. Requires a key with the `documents:delete` scope.
Authentication
AuthorizationBearer
Bearer token. Use `ss_live_…` for live data or `ss_test_…` for the sandbox (test mode). See [Authentication](https://docs.spreadspace.app/api/authentication).
Path parameters
borrowerId
The borrower's id.
docId
The document's id.
Headers
Idempotency-Key
Idempotency token. Retries that reuse the key within 24h replay the original response. Up to 255 characters; a UUID is typical. See [Idempotency](https://docs.spreadspace.app/api/idempotency).
SpreadSpace-Version
Pin the API version, e.g. `2026-07-19`. Omit to get the latest. See [Versioning](https://docs.spreadspace.app/api/versioning).
Response headers
X-Request-ID
Correlation ID for this request. Quote it in support tickets.
Idempotency-Replay
Set to true when the response is replayed from the idempotency cache for a request that re-presented an Idempotency-Key it had already used. Absent on the original (winner) response. Replays are byte-for-byte identical to the original response body.
SpreadSpace-Version
The API surface version the server resolved for this request. Always present, regardless of whether the client supplied the request-side SpreadSpace-Version header. Default: 2026-07-19.
RateLimit-Limit
Request budget of the endpoint's rate-limit policy per 60-second sliding window. See [Rate limits](https://docs.spreadspace.app/api/rate-limits).
RateLimit-Remaining
Requests left in the current window. Suppressed on 429 responses produced outside the rate limiter (for example a usage throttle), where a remaining budget would be misleading.
RateLimit-Reset
Seconds until a guaranteed-fresh window.
RateLimit-Policy
The active policy in limit;w=window-seconds form.
Response
OK
Errors
400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error