API recipes

Before you start

Base URL — https://app.solya.app; endpoints live under /api/.

Auth — every request sends Authorization: Bearer solya_sa_… (a service-account token).

Envelope — write/action responses use { "success": true, "data": … } or { "success": false, "errorCode": … }. Branch on errorCode, not on the text. See Error codes.

Verify your token

A quick first call confirms the token resolves to the right organization and permissions.

cURL
Python
JavaScript

curl https://app.solya.app/api/auth/whoami \
  -H "Authorization: Bearer solya_sa_xxx"

import requests

BASE = "https://app.solya.app"
TOKEN = "solya_sa_xxx"
headers = {"Authorization": f"Bearer {TOKEN}"}

r = requests.get(f"{BASE}/api/auth/whoami", headers=headers)
r.raise_for_status()
print(r.json())  # { authKind, organizationId, effectivePermissions, ... }

const BASE = "https://app.solya.app"
const TOKEN = "solya_sa_xxx"
const headers = { Authorization: `Bearer ${TOKEN}` }

const res = await fetch(`${BASE}/api/auth/whoami`, { headers })
if (!res.ok) throw new Error(`whoami failed: ${res.status}`)
console.log(await res.json())

Prefer not to hand-write requests? Point an AI agent at the MCP gateway and it will discover and call these endpoints for you.

Read data

Create a plan

Before you start

Verify your token

Read data

Create a plan

​Before you start

​Verify your token

Before you start

Verify your token