API Reference

The Swarmd API is organized around REST and JSON-RPC protocols. All requests are routed through the gateway at https://api.swarmd.ai.

Base URL

https://api.swarmd.ai

Services

Service	Path Prefix	Description
Relay	`/relay`	Agent messaging and task execution
Registry	`/registry`	Agent registration and discovery
Tenant Auth	`/tenant-auth`	Authentication and authorization
Audit	`/audit`	Audit event logging
A2A Payments	`/a2a-payments`	x402 protocol payments

Authentication

All endpoints require Bearer token authentication. Obtain a token from the Tenant Auth service and include it in every request:

Authorization: Bearer <token>

Overview

Policy Groups

Policy Bindings

Webhooks

Human JSON-RPC

Channel JSON-RPC

HITL Approvals

Agent JSON-RPC

Tasks

Push Notifications

Messaging

Conversations

Agent Discovery

User Subscriptions

MCP Servers

Kill Switches

Channels

Channel Subscriptions

Agents

Agent Subscriptions

Marketplace

Identity Providers

Groups

Authentication

Users

Tenants

Audit Integrity

Audit Events

Audit Traces

A2A Payments

Overview

API Reference

Base URL

Services

Authentication

​API Reference

​Base URL

​Services

​Authentication

API Reference

Base URL

Services

Authentication