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/v1

Endpoints

MethodPathDescription
POST/ticketsCreate a ticket
GET/ticketsList tickets
GET/tickets/:idGet ticket detail
PATCH/tickets/:idUpdate a ticket
POST/tickets/:id/messagesAdd a message
POST/emails/sendSend an email
POST/emails/previewPreview template
GET/email-templates/:key/schemaTemplate schema
POST/email-templates/importImport template file
POST/account/email-templates/importImport shared template
GET/articles/searchSearch articles

OpenAPI specification

The full OpenAPI 3.1 spec is available at:

https://helmdesk.dev/openapi.json

Use 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.