SEsenso
API Keys

Get an API key's KB scope

Returns the knowledge-base folder grants that restrict a key. An empty array means the key is unscoped and can query the entire knowledge base. Note an unknown or revoked key id also returns an empty array — this endpoint does not 404.

get/org/api-keys/{keyId}/kb-permissions

Request

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

Path parameters

keyIdstring uuid required

The API key's id.

Response

The key's KB folder grants (empty if unscoped).

node_idstring uuid required

The KB node the key is granted access to (typically a folder).

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

The access level granted on the node. Stored grants are viewer, editor, or owner; admin is computed for organization administrators rather than granted, so it is not returned by this endpoint.

Changes

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