Skip to main content
DELETE
Revoke access

Authorizations

Authorization
string
header
required

User session JWT or instance API key (iak_*). Send as Authorization: Bearer <token>.

Path Parameters

knowledgeBaseId
string
required

Knowledge base id. Legacy physical prefix vs_ (the kb_ rename is deferred).

Maximum string length: 128
Pattern: ^vs_[A-Za-z0-9-]+$
principalType
enum<string>
required

Type of access principal. agent is a first-class owner principal for conversation/agent-owned knowledge bases (§F-6); principal_id is then the agent id (or its service-account id).

Available options:
user,
group,
org,
agent
principalId
string
required

Identifier of the principal. For user, the user id; for group and org, the group/org slug or id resolvable by the platform.

Maximum string length: 128

Response

Revoked.

object
enum<string>
required
Available options:
knowledge_base.access_binding
deleted
enum<boolean>
required
Available options:
true