> ## Documentation Index
> Fetch the complete documentation index at: https://darwin.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage

> [!NOTE]
>
> Private Builder preview. Production deployment, rollback execution, and production usage analytics are not connected.

Agent Builder has three operations: Build, Publish, and Manage. Use them inside
Navigator. Manage opens **Your agents**, where you can select an account agent,
continue a private device draft, or start from a built-in definition.

Use `POST /api/v3/manage` or the MCP `manage` tool with the same command:

| Action | Behavior | Scope |
| - | - | - |
| `list_agents` | List your saved agents; optional `offset`, pages of 50 | `builder:read` |
| `get_agent` | Read a `draftId`, its current definition, and recent revisions, release packages, and tests | `builder:read` |
| `create_update` | Copy `draftId` and `revision` into a new private revision; require `expectedRevision` | `builder:write` |
| `deployment_status` | Inspect an owned `draftId` and `releaseId`; currently returns `not-connected` | `builder:read` |
| `rollback` | Request rollback for an owned release; currently returns `not-connected` without changing anything | `builder:write` |

Send a stable `Idempotency-Key`. MCP wraps the request in `command` and
`idempotencyKey`. A stale `expectedRevision` returns a conflict; it never
overwrites a newer revision. Account access requires authentication.

Creating an update preserves existing release packages and the saved revision of
every test job. A prepared package is not a deployed agent. Management returns up
to 100 recent revisions, releases, and tests; authoring tests are not production
usage or customer billing analytics.

Choose [Build](https://darwin.so/docs/studio/build.md) to edit or test a draft and
[Publish](https://darwin.so/docs/studio/publish.md) to prepare its release. Built-in templates create
private copies; they do not grant access to the original service's permissions.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.