Orion API

Programmatic access to your Orion workspace jobs.

Authentication

All requests require a Bearer token. Generate one in Settings → API Keys.

curl https://orionstudio.ai/api/v1/jobs \
  -H "Authorization: Bearer orion_sk_your_key_here"

Rate Limits

100 requests per minute per API key.

Endpoints

GET/api/v1/jobsList jobs

Query params: ?status=queued&client_id=air-llc

curl https://orionstudio.ai/api/v1/jobs?status=queued \
  -H "Authorization: Bearer orion_sk_..."

# Response
{
  "jobs": [
    {
      "id": "uuid",
      "title": "Deploy landing page",
      "status": "queued",
      "client_id": "air-llc",
      "created_at": "2026-03-31T12:00:00Z"
    }
  ]
}
POST/api/v1/jobsCreate a job
curl -X POST https://orionstudio.ai/api/v1/jobs \
  -H "Authorization: Bearer orion_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"title": "Deploy landing page", "notes": "Use v2 design", "client_id": "air-llc"}'

# Response (201)
{
  "id": "uuid",
  "status": "queued",
  "created_at": "2026-03-31T12:00:00Z"
}
GET/api/v1/jobs/:idGet job details
curl https://orionstudio.ai/api/v1/jobs/JOB_UUID \
  -H "Authorization: Bearer orion_sk_..."

# Response
{
  "id": "uuid",
  "title": "Deploy landing page",
  "status": "working",
  "output_log": [...],
  "commit_sha": null,
  "created_at": "2026-03-31T12:00:00Z"
}
PATCH/api/v1/jobs/:idUpdate job status
curl -X PATCH https://orionstudio.ai/api/v1/jobs/JOB_UUID \
  -H "Authorization: Bearer orion_sk_..." \
  -H "Content-Type: application/json" \
  -d '{"status": "done", "notes": "Completed", "commit_sha": "abc123"}'

# Response
{
  "id": "uuid",
  "status": "done",
  "commit_sha": "abc123",
  "updated_at": "2026-03-31T12:05:00Z"
}

Orion Studio · Generate API Key