Developer
API Reference
Programmatically interact with your notebooks, sources, and conversations.
The API is currently in beta. Some endpoints may change in future releases.
Overview
The Onsomble API is a RESTful API that allows you to integrate Onsomble into your applications and workflows.
Base URL
https://api.onsomble.ai/apiQuick Reference
Notebooks
Create, list, and manage notebooks
Sources
Add and manage content sources
Conversations
Create chats and send messages
Getting Started
Get your API token
Generate a token from Settings → API Keys in your account.
Make your first request
Test authentication with a simple request.
Explore endpoints
Check out the endpoint documentation for each resource.
Authentication
All API requests require a Bearer token:
curl -H "Authorization: Bearer YOUR_TOKEN" \
https://api.onsomble.ai/api/notebooksGenerate an API token from your account settings at Settings → API Keys.
Rate Limits
| Limit | Threshold |
|---|---|
| Per minute | 100 requests |
| Per hour | 1,000 requests |
| Per day | 10,000 requests |
Rate limit headers are included in all responses.
SDKs
Official SDKs for JavaScript, Python, and other languages are in development.