Sign in

v1

latestOpenAPI 3.1.0BUSL-1.12026-07-1756132288.0 KB

Revoke a scope pattern from a principal for the given verbs (requires grant:manage over the pattern)

delete/api/v1/{context_id}/principals/{principal_id}/grants

Path parameters

context_idstring required

Spectron context id

principal_idstring required

Principal record-id key

Request body

pathstring required

A scope pattern: an exact node (org/apple/product/ipad) or a subtree (org/apple/* / /*).

verbsVerb[] required

Grant verbs to apply: any of memory:read|memory:write|memory:forget| scope:read|scope:create|scope:delete|grant:manage.

Response

Updated principal

displayNamestring required

Human-readable display name.

grantsGrants required

Per-verb scope pattern map. Keys are grant verbs in <noun>:<verb> form (memory:read, memory:write, memory:forget, scope:read, scope:create, scope:delete, grant:manage); values are arrays of scope patterns.

idstring required

Record-id key (e.g. alpha-bot).

kindstring required

Identity kind: human / agent / service / unknown.