Docs · API preview

REST API preview

Public API shape for launch planning. The employee demo uses the in-app /api/evaluations route; production auth, SDKs, and hosted API endpoints are still being finalized.

# Authenticate curl https://api.ruqa.ai/v1/outcomes \ -H "Authorization: Bearer ruqa_live_..." # Or use the SDK import { RUQA } from "@ruqa/sdk" const client = new RUQA({ apiKey: process.env.RUQA_API_KEY }) const outcomes = await client.outcomes.list({ project_id: "p_2" })

GET · POST · PATCH

Outcomes

GET/v1/outcomesList outcomes (paginated, filterable by owner/project/status)

GET/v1/outcomes/:idGet one outcome with full chain (decisions, blockers, learnings)

POST/v1/outcomesCreate an outcome (most fields auto-fillable from signals)

PATCH/v1/outcomes/:id/reviewManager review (score, status, notes)

Prompt library

Harnesses

GET/v1/harnessesList harnesses (filter by category, owner, scope)

POST/v1/harnessesCreate a harness from a sandbox-validated prompt

POST/v1/harnesses/:id/promotePromote personal harness to company-wide

Multi-LLM eval

Sandbox

POST/v1/sandbox/runRun a prompt across {claude, gpt, gemini, llama}

GET/v1/sandbox/runs/:idFetch run with per-provider outputs + rubric scores

16 metaskills

Capability

GET/v1/capability/:user_idPer-user capability vector (16 metaskills, 0-100)

GET/v1/capability/teamTeam heatmap (averages + variance)

Synthesis

Reports

GET/v1/reports/daily/:user_idDaily report for a user (with synthesis source signals)

GET/v1/reports/weekly/:project_idWeekly project report (metric progress + outcomes)

SDK + Postman collection

TypeScript / Python SDKs. Postman collection mirrors every endpoint with example requests.

Get started