Support

Tickets and replies.

Base URL:https://sourhost.net/api/v1·Auth: Authorization: Bearer sh_live_…

GET/support/tickets— My tickets GET/support/tickets/:id— A ticket with its messages POST/support/tickets— Open a ticket POST/support/tickets/:id/messages— Reply in a ticket

GET/support/tickets

My tickets

Scope: support:read

Example request

curl "https://sourhost.net/api/v1/support/tickets" \
  -H "Authorization: Bearer $SOURHOST_TOKEN"

Response

204 Empty response

GET/support/tickets/:id

A ticket with its messages

Scope: support:read

Parameters

idrequired path · string Project number (from GET /projects), or ticket number

Example request

curl "https://sourhost.net/api/v1/support/tickets/12" \
  -H "Authorization: Bearer $SOURHOST_TOKEN"

Response

204 Empty response

POST/support/tickets

Open a ticket

Form fields, not JSON.

Scope: support:write

Parameters

`subject`required	body · string	Subject
`message`required	body · string	Text
`department`	body · string	tech, billing, general or transfer
`serviceId`	body · string	The service it is about

Example request

curl -X POST "https://sourhost.net/api/v1/support/tickets" \
  -H "Authorization: Bearer $SOURHOST_TOKEN" \
  --data-urlencode "subject=Сервер не стартует" \
  --data-urlencode "message=После обновления сервер сразу падает." \
  --data-urlencode "department=tech" \
  --data-urlencode "serviceId=34"

Response

201 Success

POST/support/tickets/:id/messages

Reply in a ticket

Scope: support:write

Parameters

idrequired path · string Project number (from GET /projects), or ticket number

Example request

curl -X POST "https://sourhost.net/api/v1/support/tickets/12/messages" \
  -H "Authorization: Bearer $SOURHOST_TOKEN" \
  --data-urlencode "text=Спасибо, заработало!"

Response

204 Empty response

Common errors

Any method can answer with these. More on errors

400	`bad_request`	Invalid body or parameters
401	`token_invalid`	The token is wrong, revoked or expired
403	`token_scope_missing`	The token lacks the scope
403	`token_project_forbidden`	The project or service is outside the token’s limits
404	`not_found`	No such project, service or object
429	`token_rate_limited`	Too many requests, see Retry-After
503	`upstream_unavailable`	The panel or node didn't answer — retry later