GoodMemGoodMem
ReferenceAPIREST APIAdmin

Delete a RetrieveMemory log policy

DELETE /v1/admin/retrieve-memory-log-policies/{id}: Idempotently tombstones an immutable RetrieveMemory log policy.

Idempotently tombstones an immutable RetrieveMemory log policy.

DELETE
/v1/admin/retrieve-memory-log-policies/{id}

Authorization

x-api-key<token>

In: header

Path Parameters

idstring

The UUID of the policy to delete

Header Parameters

GoodMem-Timeout-Ms?integer

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.

Formatint64
Range1 <= value <= 86400000

Request Body

Optional tombstone reason.

reason?string | null

Optional tombstone reason.

Example"Replaced by narrower policy."

Response Body

curl -X DELETE "https://your-goodmem-server.example.com/v1/admin/retrieve-memory-log-policies/40000000-0000-4000-8000-000000000301" \  -H "GoodMem-Timeout-Ms: 30000" \  -H "Content-Type: application/json" \  -d '{}'
{
  "policyId": "40000000-0000-4000-8000-000000000301",
  "displayName": "Security audit policy",
  "description": "Capture security-sensitive retrievals.",
  "condition": {
    "matchAll": false,
    "anyOf": [
      {
        "spaceIds": [
          "30000000-0000-4000-8000-000000000301"
        ],
        "spaceLabelSelectors": {
          "env": "prod"
        }
      }
    ]
  },
  "activeFrom": 2219443200000,
  "activeUntil": 2219529600000,
  "labels": {
    "owner": "security",
    "env": "prod"
  },
  "currentlyActive": true,
  "deletedAt": 2219533200000,
  "deletedById": "10000000-0000-4000-8000-000000000301",
  "deleteReason": "Replaced by narrower policy.",
  "createdAt": 2219443200000,
  "updatedAt": 2219443200000,
  "createdById": "10000000-0000-4000-8000-000000000301",
  "updatedById": "10000000-0000-4000-8000-000000000301"
}
Empty
Empty
Empty
Empty
Empty

Create a RetrieveMemory log policy

POST /v1/admin/retrieve-memory-log-policies: Creates an immutable administrative policy that can automatically enable durable RetrieveMemory request logging.

Request the server to enter drain mode

POST /v1/admin:drain: Initiates drain mode and optionally waits for the server to quiesce.