API Reference
Complete API documentation for the Sinas platform
Getting Started with the SINAS API
The SINAS API is RESTful and returns JSON responses. All API requests must be made over HTTPS and authenticated with JWT tokens or API keys.
curl https://api.sinas.io/api/v1/your-endpoint \
-H "Authorization: Bearer YOUR_JWT_TOKEN" \
-H "Content-Type: application/json"
Authentication & Authorization
Request OTP code for passwordless login
Verify OTP and receive JWT token
Create API key for programmatic access
List all API keys
Get current user information
AI Chat & Assistants
Create AI assistant with configurable provider and tools
List all assistants
Create new chat conversation
Send message to chat (non-streaming)
Send message to chat (streaming with SSE)
Functions
Create Python function with JSON schema validation
List all functions with filtering
View function version history
List function executions
View execution tree with nested calls
Webhooks
Create webhook endpoint
List all webhooks
Invoke webhook (triggers function execution)
Schedules
Create cron-based scheduled job
List all scheduled jobs
Update schedule configuration
Ontology System
Connect external database (PostgreSQL, Snowflake, BigQuery)
Create concept (entity type)
Create query with external or synced mode
Create custom query endpoint
Execute query endpoint with filters
Create record in self-managed concept
Documents
Create document folder
Create document with content
List documents with tag filtering
Generate AI description for document
Tagging System
Create tag definition with value type
Apply tag to resource
Create AI-powered auto-tagging rule
Run tagger on specific resource
Bulk tag all documents in folder
Email Management
Create Jinja2 email template
Create email inbox with webhook
Send email with template or direct content
List emails with filtering
Context Store
Create context entry for AI injection
List contexts by namespace
Update context value or relevance score
Users & Groups
List all users (admin only)
Create group
Add member to group
Set group permission
Request Logs
Query request logs from ClickHouse
Official SDKs
JavaScript / TypeScript
npm install @sinas/client
Python
pip install sinas-client
Go
go get github.com/sinas/sinas-go
Rust
cargo add sinas
Ready to Start Building?
Explore the full documentation and get your API keys