Recipes
Step-by-step recipes for the most common Spec0 platform tasks. Each recipe declares its prerequisites and links to the recipes you need first.
Concept pages explain what something is. Recipes show exactly how to do one task end-to-end — copy-pasteable steps, no concept dump, no detours.
Each recipe is self-contained on the page but states its prerequisites up front. If a step says "you need an existing team", that's a link to the Create a team recipe. Work backward from your goal; the chain takes you to the start.
Where recipes live
Spec0's docs use per-product recipe sections:
- Platform recipes — what you're on. Tasks done in the dashboard or against the platform's REST surface. Account setup, teams, tokens, subscribers, mock servers configured via the platform UI.
- CLI recipes — tasks done with
spec0from your terminal, a CI runner, or an AI agent. - Mock server how-to — tasks specific to operating a Spec0 mock server.
Cross-product recipes (for example, use the CLI in CI — which needs a SAT minted from the platform plus the CLI binary set up in CI) live in the section that matches the user's entry point. A user starting in a terminal goes to CLI recipes; they'll see a prerequisite link that bounces them here to mint the SAT.
Available recipes
| Recipe | What it gets you | Prerequisites |
|---|---|---|
| Create a team and add members | A team in your org with at least one Team Admin, ready to own APIs and mint tokens. | A Spec0 organisation (created at sign-up). |
| Issue a Service Account Token (SAT) for a team | A team-scoped token suitable for CI runners and AI agents, with the scopes you choose. | A team you can administer (see Create a team). |
More recipes will appear here as new ones are written. If a task you need is missing, open an issue — recipes are cheap to add and the gaps you hit are the gaps every customer hits.