Documentation

API reference

Orchestrator base URL: https://runlayer-y9kc.onrender.com

Auth

Endpoints

GET  /v1/auth/nonce?address=0x…
GET  /v1/auth/lookup?address=0x…
POST /v1/auth/sign-in
POST /v1/onboarding
GET  /v1/workspaces/me          (Bearer JWT)

Agents & runs

Endpoints

GET  /v1/agents                 (Bearer)
POST /v1/agents                 (Bearer)
GET  /v1/runs                     (Bearer)
GET  /v1/runs/:id                 (Bearer)
POST /v1/runs                     (Bearer, rate limited)

Billing

Endpoints

GET  /v1/billing/balance        (Bearer)
GET  /v1/billing/contracts      (public)
POST /v1/billing/topup          (Bearer + x-dev-billing-secret)

Network

Endpoints

GET  /v1/network                (Bearer)

Keys

Endpoints

GET  /v1/keys                     (Bearer)
POST /v1/keys                     (Bearer)
DELETE /v1/keys/:id               (Bearer)

Health

GET /health — service status and feature flags (vault indexer, Groq).

Idempotency

Run ids are server-generated. Integrators should treat network retries as new runs unless you add your own idempotency key layer above the API.