Purge completed background jobs
POST /v1/admin/background-jobs:purge: Deletes terminal background jobs older than a retention cutoff.
Deletes terminal background jobs older than a retention cutoff.
In: header
Header Parameters
Optional waiting budget in milliseconds, measured from REST servlet ingress and shared across all internal gRPC calls. Supply one decimal integer from 1 to 86400000. Omission adds no deadline. Existing shorter deadlines still apply. Expiry returns HTTP 504 before streaming starts; after streaming starts, no successful completion event is sent. Use SSE or opt into GoodMem-Stream-Terminal for an explicit terminal outcome. Retrieval work is cooperatively cancelled. An accepted mutation may still commit after timeout or disconnect; a failed response does not imply rollback.
int641 <= value <= 86400000ISO-8601 timestamp cutoff; only terminal jobs older than this instant are eligible.
date-timeOptional terminal background job statuses to target for purging. If omitted, all terminal statuses are eligible. Canonical values are BACKGROUND_JOB_SUCCEEDED, BACKGROUND_JOB_FAILED, and BACKGROUND_JOB_CANCELED. Short aliases SUCCEEDED, FAILED, and CANCELED are also accepted for compatibility.
If true, report purge counts without deleting any rows.
Maximum number of jobs to purge in this request. Must be >= 0; 0 means no limit.
int320 <= valueResponse Body
curl -X POST "https://your-goodmem-server.example.com/v1/admin/background-jobs:purge" \ -H "GoodMem-Timeout-Ms: 30000" \ -H "Content-Type: application/json" \ -d '{}'{
"jobsPurged": 0,
"attemptsPurged": 0,
"referencesPurged": 0,
"dryRun": true
}List RetrieveMemory log policies
GET /v1/admin/retrieve-memory-log-policies: Lists RetrieveMemory log policies with optional tombstone, active-time, name, label, sort, and pagination filters.
Reload the active license from disk
POST /v1/admin/license:reload: Triggers the server to reload its license file from the configured directory and returns metadata about the currently active license.