GoodMemGoodMem
ReferenceAPIREST APIAccess Policy

List scoped role assignments

GET /v1/access-policy/role-assignments: Lists assignments attached to one required INSTANCE or SPACE boundary after requiring MANAGE_ACCESS. Continuation tokens are bound to the caller and filters.

GET
/v1/access-policy/role-assignments

Lists assignments attached to one required INSTANCE or SPACE boundary after requiring MANAGE_ACCESS. Continuation tokens are bound to the caller and filters.

Authorization

ApiKeyAuth
headerx-api-key<token>

Query Parameters

resourceKind*string

Required INSTANCE or SPACE kind

Value in"INSTANCE""SPACE"
resourceId?string

Required space UUID; omitted for INSTANCE

includeRevoked?boolean

Include revoked history

Defaultfalse
maxResults?integer

Page size; 0 or omission uses the default of 50, maximum 1,000

Formatint32
Default50
nextToken?string

Opaque continuation 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

Response Body

Role-assignment page returned

application/json
  1. response

One page of scoped role assignments.

roleAssignments*array<>

Role assignments in stable assignment order.

nextToken?|

Opaque continuation token, omitted on the final page.

Example Request
curl -X GET 'https://your-goodmem-server.example.com/v1/access-policy/role-assignments?resourceKind=SPACE&resourceId=550e8400-e29b-41d4-a716-446655440000&includeRevoked=true&maxResults=100' \  -H 'GoodMem-Timeout-Ms: 30000'
Example Response
{  "roleAssignments": [    {      "roleAssignmentId": "9f75bfdf-6c08-4ccc-b945-8688d91ef25d",      "principalId": "70e025f6-76ca-4cbe-b8fc-7dab8e84590a",      "assignedResource": {        "resourceId": "550e8400-e29b-41d4-a716-446655440000"      },      "assignedById": "114ad558-323d-4b76-85b8-37af103b8650",      "revokedById": "ab882e21-ea3f-4c29-9040-49be3cc93162"    }  ],  "nextToken": "string"}