Skip to content

API Guide

Every parameter for every tool. Authoritative source.

The canonical reference lives in the repository so that the running server can serve it via /skill and LLM agents can read it directly:

skill/references/api-guide.md

It’s kept in the repo (and shipped inside the Docker image at /ORKESTRA_SKILL.md) so that there’s exactly one source of truth. This page intentionally doesn’t duplicate the content — duplication is how docs go stale.

  • Required vs optional parameters for every tool
  • Default values
  • Return shape for each tool (single ticket, array, board, error)
  • Validation rules (e.g. exec_order uniqueness within a parent)
  • Concrete TOON output examples