Momentum Claw API

Provision and control cloud Linux desktops programmatically. A thin, white-labeled surface over the Momentum compute fleet.

Introduction

The Momentum Claw API lets you create, inspect, and tear down isolated Linux computers, and run code on them. Every request is JSON over HTTPS.

Authentication

All endpoints (except health) require a bearer token in the Authorization header. Request a key from your Momentum operator.

Authorization: Bearer mk_live_your_key_here

Keep your key secret. It can create billable computers. Never embed it in client-side code or commit it to source control.

Base URLs

The API is available on a dedicated host and under the app's /api/v1 path — they are equivalent.

Host	Example
`api.momentumclaw.app`	`https://api.momentumclaw.app/computers`
`momentumclaw.app/api/v1`	`https://momentumclaw.app/api/v1/computers`

Create a computer

POST/computers

Provisions a new Linux desktop. All body fields are optional.

Field	Type	Description
`name`	string	Display name. Auto-generated if omitted.
`ram`	number	RAM in GB.
`cpu`	number	vCPU count.
`disk_size_gb`	number	Disk size in GB.
`resolution`	string	e.g. `1280x720x24`.

# request
curl -X POST https://api.momentumclaw.app/computers \
  -H "Authorization: Bearer $MOMENTUM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"my-desktop"}'

// 201 Created
{
  "computer": {
    "id": "computer_abc123",
    "instance_id": "i-0f9…",
    "connection_url": "wss://www.orgo.ai/desktops/computer_abc123",
    "status": "starting"
  }
}

List computers

GET/computers

curl https://api.momentumclaw.app/computers \
  -H "Authorization: Bearer $MOMENTUM_API_KEY"

{ "computers": [ { "id": "computer_abc123", "status": "running" } ] }

Get a computer

GET/computers/{id}

curl https://api.momentumclaw.app/computers/computer_abc123 \
  -H "Authorization: Bearer $MOMENTUM_API_KEY"

Delete a computer

DELETE/computers/{id}

Idempotent — deleting an already-gone computer still returns success.

curl -X DELETE https://api.momentumclaw.app/computers/computer_abc123 \
  -H "Authorization: Bearer $MOMENTUM_API_KEY"

Run code

POST/computers/{id}/exec

Executes Python source on the desktop and returns its output.

Field	Type	Description
`code`	string required	Python source to run.
`timeout`	number	Seconds (default 60).

curl -X POST https://api.momentumclaw.app/computers/computer_abc123/exec \
  -H "Authorization: Bearer $MOMENTUM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"code":"print(1+1)"}'

{ "result": { "success": true, "output": "2\n" } }

Errors

Errors return a JSON body with an error code and a message.

Status	Meaning
`400`	Bad request — missing or invalid fields.
`401`	Missing or invalid API key.
`404`	Computer not found.
`502`	Upstream compute provider error.

Health

GET/health no auth

curl https://api.momentumclaw.app/health
// { "ok": true, "service": "momentumclaw-api", "version": "1" }

Momentum Claw API · v1 · Powered by the Momentum compute fleet.