---
title: "The agent document"
description: "One JSON object with a kind discriminator that names everything about an agent."
url: https://docs.spinrun.ai/build/agent-document
markdown_url: https://docs.spinrun.ai/build/agent-document.md
---

# The agent document

`spinrun.agent/v1`: identity, where it lives, what it is, what it may touch, and how it is invoked. Every top-level section is required. The server fills in `id`, `slug`, `status` and `updated_at`; a document you create must omit `id` and `updated_at`.

<AgentFields />

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

## Related [#related]

* [Workflow document](https://docs.spinrun.ai/build/workflow-document.md)
* [Concurrency](https://docs.spinrun.ai/build/concurrency.md)