SwarmDoGPU API

A REST/JSON API for renting GPUs across providers behind one masked catalog. Everything the dashboard, CLI, SDK and MCP server do is this API. Base URL:

All request/response bodies are JSON. The backing provider (Vast, RunPod, partner hosts…) is never exposed to customers — offers, endpoints and instances are masked.

Authentication

Most endpoints require an authenticated account. Two credentials work interchangeably on data endpoints:

State-changing requests made with a session cookie are CSRF-checked (Origin must match Host); Bearer-key requests are exempt. Create/manage keys under Dashboard → Keys.

Errors & rate limits

Errors return the matching HTTP status with a JSON body { "error": "message" }. Common: 400 validation, 401 not signed in, 402 insufficient credit, 404 not found, 409 spend-cap/margin, 429 rate-limited, 502 upstream provider error. Auth, provisioning and payment routes are rate-limited per IP/action.

Catalog · 🌐 public

Accounts & auth · 🌐/🔑

Rentals

Telemetry & alerts · 🔑

Idle detection & auto-stop · 🔑

Billing · 🔑

SLA · 🔑

Reserved capacity · 🔑

Storage & datasets · 🔑

Serverless & models · 🔑

Invoking an endpoint. Send inference to the masked URL returned at deploy — https://gpu.swarmdo.com/run/<id>/<path> — authenticating with your swdo_ API key as a Bearer token. The gateway routes to the backing GPU provider (chosen for lowest cost, kept hidden) and meters usage. RunPod-backed endpoints accept the job path /runsync (body { "input": { … } }) and the OpenAI-compatible base /openai/v1 (e.g. use https://gpu.swarmdo.com/run/<id>/openai/v1 as your OpenAI base URL).

Managed models vs. serverless. Deploy a serverless endpoint when you need your own image, your own weights, or control over autoscaling — you pay per GPU-second the workers are active. Use a managed model when you just want inference: there is no endpoint, no worker, no cold start and no idle cost, and you are billed per unit of work (tokens for language models, seconds for video, per request otherwise). Billing is per successful call only — a failed call costs nothing. One practical note for reasoning models: their thinking counts as output tokens, so a small max_tokens can be consumed entirely by reasoning and return empty content — give them headroom. Both are masked identically: you never see which provider is behind either.

Debugging an endpoint. GET /api/serverless/endpoints/{id}/logs?limit=N returns recent masked lines (newest first) — every invoke the gateway handled, plus anything the container pushed. Remediation without leaving the platform: POST /{id}/purge-queue drops a wedged backlog, POST /{id}/restart bounces the workers. To get the container's own output — the stdout/stderr of your model server, which is where a failed load actually prints — pass startCmd at deploy (e.g. "python -u handler.py"): we run it wrapped so its output is streamed to your log endpoint as well as the console. It's opt-in because we won't override your image's start command uninvited, and it needs your real one. If the forwarder can't run or can't reach us, your worker is unaffected — it keeps serving and logging locally.

Custom domain (admin only). Map your own hostname to an endpoint so callers use https://api.yourco.com/… instead of the /run/<id> path. POST /api/serverless/endpoints/{id}/domains { domain } returns the DNS to publish (a CNAME to the platform host + a _swarmdo-verify TXT); POST /api/serverless/domains/{domId}/verify checks the TXT and activates it; DELETE /api/serverless/domains/{domId} removes it. Once active, requests arriving on that Host route straight to the endpoint (masked).

Builds — from GitHub · 🔑

On success the build's imageRef can be deployed straight to a serverless endpoint (POST /api/serverless/endpoints with that image). The backing builder is masked behind the platform.

Jobs & cache · 🔑

Squads (teams) · 🔑

Keys · secrets · account · 🔑

Host / supplier API · 🏷️

Independent providers list GPUs for resale. Authenticate with a supplier key (returned once at registration).

Operator · ⚙️

Admin-only, under /api/admin/*. Accepts an admin-role session or the x-admin-token. The operator console (/admin) is the UI for these — including toggling upstream providers on/off, markup rules, user management, provider reputation, host attestation, and user impersonation.

Client libraries — SDK · CLI · MCP

TypeScript SDK

CLI

MCP server (Claude Code / Desktop)

41 tools: catalog search and rentals, serverless deploy/scale/suspend/invoke, and the full diagnostic set — serverless_status, serverless_logs, serverless_purge_queue, serverless_restart — so an agent can resolve a stuck endpoint without you opening a provider console.

SwarmDoGPU API reference · base https://gpu.swarmdo.com · manage keys in the dashboard.