Build on Siya's Foundation

Comprehensive API documentation for integrating Siya into your applications, workflows, and tools. Whether you’re building extensions, automating tasks, or creating custom integrations, this reference provides everything you need.
The Siya API is currently in development. CLI and REST API access coming soon!

​
API Overview

Siya's API architecture enables powerful integrations

​
Desktop Integration APIs

Available Now: Desktop Automation

Integrate with Siya Desktop using native macOS technologies

Deep Linking Protocol

Control Siya through URL schemes from any application

URL Scheme Reference

​
Coming Soon: REST API

RESTful API Interface

Full-featured REST API for programmatic access (Coming Soon)
The REST API is currently in development. Expected release: Q1 2025

Planned REST API architecture

Planned Endpoints

​
Coming Soon: CLI

Command Line Interface

Powerful CLI for terminal workflows (Coming Soon)
The CLI is currently in development. Expected release: Q1 2025
# Install via Homebrew (macOS)
brew install siya-cli

# Install via npm
npm install -g @siya/cli

# Install via curl
curl -fsSL https://siya.com/install.sh | sh

​
Integration Examples

Real-World Integration Patterns

Examples of how to integrate Siya into your workflow

VS Code Extension

​
Webhooks & Events

Event-Driven Integration

Subscribe to Siya events for real-time integration (Coming Soon)
{
  "webhooks": {
    "endpoints": [
      {
        "url": "https://api.company.com/siya-webhook",
        "events": ["task.completed", "error.occurred"],
        "secret": "webhook_secret_key"
      }
    ],
    "retry": {
      "attempts": 3,
      "backoff": "exponential"
    }
  }
}

​
Rate Limits & Quotas

API Usage Limits

Understand rate limits and quotas for API usage

​
Error Handling

Robust Error Handling

Handle API errors gracefully
try {
    const response = await siya.chat.create({
        model: 'claude-opus-4',
        messages: messages
    });
} catch (error) {
    if (error.status === 429) {
        // Rate limit exceeded
        const retryAfter = error.headers['retry-after'];
        await sleep(retryAfter * 1000);
        // Retry request
    } else if (error.status === 401) {
        // Authentication failed
        await refreshToken();
    } else if (error.status >= 500) {
        // Server error - implement exponential backoff
        await retryWithBackoff(request);
    }
}

​
Best Practices

API Integration Best Practices

Follow these guidelines for robust integrations

Security

​
Summary

Build Amazing Integrations

Siya’s API ecosystem provides powerful integration capabilities, from simple URL schemes available today to the comprehensive REST API and CLI coming soon. Whether you’re automating workflows, building extensions, or creating custom integrations, Siya’s APIs give you the flexibility and power you need.

Get Started Today

Start with Desktop integration

Stay Updated

Join the developer newsletter
Build on Siya. Extend your capabilities. Create the future.