ResQ Docs — Tactical OS for Autonomous Disaster Response

ResQ exposes two HTTPS APIs:

API	Base URL	Stack
Infrastructure API	`https://api.resq.software`	Rust + Axum
Coordination API	`https://coordination.resq.software`	TypeScript + Elysia

If you are running a self-hosted deployment, swap the base URLs above for your own. The request shapes are identical.

Steps

Confirm the service is up

Hit /health on the Infrastructure API. No auth required.

curl https://api.resq.software/health

const res = await fetch("https://api.resq.software/health");
console.log(await res.json());

import httpx
print(httpx.get("https://api.resq.software/health").json())

A healthy response looks like:

{
  "status": "ok",
  "pinata": true,
  "gemini": true,
  "spoon_os": "0.1.0"
}

Get a JWT

The Infrastructure API uses bearer JWTs. Trade credentials for a token at POST /login.

curl -X POST https://api.resq.software/login \
  -H "Content-Type: application/json" \
  -d '{"username":"YOUR_USERNAME","password":"YOUR_PASSWORD"}'

const res = await fetch("https://api.resq.software/login", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ username, password }),
});
const { token, expires_at } = await res.json();

The response carries a token and a Unix expiry:

{
  "token": "eyJhbGciOi...",
  "expires_at": 1746345600
}

Store the token securely. See Authentication for refresh and rotation guidance.

Call an authenticated endpoint

Send the token as a Bearer header.

curl https://api.resq.software/evidence \
  -H "Authorization: Bearer $RESQ_TOKEN"

const res = await fetch("https://api.resq.software/evidence", {
  headers: { Authorization: `Bearer ${token}` },
});

Stream telemetry from the Coordination API

The Coordination API exposes Prometheus metrics and Server-Sent Events for real-time fleet state.

curl -N https://coordination.resq.software/events

Each line is a JSON event: telemetry frames, mission state changes, and HITL approvals.

Pick an SDK

Skip writing a client — install one of the official SDKs instead.

TypeScript

@resq-systems/http, @resq-systems/security, UI components.

Python

resq-mcp (FastMCP server) and resq-dsa.

Rust

Unified resq CLI plus seven TUI tools.

.NET

Typed clients, Protobuf contracts, sim harnesses.

Authentication

JWT lifecycle, scopes, and rotation.

Errors

Error envelope and status codes.

API reference

Every endpoint, request, and response.

Start here

Releases

Quickstart

Steps

TypeScript

Python

Rust

.NET

Next

Authentication

Errors

API reference

​Steps

TypeScript

Python

Rust

.NET

​Next

Authentication

Errors

API reference

Steps

Next