Open a ticket
POST/api/v1/support/tickets
Opens a ticket. body becomes the first message of the
conversation. A new ticket's status is open.
subjectandbodyare required (surrounding spaces are trimmed);subjectis at most 200 characters.typeissupport(the default),bug,featureorquestion.priorityislow,normal(the default),highorurgent.reporter_email,reporter_name,org_nameandurlare stored as sent, to tell the support team who to answer and where the problem was seen. They are optional.
Requires no scope.
Authorization
Request body required
subjectstring requiredbodystring requiredThe first message of the conversation.typestringprioritystringreporter_emailstringreporter_namestringorg_namestringurlstringThe page or resource the ticket is about.
Responses
201
The ticket was opened.
successbooleandataTicketShow Ticket properties
idstringorg_idstringuser_idstringWho opened the ticket — the person behind a personal key, or the organization key's own id.subjectstringtypestringstatusstringopenwhen new or after the caller replies. EvoHub support moves it topending,resolvedorclosed.prioritystringreporter_emailstringAs sent when the ticket was opened;""when it was not.reporter_namestringorg_namestringurlstringcreated_atstring (date-time)updated_atstring (date-time)
400
The body is not JSON (INVALID_JSON), or a field breaks a rule
(VALIDATION_ERROR; the message names it): subject or body
is missing or blank, type or priority is not one of the
allowed values, or subject is longer than 200 characters (this
one also carries details naming the field).
- Error
Show Error properties
successbooleanSent by Support; the gateway's own refusals leave it out.errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
- ValidationFailed
Show ValidationFailed properties
successbooleanerrorobject requiredcodestring requiredmessagestring requireddetailsarray of object requiredfieldstringmessagestring
request_idstring
401
No API key was sent, or it is unknown, revoked or expired (UNAUTHORIZED).
successbooleanSent by Support; the gateway's own refusals leave it out.errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
429
Too many requests (RATE_LIMITED). Wait for Retry-After seconds.
Retry-AfterintegerSeconds to wait before retrying.
successbooleanSent by Support; the gateway's own refusals leave it out.errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
500
Something went wrong on EvoHub's side (INTERNAL_ERROR). Retry later.
successbooleanSent by Support; the gateway's own refusals leave it out.errorobject requiredcodestring requiredmessagestring requiredrequest_idstring
Example request
curl -X POST 'https://evohub.io/api/v1/support/tickets' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
-d '{
"url": "https://evohub.io/oncall/integrations",
"body": "Alerts from our Prometheus integration arrive 5–10 minutes late\nsince about 07:30 UTC. Request id of one late delivery:\nreq_9a8b7c6d5e4f3a2b.\n",
"type": "bug",
"subject": "Webhook deliveries delayed since this morning",
"org_name": "Acme",
"priority": "high",
"reporter_name": "Dana Ops",
"reporter_email": "ops@acme.example"
}'
