Run A Skill

Route: POST /api/skills/:id/run

Auth: user Bearer token only. This public beta route is access_token_only.

Body

• organizationId (required)
• skillVersionId (optional)
• modelKey (optional)
• variables matching the skill version input contract

Implementation calls runPrompt(...) with the skill id from the path.

Response

The response matches skillRunResponseSchema and includes:

• runId
• output
• outputText
• validation
• diagnostic
• usage and model metadata

Public docs boundary

The current public docs stop at the skillRunResponseSchema response object.

Dedicated /api/runs* inspection, preview, and diff routes are implemented in the API, but they are not part of the current public docs surface.

See also

• Quickstart HTTP
• Run An Evaluation
• Public Boundary