Runtime — Stamn Docs

List connected agent hosts

Authorization

Authorization

Required

Bearer <token>

Privy JWT or API key (sk_...)

In: header

curl -X GET "https://api.stamn.com/v1/runtime/hosts" \
  -H "Authorization: Bearer <token>"

Connected agent hosts grouped by hostname

List files in a global scope via agent proxy

Authorization

Authorization

Required

Bearer <token>

Privy JWT or API key (sk_...)

In: header

Query Parameters

scope

Required

string

File scope (e.g. shared, plugins)

hostnamestring

Target host

curl -X GET "https://api.stamn.com/v1/runtime/files?scope=shared&hostname=agent-host-1" \
  -H "Authorization: Bearer <token>"

Read a global-scope file via agent proxy

Authorization

Authorization

Required

Bearer <token>

Privy JWT or API key (sk_...)

In: header

Query Parameters

scope

Required

string

File scope

path

Required

string

File path to read

hostnamestring

Target host

curl -X GET "https://api.stamn.com/v1/runtime/files/read?scope=shared&path=config%2Fsettings.json&hostname=agent-host-1" \
  -H "Authorization: Bearer <token>"

Write a global-scope file via agent proxy

Authorization

Authorization

Required

Bearer <token>

Privy JWT or API key (sk_...)

In: header

Request Body

application/jsonRequired

scope

Required

string

path

Required

string

content

Required

string

hostnamestring

Optional target host

curl -X PATCH "https://api.stamn.com/v1/runtime/files/write" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "scope": "shared",
    "path": "config/settings.json",
    "content": "{\"key\":\"value\"}",
    "hostname": "agent-host-1"
  }'

Read the OpenClaw config from a connected agent

Authorization

Authorization

Required

Bearer <token>

Privy JWT or API key (sk_...)

In: header

Query Parameters

hostnamestring

Target host

curl -X GET "https://api.stamn.com/v1/runtime/config?hostname=agent-host-1" \
  -H "Authorization: Bearer <token>"

Write the OpenClaw config to a connected agent

Authorization

Authorization

Required

Bearer <token>

Privy JWT or API key (sk_...)

In: header

Request Body

application/jsonRequired

content

Required

string

OpenClaw config JSON string

hostnamestring

Optional target host

curl -X PATCH "https://api.stamn.com/v1/runtime/config" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "{\"agent\":{\"name\":\"my-agent\"}}",
    "hostname": "agent-host-1"
  }'