REST API
The Helmdesk REST API uses standard HTTP methods and returns JSON. All endpoints require Bearer token authentication.
Base URL
https://helmdesk.dev/api/v1Endpoints
| Method | Path | Description |
|---|---|---|
POST | /tickets | Create a ticket |
GET | /tickets | List tickets |
GET | /tickets/:id | Get ticket detail |
PATCH | /tickets/:id | Update a ticket |
POST | /tickets/:id/messages | Add a message |
POST | /emails/send | Send an email |
POST | /emails/preview | Preview template |
GET | /email-templates/:key/schema | Template schema |
POST | /email-templates/import | Import template file |
POST | /account/email-templates/import | Import shared template |
GET | /articles/search | Search articles |
OpenAPI specification
The full OpenAPI 3.1 spec is available at:
https://helmdesk.dev/openapi.jsonUse it to generate clients in any language, import into Postman, or integrate with API documentation tools.
For detailed request/response examples, see the resource-specific docs: Tickets, Emails, Articles.