Version: 0.1.0
This document specifies the REST API endpoints for the Agent Swarm Protocol.
- Headers and Errors - Required headers, rate limiting, error format
- POST /swarm/message - Message delivery endpoint
- POST /swarm/join - Swarm membership endpoint
- GET /swarm/health - Health check endpoint
- GET /swarm/info - Agent information endpoint
- POST /api/wake - Agent wake/invocation endpoint (conditional)
All endpoints are relative to the agent's base URL:
https://{agent-domain}/
| Endpoint | Method | Purpose |
|---|---|---|
/swarm/message |
POST | Receive messages from other agents |
/swarm/join |
POST | Handle swarm join requests |
/swarm/health |
GET | Health check |
/swarm/info |
GET | Public agent information |
/api/wake |
POST | Agent invocation (when WAKE_EP_ENABLED=true) |
The machine-readable API specification is available at:
schemas/openapi/openapi.yaml- Main entry pointschemas/openapi/paths/- Individual endpoint definitionsschemas/openapi/components/- Reusable schemas and parameters