Get started
API Reference
The complete public contract for RouteKite email, attachments, webhooks, and templates.
On this page
Base URL
All supported developer endpoints use this versioned base URL.
Base URL
const ROUTEKITE_API_URL = "https://routekite.com/api/v1";Supported endpoints
| Method | Path | Purpose |
|---|---|---|
| POST | /api/v1/emails | Send one transactional email. |
| POST | /api/v1/emails/batch | Send up to 100 independent emails. |
| GET | /api/v1/emails | List sent emails. |
| GET | /api/v1/emails/{messageId} | Retrieve normalized delivery state. |
| GET | /api/v1/emails/{messageId}/events | Retrieve the delivery timeline. |
| GET | /api/v1/emails/{messageId}/attachments | List email attachments. |
| GET | /api/v1/emails/{messageId}/attachments/{attachmentId} | Retrieve an email attachment and private download. |
| POST | /api/v1/attachments | Prepare a private upload. |
| GET | /api/v1/attachments/{attachmentId} | Retrieve attachment lifecycle state. |
| POST | /api/v1/attachments/{attachmentId}/complete | Validate uploaded bytes. |
| GET | /api/v1/webhooks | List webhook endpoints. |
| POST | /api/v1/webhooks | Create a webhook endpoint. |
| DELETE | /api/v1/webhooks/{webhookId} | Delete a webhook endpoint. |
| GET | /api/v1/webhooks/{webhookId}/deliveries | List delivery attempts. |
| GET | /api/v1/templates | List templates. |
| POST | /api/v1/templates | Create a template draft. |
| GET | /api/v1/templates/{templateId} | Retrieve a template and draft. |
| PATCH | /api/v1/templates/{templateId} | Update template metadata. |
| DELETE | /api/v1/templates/{templateId} | Delete a template. |
| PUT | /api/v1/templates/{templateId}/draft | Save a canonical draft revision. |
| POST | /api/v1/templates/{templateId}/publish | Publish a saved revision. |
| POST | /api/v1/templates/{templateId}/duplicate | Duplicate saved template content. |
| GET | /api/v1/templates/{templateId}/versions | List immutable versions. |
| GET | /api/v1/templates/{templateId}/versions/{versionId} | Retrieve an immutable version. |
Common behavior
- Authenticate with a Bearer API key.
- Use JSON for RouteKite request and response bodies.
- Store X-Request-Id for diagnostics.
- Honor Retry-After and RateLimit response headers.
- Treat only documented /api/v1 endpoints as supported contracts.
- Use the OpenAPI document for a machine-readable contract.