Skip to content

Close a support ticket

POST /api/v2/support/tickets/{id}/actions/close

Closes a support ticket and returns the updated ticket. A closed ticket takes no replies until you reopen it with POST /api/v2/support/tickets/{id}/actions/reopen.

Abuse cases cannot be closed by the customer. They return 409 ticket_close_not_allowed. Reply in the ticket instead.

Authentication: An API key with the scope write:support. About keys and scopes

Request

Path parameters

idstringrequired
The ticket ID (tkt_…) or the ticket number.

Example

POST /api/v2/support/tickets/{id}/actions/close
curl -X POST "https://cloud.hostup.se/api/v2/support/tickets/tkt_01hxa3b4c5d6e7f8g9h0j1k2m3/actions/close" \
-H "Authorization: Bearer $HOSTUP_API_KEY" \
-H "Content-Type: application/json"

Responses

200 The ticket, now with status closed.

Response 200
{
"id": "tkt_01hxa3b4c5d6e7f8g9h0j1k2m3",
"number": "10001",
"subject": "Question about my domain",
"body": "I need help updating my domain nameservers.",
"status": "closed",
"priority": "low",
"departmentSlug": "domain-names",
"departmentName": "Domain names",
"createdAt": "2026-04-27T11:45:00.000Z",
"updatedAt": "2026-04-27T12:10:00.000Z",
"lastMessageAt": "2026-04-27T12:05:00.000Z",
"ccEmails": [],
"requesterName": "Jane Example",
"messageCount": 2,
"linkedServices": [
{
"serviceType": "domain",
"serviceId": "dom_01hxa3b4c5d6e7f8g9h0j1k2m3",
"serviceName": "example.com",
"details": {
"status": "Active",
"autoRenew": true
}
}
],
"attachments": [],
"messages": [
{
"id": "tmsg_01hxa3b4c5d6e7f8g9h0j1k2m4",
"ticketId": "tkt_01hxa3b4c5d6e7f8g9h0j1k2m3",
"sentAt": "2026-04-27T12:05:00.000Z",
"body": "We have checked the domain and replied with the next steps.",
"sender": "staff",
"senderName": "Support Team",
"encrypted": false,
"attachments": []
}
]
}
Response fields
idstring
numberstring
The ticket number shown to the customer, usually digits. The ticket ID is id.
subjectstring or null
bodystring or null
Present only on the ticket detail and on the create response.
statusstring
One of open, answered, customer_reply, in_progress, on_hold, closed, unknown.
prioritystring
One of low, medium, high, urgent, critical.
departmentSlugstring
departmentNamestring or null
createdAtstring or null
updatedAtstring or null
lastMessageAtstring or null
ccEmailsarray of string
requesterNamestring or null
messageCountinteger
linkedServicesarray of object
serviceTypestring
serviceIdstring or null
serviceNamestring or null
detailsobject or null
attachmentsarray of object
Present only on the ticket detail and on the create response.
idstring
filenamestring or null
extensionstring or null
mimeTypestring or null
downloadUrlstring
messagesarray of object
Present only on the ticket detail and on the create response.
idstring
ticketIdstring
sentAtstring or null
bodystring or null
senderstring
One of customer, staff, automation.
senderNamestring or null
encryptedboolean
attachmentsarray of object

Errors

Errors are Problem Details with a stable code. Branch on the code, not on the text.

400Invalid request. The response body is an RFC 7807 Problem Details document.
401Unauthorized. Authentication is required.
403code is forbidden. The ticket is not yours.
404code is ticket_not_found. No ticket has this ID.
409code is ticket_close_not_allowed. The ticket is an abuse case. Reply in the ticket instead.
429Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers.
500Internal error. Retry later or contact support if the issue persists.
502Upstream failure. A dependent provider request failed; the Problem Details code is upstream_failed. Retry later or contact support if the issue persists.