Survey a resource erasure

POST

/api/admin/resources/erasure/survey

Maintainer:Not configured

OperationId:admin_survey_resource_erasure

Reports what the erasure act would do for a resource, without recording or changing anything. plan is absent when the resource was already erased. Requires a system admin. Any other caller gets 404, decided before any lookup.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

What the act would do (plan is absent when the resource was already erased); nothing is recorded or changed

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠422Parameter Error

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/admin/resources/erasure/survey' \
--header 'X-Temper-Surface;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "resource": "d008879e-b5d9-47da-af4e-3c8f40b7c9ee"
}'

Response Example

200 - Example 1

{
    "already_erased": true,
    "plan": null,
    "resource": "d008879e-b5d9-47da-af4e-3c8f40b7c9ee"
}

Modified at 2026-10-06 12:32:37

Erase a resource

Re-embed stale chunks