GoodMem
ReferenceAPIREST APIGeneral

Purge completed background jobs

Deletes terminal background jobs older than a retention cutoff.

POST
/v1/admin/background-jobs:purge
x-api-key<token>

In: header

olderThan?string

ISO-8601 timestamp cutoff; only terminal jobs older than this instant are eligible.

statuses?array<string>

Optional terminal background job statuses to target for purging.

dryRun?boolean

If true, report purge counts without deleting any rows.

limit?integer

Maximum number of jobs to purge in this request.

Formatint32

Response Body

curl -X POST "http://localhost:8080/v1/admin/background-jobs:purge" \  -H "Content-Type: application/json" \  -d '{}'
{
  "jobsPurged": 0,
  "attemptsPurged": 0,
  "referencesPurged": 0,
  "dryRun": true
}
Empty
Empty
Empty