> ## Documentation Index
> Fetch the complete documentation index at: https://docs.swarmd.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Swarmd API reference overview

# 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>
```