# Machines: Real computers, leased by the org, for agents and for the software they ship — Hanzo AI

> Real computers, leased by the org, for agents and for the software they ship.

Hanzo OS

# Machines

Real computers, leased by the org, for agents and for the software they ship.

Lease a sandbox and run commands in it, launch a metered machine, or publish a function. Each is the org’s own and each is billed to it, so an agent that needs a computer asks for one the same way a person would.

## API

Operations on api.hanzo.ai. One key reaches every layer.

Method

Path

What it does

`POST`

`/v1/sandbox`

Leases a sandbox — a real computer — for the org.

`POST`

`/v1/sandbox/{id}/exec`

Runs one command in a sandbox and answers with its exit code, stdout and stderr.

`GET`

`/v1/compute/sizes`

Lists the machine sizes available to launch.

`POST`

`/v1/compute/machines`

Launches a metered machine, or prices one first with dryRun.

`POST`

`/v1/function`

Publishes a serverless function under the org.

`POST`

`/v1/function/{name}/invoke`

Runs a function and records the invocation.

## Try it

```
curl https://api.hanzo.ai/v1/sandbox \ -H "Authorization: Bearer $HANZO_API_KEY" \ -H "Content-Type: application/json" \ -d &#x27;{"class": "exec"}&#x27; curl https://api.hanzo.ai/v1/sandbox/$SANDBOX/exec \ -H "Authorization: Bearer $HANZO_API_KEY" \ -H "Content-Type: application/json" \ -d &#x27;{"argv": ["uname", "-a"]}&#x27;
```

## Docs

[Sandbox API](https://docs.hanzo.ai/docs/openapi/sandbox)[Visor API](https://docs.hanzo.ai/docs/openapi/visor)[Functions API](https://docs.hanzo.ai/docs/openapi/functions)

## On this site

[Machines](https://hanzo.ai/machines)[Visor](https://hanzo.ai/visor)[Functions](https://hanzo.ai/functions)[Edge](https://hanzo.ai/edge)[Registry](https://hanzo.ai/registry)[Operator](https://hanzo.ai/operator)[Ingress](https://hanzo.ai/ingress)[DNS](https://hanzo.ai/dns)[Tunnel](https://hanzo.ai/tunnel)[ZAP](https://hanzo.ai/zap)[PubSub](https://hanzo.ai/pubsub)[Stream](https://hanzo.ai/stream)[MQ](https://hanzo.ai/mq)

## The stack

- CompanyThe legal body: formation, cap table, documents and filings, as operations.
- AgentsWorkers the company keeps: a model, instructions, tools and a budget.
- ModelsEvery model behind one endpoint and one key.
- MemoryWhat the company knows, and when it knew it.
- IdentityWho is acting — a person, a program or an agent — and what it may reach.
- MachinesReal computers, leased by the org, for agents and for the software they ship.

[RecordEvery act on every layer, by a person or an agent, in one trail.](https://hanzo.ai/products/record)
