GoodMemGoodMem
ReferenceAPIREST APIAccess Policy

Get a scoped role assignment

GET /v1/access-policy/role-assignments/{id}: Reads one live assignment, or one revoked historical assignment when includeRevoked is true, after requiring MANAGE_ACCESS on its policy target.

GET
/v1/access-policy/role-assignments/{id}

Reads one live assignment, or one revoked historical assignment when includeRevoked is true, after requiring MANAGE_ACCESS on its policy target.

Authorization

ApiKeyAuth
headerx-api-key<token>

Path Parameters

id*string

Role-assignment UUID

Query Parameters

includeRevoked?boolean

Include a revoked historical row

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

Role assignment returned

application/json
  1. response

Current or historical scoped role assignment.

roleAssignmentId*string

Durable role-assignment UUID.

Formatuuid
Example"9f75bfdf-6c08-4ccc-b945-8688d91ef25d"
principalId*string

Assigned principal UUID.

Formatuuid
Example"70e025f6-76ca-4cbe-b8fc-7dab8e84590a"
role*Role

Code-defined assigned role.

Value in"ROOT""ADMIN""USER""SPACE_VIEWER""SPACE_CONTRIBUTOR""SPACE_CONTENT_MANAGER""SPACE_ADMIN"
assignedResource*

INSTANCE or SPACE assignment boundary.

assignedAt*integer

Assignment time in epoch milliseconds.

Formatint64
assignedById*string

Exact audit actor that assigned the role.

Formatuuid
Example"114ad558-323d-4b76-85b8-37af103b8650"
revokedAt?|

Revocation time in epoch milliseconds, when revoked.

Formatint64
revokedById?|

Exact audit actor that revoked the assignment, when revoked.

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