GoodMemGoodMem
ReferenceAPIREST APIAccess Policy

Check effective authorization

POST /v1/access-policy:check: Evaluates 1 to 50 concrete operation-and-target checks under the authenticated caller's live authority and any API-key ceiling.

POST
/v1/access-policy:check

Evaluates 1 to 50 concrete operation-and-target checks under the authenticated caller's live authority and any API-key ceiling. Results are positional and advisory: missing targets and denied operations both return allowed=false, and every later resource request performs fresh authorization. Top-level creates and LIST_API_KEY target INSTANCE; CREATE_MEMORY and LIST_MEMORY target their parent SPACE; reads, mutations, proxy operations, and access-policy administration target concrete resources. LIST_RETRIEVE_MEMORY_LOG_POLICY is rejected because its current candidate-based list rule has no instance-wide preflight.

Authorization

ApiKeyAuth
headerx-api-key<token>

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

application/json
  1. body

Evaluates between 1 and 50 concrete authorization checks.

checks*array<>

Concrete checks evaluated in request order.

Items1 <= items <= 50

Response Body

Positional authorization decisions returned

application/json
  1. response

Positional advisory authorization results.

results*array<>

Results corresponding one-for-one with the request checks.

Example Request
curl -X POST 'https://your-goodmem-server.example.com/v1/access-policy:check' \  -H 'GoodMem-Timeout-Ms: 30000' \  -H 'Content-Type: application/json' \  -d '{  "checks": [    {      "target": {        "resourceId": "550e8400-e29b-41d4-a716-446655440000"      }    }  ]}'
Example Response
{  "results": [    {      "allowed": true    }  ]}