Your First Run

A run executes a skill version with variables and persists telemetry, traces, and output in ai_runs (see listOrchestrationRuns / getOrchestrationRunDetail).

Minimal path

1. GET /api/skills?organizationId= — pick a skill id.
2. GET /api/skills/:id?organizationId= — inspect versions and choose a skillVersionId (or omit to let the server resolve a default in runPrompt).
3. POST /api/skills/:id/run with body { organizationId, skillVersionId?, variables } — user Bearer token required.

Success

JSON includes runId, output, usage, latencyMs per skillRunResponseSchema.

See also

• Run A Skill
• Run Object