Build agents and workflows as documents

The Build surface lets an MCP client, a script or the CLI read an agent or a workflow as one JSON document, change it, and put it back. This section is the whole contract.

• Endpoints: the two MCP endpoints and the REST twin.
• Authorization: why Build is OAuth-only.
• Agent document and workflow document: the contracts.
• Concurrency: updated_at and If-Match.
• Publishing: who publishes, and what applied means.
• Test runs: credits and polling.
• Untrusted output: treat run output as data.

A document is at most 64 KiB of UTF-8; anything larger is refused with 413 before it is parsed.

Related

• Getting started
• CLI
• REST API