Previewing Draft Composition
Use the public beta skill preview route to inspect saved draft prompt composition before a model call.
POST /api/skills/:id/preview
Authorization: Bearer <accessToken or apiKey>
Content-Type: application/json
{
"organizationId": "<orgId>",
"skillVersionId": "<draftVersionId>",
"variables": { "message": "hello" }
}
This route is api_key_or_access_token. API keys need skills:read.
Use it when you want to:
- preview a saved draft version with variables
- inspect
renderedPrompt,compositionTrace, and missing-variable signals before execution - confirm prompt attachments resolve as expected before publishing