Knowledge Base

Create a folder

Creates a folder in the knowledge base. Omit parent_id (or set it to null) to create the folder under the root.

post/org/kb/folders

Request

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

Request body

namestring required
parent_idstring uuid nullable

The parent folder's id. Omit or null to create under the root.

Response

The created folder.

kb_node_idstring uuid required

Unique identifier for this document or folder. Use it in the /org/kb/nodes/{id}/… endpoints.

org_idstring uuid required
parent_idstring uuid nullable required

The parent folder's id, or null for the root folder.

content_idstring uuid

The backing content item's id (document nodes only).

type'folder' | 'content' required

folder or content (a document).

namestring required

Display name of the document or folder.

effective_role'viewer' | 'editor' | 'owner' | 'admin'

The caller's access level on this node — viewer, editor, owner, or admin (org-admin bypass). Absent where not computed.

is_publicboolean required

Whether the node is publicly accessible.

is_public_rootboolean required

Whether the node is the root of a public share.

created_bystring uuid

The user who created the node, if recorded.

created_atstring date-time required
updated_atstring date-time required

Changes

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