What you can do

Base URL

Authentication (API key)

Content type

Pagination

Error model

Using the reference

Introduction

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

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

Upload a tiny text snippet, then immediately query it with /search.

Hello-World Search

Upload any PDF and let /generate return a bullet-point summary.

One-Click PDF Summary

Stand up a complete Category & Topic hierarchy from one JSON blob.

Taxonomy Seed

Generate new copy, store it automatically, then fetch the saved item.

Save-As-You-Write Generator

List all content, filter by age, and bulk-delete the stale stuff.

Clean-Up Script

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

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

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


Parameter	Default	Max	Notes
limit	10	100	items returned per page
offset	0	—	items to skip (0-based)

API Documentation

categories

topics

content

search

generate

​What you can do

​Base URL

​Authentication (API key)

​Content type

​Pagination

​Error model

​Using the reference