Fetches all categories along with their associated topics, providing a hierarchical view of your taxonomy structure for easier management and navigation


Get all categories with their topics

The timestamp when the category was created

The timestamp when the category was deleted, if applicable (null if not deleted)

Description of the category's purpose or contents

List of topics belonging to this category

The timestamp when the category was last updated

The unique identifier of the category this topic belongs to

The timestamp when the topic was deleted, if applicable (null if not deleted)

Description of the topic's purpose or contents

The timestamp when the topic was last updated

apiKeyAuth

All categories with their topics successfully retrieved

Unauthorized - Authentication credentials are missing or invalid

Forbidden - User does not have permission to list categories or topics

Internal server error - A server-side issue occurred

Developers

Senso is a single REST layer that sits between your data and your AI agents.  We act as the Context OS enabling developers to ingest raw content, spin up an agent-ready context window, and trigger actions anywhere—all via schema-safe JSON.

Introduction to the Senso SDK

Use Senso with AI agents through the Model Context Protocol

MCP Server

Point it at any docs/FAQ site and chat with the results in your terminal

Help-Center Crawler

Paste one blog URL—get a tweet thread, LinkedIn post, and email teaser back, all stored in Senso

Blog-to-Social Converter

Create your first content and search through it

Hello World

Upload and process PDF documents for intelligent search

PDF Document Processing

Create a comprehensive tax information system with categories and content

Building a Tax Knowledge Base

Generate new content from your existing knowledge base

Content Generation

Manage and clean up your content effectively

Content Cleanup

Create and manage prompts for AI interactions

Managing Prompts

Create and manage templates for structured content output

Managing Templates

Use prompts and templates to generate structured content from your knowledge base

Generate Content with Prompts

Introduction

Authentication

Data model

Retrieves a paginated list of all categories in the system, allowing you to view and manage high-level groupings such as "Mortgages"


List all categories

Creates a new category by specifying details such as name and description, enabling you to organize your content into custom high-level groups


Create a new category

Batch-create several categories and their associated topics in a single API call, streamlining large-scale taxonomy setup.


Create multiple categories and their topics in one request

Retrieve detailed information about a specific category using its unique identifier
Returns details including name, description, and creation/update history.


Get category details by ID

Modify the properties of an existing category, such as its name or description.


Update a category's details

Permanently deletes a category identified by its unique ID. This operation cannot be undone and will also delete all topics associated with the category.


Delete a category

Partially update a category's details

Get a list of all topics under a specific category, helping you manage and review sub-groupings within a category


List all topics in a category

Add a new topic to a specific category by providing relevant details, supporting granular organization of content


Create a new topic in a category

Batch-create several topics within a category in one request, improving efficiency for large updates


Create multiple topics in a category

Retrieve detailed information about a specific topic using its unique identifier


Get topic details by ID

Change the properties of an existing topic, such as its name or description


Update a topic's details

Remove a topic from a category, which may impact any content or queries associated with it


Delete a topic

Partially update a topic's details

Retrieve a list of all content items in the organization


List all content

Fetch detailed information about a specific content item using its unique identifier


Get content details by ID

Permanently remove a content item from your system


Delete content

Creates a new raw content item with the provided title, summary, and text in markdown format.


Create new raw text content

Updates an existing raw content item with new title, summary, text and tags


Update raw text content

Partially update raw text content

Upload and create a new content item from a file, such as PDF, DOCX, or TXT documents
The file size is limited to 20MB.


Create new file content

Replace or update the file associated with an existing content item
The file size is limited to 20MB.


Update file content

Replace or update the file associated with an existing content item
The file size is limited to 20MB if a new file is provided.


Partially update file content

Submit a natural language question to the system and receive an AI-generated answer based on your ingested content


Ask a question and get an answer

Use AI to generate new text (e.g., summaries, answers) based on your existing content repository


Generate text based on existing content

Use a pre-defined prompt and optional template to generate content based on your knowledge base.
This endpoint provides a governed way to generate content with consistent prompts.


Generate content using a saved prompt

Retrieves a paginated list of all templates in the organization for use with the generate endpoint


List all templates

Creates a new template for structured output generation


Create a new template

Retrieve detailed information about a specific template


Get template details by ID

Update all fields of an existing template


Update a template

Delete a template

Update specific fields of an existing template


Partially update a template

Retrieves a paginated list of all prompts in the organization for use with the generate endpoint


API Documentation

categories

topics

content

search

generate

templates

prompts

Get all categories with their topics

Authorizations

Response