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

# Deployments

> Deployment endpoints have been replaced by agent upserts

The old deployment model is no longer part of the public API.

Use these current surfaces instead:

| Task                        | Current API                                         |
| --------------------------- | --------------------------------------------------- |
| Create or update an agent   | `POST /v1/agents`                                   |
| Link a sandbox-backed agent | Include `sandbox` and `executionMode: "in_sandbox"` |
| Run an agent                | `POST /v1/run`                                      |
| Deploy local definitions    | `runtools deploy`                                   |

```bash theme={null}
runtools init
runtools sandbox create --name build-runner --template base-ubuntu
runtools deploy
runtools agent run code-assistant "Run the tests"
```

```typescript theme={null}
const result = await rt.agent.run('code-assistant', 'Run the tests.', {
  stream: false,
});
```