foliot docs

API reference / Apps / Purge a deleted app now

Purge a deleted app now

POST/apps/{appId}/purge

Authenticate with an operator token or a signed-in Foliot Console session.

An operator token, or a signed-in person who is an owner of the app’s workspace. Never an app key. Removes a deleted app now instead of at purgeAfter: the app, its workflows, runs, run history, tasks, signals, bulk jobs and credential history. It cannot be undone. Only a deleted app: a live one answers 404 here, so delete it first. A record that it existed (its id and name, who deleted and purged it, when and why) is kept permanently. The reason is required.

Path parameters

appId
string
REQUIRED

The app's id.

Request body

reason
string
REQUIRED

Why. Required, and recorded.

min length 8 · max length 1000

Responses

200 object OK
400 Error Invalid request.
401 Error Missing, malformed or unknown bearer token.
403 Error The token is valid but not permitted on this route.
404 Error No such resource.
503 Error A dependency this route needs is unreachable.