---
title: "The workflow document"
description: "A slug you choose, inputs with defaults, an optional schedule, and one to ten steps."
url: https://docs.spinrun.ai/build/workflow-document
markdown_url: https://docs.spinrun.ai/build/workflow-document.md
---

# The workflow document

`spinrun.workflow/v1`: a `slug` you choose (it cannot change afterwards), `inputs` with optional defaults, an optional `schedule`, and one to ten `steps`. A step is either a `tool` call or an `agent` prompt; `after` names the steps it waits for.

<WorkflowFields />

Full JSON Schema: [/schemas/workflow-v1.json](https://docs.spinrun.ai/schemas/workflow-v1.json).

## Related [#related]

* [Agent document](https://docs.spinrun.ai/build/agent-document.md)
* [Test runs](https://docs.spinrun.ai/build/test-runs.md)