GoodMemGoodMem
ReferenceAPIREST APIAdmin

Get a RetrieveMemory log policy

GET /v1/admin/retrieve-memory-log-policies/{id}: Retrieves a live RetrieveMemory log policy by UUID, or a tombstoned policy when includeDeleted is true.

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

Retrieves a live RetrieveMemory log policy by UUID, or a tombstoned policy when includeDeleted is true.

Authorization

ApiKeyAuth
headerx-api-key<token>

Path Parameters

id*string

The UUID of the policy to retrieve

Query Parameters

includeDeleted?boolean

Whether to include tombstoned policies. Also accepts include_deleted.

Defaultfalse

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

Response Body

Policy found

application/json
  1. response

REST representation of an immutable RetrieveMemory log policy.

policyId*string

Policy UUID.

Formatuuid
Example"40000000-0000-4000-8000-000000000301"
displayName*string

Human-readable policy name.

Example"Security audit policy"
description?|

Optional operator description.

Example"Capture security-sensitive retrievals."
condition*

Policy match condition.

activeFrom*integer

Inclusive activation time in milliseconds since epoch.

Formatint64
Example2219443200000
activeUntil?|

Exclusive deactivation time in milliseconds since epoch.

Formatint64
Example2219529600000
labels*

Operator labels for listing and administration.

Propertiesproperties <= 64
Example
{  "owner": "security",  "env": "prod"}
currentlyActive*boolean

Whether the policy is active at response evaluation time.

Exampletrue
deletedAt?|

Tombstone time in milliseconds since epoch.

Formatint64
Example2219533200000
deletedById?|

User UUID that tombstoned the policy.

Formatuuid
Example"10000000-0000-4000-8000-000000000301"
deleteReason?|

Optional tombstone reason.

Example"Replaced by narrower policy."
createdAt*integer

Creation time in milliseconds since epoch.

Formatint64
Example2219443200000
updatedAt*integer

Update time in milliseconds since epoch.

Formatint64
Example2219443200000
createdById*string

Creator user UUID.

Formatuuid
Example"10000000-0000-4000-8000-000000000301"
updatedById*string

Last-updater user UUID.

Formatuuid
Example"10000000-0000-4000-8000-000000000301"
Example Request
curl -X GET 'https://your-goodmem-server.example.com/v1/admin/retrieve-memory-log-policies/40000000-0000-4000-8000-000000000301?includeDeleted=true' \  -H 'GoodMem-Timeout-Ms: 30000'
Example Response
{  "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"}