Skip to main content
Welcome to the Senso Developer API!
The endpoints documented here let you ingest knowledge, search it with AI, and generate new content—all from your own code.

​
What you can do

• Upload raw text or files (PDF, DOCX, Markdown)
• Organise knowledge with categories and topics
• Ask natural-language questions and get cited answers (/search)
• Generate new text such as summaries or replies (/generate) Everything is exposed through a RESTful JSON API.

​
Base URL

https://sdk.senso.ai/api/v1

​
Authentication (API key)

Every request must include your organisation’s API key: 
X-API-Key: YOUR_API_KEY
See the dedicated “Authentication” page for details on creating and securing keys.

​
Content type

Most requests/​responses use JSON: 
Content-Type: application/json
Accept: application/json
multipart/form-data is used only when uploading or updating a file (/content/file).

​
Pagination

List endpoints share the same optional query parameters:
ParameterDefaultMaxNotes
limit10100items returned per page
offset0—items to skip (0-based)
Example:
GET /categories?limit=20&offset=40

​
Error model

All errors follow one shape: 
{
  "error": "Human-readable description"
}
Common HTTP codes: • 200 OK – success with body
• 201 Created – new resource written
• 202 Accepted – async processing started
• 204 No Content – success without body
• 400 Bad Request – malformed input
• 401 Unauthorized – missing / bad key
• 403 Forbidden – key lacks permission
• 404 Not Found – resource id unknown
• 409 Conflict – duplicate name, etc.
• 500 Internal Server Error

​
Using the reference

Each endpoint page includes:
  1. Method & path
  2. High-level summary
  3. Detailed description
  4. Parameters & schema links
  5. Copy-paste examples for cURL & JSON
Start by creating your taxonomy (/categories, /topics), then upload some content (/content) and try a quick question with /search. Happy building!