Docs › Reference
All endpoints
Every public endpoint at a glance.
Base URL: https://api.trydragonfly.com. The exact schemas are in the OpenAPI spec.
Access
| Method | Path | Auth | Description |
|---|---|---|---|
POST | /v1/signup | none | Apply for an account; sandbox: true returns a test key instantly. |
GET | /v1/signup/{applicationId} | X-Signup-Token | Poll an application; returns the key once after approval. |
Orders
| Method | Path | Description |
|---|---|---|
POST | /v1/orders | Create an order. |
GET | /v1/orders/{externalId} | Order status. |
POST | /v1/orders/{externalId}/cancel | Cancel before pickup. |
Webhooks
| Method | Path | Description |
|---|---|---|
GET | /v1/webhooks/events | Event catalog. |
GET | /v1/webhooks | List endpoints. |
POST | /v1/webhooks | Create an endpoint. |
PATCH | /v1/webhooks/{id} | Update or re-enable an endpoint. |
DELETE | /v1/webhooks/{id} | Delete an endpoint. |
GET | /v1/webhooks/{id}/deliveries | Delivery attempts. |
POST | /v1/webhooks/{id}/test | Send a test event. |
Discovery (no auth)
| Path | Description |
|---|---|
/v1 | JSON index of these resources. |
/v1/docs | Guide (markdown; ?format=html for a styled page). |
/v1/openapi.json | OpenAPI 3.1 spec. |
/v1/reference | Interactive reference. |
/llms.txt | Map for LLM agents. |
/v1/mcp | MCP server download. |
/v1/cli | CLI download. |
Something unclear or missing? Tell us.