SEsenso
Knowledge Base

Grant access to a node

Grants a user or group viewer or editor access to a knowledge base node. Use PATCH to change an existing grant's role.

post/org/kb/nodes/{id}/permissions

Request

  • Base URL
    https://apiv2.senso.ai/api/v1
  • Auth
    API key in header X-API-Key

Path parameters

idstring uuid required

The node's kb_node_id.

Request body

grantee_type'user' | 'group' required

Whether the grantee is a user or a group.

grantee_idstring uuid required

The user id or group id to grant access to.

role'viewer' | 'editor' required

Access level to grant. Only viewer and editor can be granted here; owner is reserved and rejected with 400.

Response

The created access grant.

idstring uuid required

Unique identifier of the grant.

node_idstring uuid required

The node this grant applies to.

role'viewer' | 'editor' | 'owner' required

The access level this grant confers.

granted_atstring date-time required

When the grant was created.

Changes

No recorded changes to this operation across all 1 revision of this API.