Spaces

Clean up failed documents and facts

POST
/spaces/{space_id}/clean

Delete failed-extraction documents from a Space and reclaim facts-table storage (OPTIMIZE + VACUUM). Requires delete permission.

Authorization

bearerApiKey
AuthorizationBearer <token>

Create a scoped API key in the Adlass settings.

In: header

Path Parameters

space_id*string

Resource identifier: space_id.

Formatuuid

Header Parameters

X-Request-Id?string

Optional correlation identifier.

Lengthlength <= 128
Idempotency-Key*string

A unique key for this intended write. Reuse it only for an identical retry.

Length1 <= length <= 200

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.com/spaces/123e4567-e89b-42d3-a456-426614174000/clean" \  -H "Idempotency-Key: 123e4567-e89b-42d3-a456-426614174000"
{  "space_id": "123e4567-e89b-42d3-a456-426614174000",  "deleted_documents": [    {      "id": "123e4567-e89b-42d3-a456-426614174000",      "file_name": "invoice-2026-09.pdf",      "status": "deleted"    }  ],  "facts_rows_deleted": 0,  "optimize_metrics": {},  "vacuum_files_deleted": 0}