Skills

Validate a skill template (extract + warn on common mistakes)

Dry-run template validator. Returns extracted variables plus warnings about common mistakes (double-brace usage, unmatched braces).

Per the PRD lock (Q3): warn-only. We never block creation on warnings here — the user is the source of truth and a double-brace pattern is valid Jinja that voice's runtime may handle differently from skills.

Accepts two shapes:

  1. {"template": "Hello {name}"} — one string in, vars out.
  2. {"runtime_type": "llm", "llm_config": {...}} — full skill shape, scans every template field the matching runtime would use.
post/skills/validate

Request

  • Base URL: https://be.graph8.com/api/v1
  • URL: https://be.graph8.com/api/v1/skills/validate
  • Auth: HTTP bearer

Headers

Authorizationstring nullable
X-Target-Org-Idstring nullable

Request body

object required

Template validation payload. {template: str} or {runtime_type, llm_config|api_config}.

Response

Successful Response

object required

Changes

No recorded changes to this operation across all 2 revisions of this API.