Core Resources

Support

Interact with the Serverista support system to create and track support tickets.

Update ticket status

Updates a ticket status

Accepts: application/json
Returns: application/json

Parameters

URL Params
id
string
Ticket id
Request Body
body
UpdateTicketRequest
Reference Type: UpdateTicketRequest

Status update payload

Response

object of GenericResponse

Reference Type:  GenericResponse

success
boolean
Indicates whether the operation was successful.
example: true
message
string
A human-readable message describing the result of the operation.
example: User created successfully.
POST /v1/tickets/:id/status
curl -X POST https://api.serverista.com/v1/tickets/:id/status \
  -H "Authorization: ApiKey YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d ''
Response

{
  "message": "example_message",
  "success": true
}

List tickets

List all tickets in current account

Accepts: application/json
Returns: application/json

Parameters

no parameters


Response

array of Ticket

Reference Type:  Ticket

account_id
integer
Identifier of the account that owns this ticket.
example: 5
case_id
string
Unique case identifier, typically auto-generated.
example: CASE-5-0001
files
array of Attachment
Reference Type: Attachment

List of file attachments associated with this ticket.
id
integer
Unique identifier of the ticket.
example: 101
replies
array of Reply
Reference Type: Reply

List of replies associated with this ticket.
subject
string
Subject or title of the support ticket.
example: Cannot access my server
user_id
integer
Identifier of the user who created the ticket.
example: 42
content
string
Detailed description or content of the issue.
example: I tried to connect to my server via SSH but it keeps timing out.
created_at
string
Timestamp when the ticket was created.
example: 2025-11-01T12:30:00Z
status
string
Current status of the ticket (e.g., open, closed).
example: open
updated_at
string
Timestamp when the ticket was last updated.
example: 2025-11-01T14:45:00Z
GET /v1/tickets
curl -X GET https://api.serverista.com/v1/tickets \
  -H "Authorization: ApiKey YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d ''
Response
[
{
  "account_id": 123,
  "case_id": "example_case_id",
  "content": "example_content",
  "created_at": "example_created_at",
  "files": [
    {
      "...": null
    }
  ],
  "id": 123,
  "replies": [
    {
      "...": null
    }
  ],
  "status": "example_status",
  "subject": "example_subject",
  "updated_at": "example_updated_at",
  "user_id": 123
}
]

Create a new support ticket

Creates a new support ticket for the authenticated user within the specified account.

Accepts: multipart/form-data
Returns: application/json

Parameters

Request Body
subject
string
Subject of the support ticket
content
string
Content or description of the issue
attachments
file
Optional file attachments (max total size 2MB)

Response

object of Ticket

Reference Type:  Ticket

subject
string
Subject or title of the support ticket.
example: Cannot access my server
content
string
Detailed description or content of the issue.
example: I tried to connect to my server via SSH but it keeps timing out.
created_at
string
Timestamp when the ticket was created.
example: 2025-11-01T12:30:00Z
files
array of Attachment
Reference Type: Attachment

List of file attachments associated with this ticket.
updated_at
string
Timestamp when the ticket was last updated.
example: 2025-11-01T14:45:00Z
user_id
integer
Identifier of the user who created the ticket.
example: 42
account_id
integer
Identifier of the account that owns this ticket.
example: 5
case_id
string
Unique case identifier, typically auto-generated.
example: CASE-5-0001
id
integer
Unique identifier of the ticket.
example: 101
replies
array of Reply
Reference Type: Reply

List of replies associated with this ticket.
status
string
Current status of the ticket (e.g., open, closed).
example: open
POST /v1/tickets
curl -X POST https://api.serverista.com/v1/tickets \
  -H "Authorization: ApiKey YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d ''
Response

{
  "account_id": 123,
  "case_id": "example_case_id",
  "content": "example_content",
  "created_at": "example_created_at",
  "files": [
    {
      "...": null
    }
  ],
  "id": 123,
  "replies": [
    {
      "...": null
    }
  ],
  "status": "example_status",
  "subject": "example_subject",
  "updated_at": "example_updated_at",
  "user_id": 123
}

Get ticket

Get a ticket by id

Accepts: application/json
Returns: application/json

Parameters

URL Params
id
string
Ticket id

Response

object of Ticket

Reference Type:  Ticket

account_id
integer
Identifier of the account that owns this ticket.
example: 5
case_id
string
Unique case identifier, typically auto-generated.
example: CASE-5-0001
content
string
Detailed description or content of the issue.
example: I tried to connect to my server via SSH but it keeps timing out.
created_at
string
Timestamp when the ticket was created.
example: 2025-11-01T12:30:00Z
replies
array of Reply
Reference Type: Reply

List of replies associated with this ticket.
user_id
integer
Identifier of the user who created the ticket.
example: 42
files
array of Attachment
Reference Type: Attachment

List of file attachments associated with this ticket.
id
integer
Unique identifier of the ticket.
example: 101
status
string
Current status of the ticket (e.g., open, closed).
example: open
subject
string
Subject or title of the support ticket.
example: Cannot access my server
updated_at
string
Timestamp when the ticket was last updated.
example: 2025-11-01T14:45:00Z
GET /v1/tickets/:id
curl -X GET https://api.serverista.com/v1/tickets/:id \
  -H "Authorization: ApiKey YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d ''
Response

{
  "account_id": 123,
  "case_id": "example_case_id",
  "content": "example_content",
  "created_at": "example_created_at",
  "files": [
    {
      "...": null
    }
  ],
  "id": 123,
  "replies": [
    {
      "...": null
    }
  ],
  "status": "example_status",
  "subject": "example_subject",
  "updated_at": "example_updated_at",
  "user_id": 123
}

Reply to ticket

Reply to a ticket

Accepts: multipart/form-data
Returns: application/json

Parameters

URL Params
id
string
Ticket id
Request Body
content
string
Content or description of reply
attachments
file
Optional file attachments (max total size 2MB)

Response

object of Reply

Reference Type:  Reply

ticket_id
integer
Identifier of the parent ticket.
example: 101
user
object of User
Reference Type: User

User details of the reply author.
user_id
integer
Identifier of the user who created the reply.
example: 42
account_id
integer
Identifier of the account associated with this reply.
example: 5
content
string
Content or message of the reply.
example: Please try rebooting your VM and check if the issue persists.
created_at
string
Timestamp when the reply was created.
example: 2025-11-01T13:00:00Z
files
array of Attachment
Reference Type: Attachment

List of file attachments associated with this reply.
id
integer
Unique identifier of the reply.
example: 202
POST /v1/tickets/:id/replies
curl -X POST https://api.serverista.com/v1/tickets/:id/replies \
  -H "Authorization: ApiKey YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d ''
Response

{
  "account_id": 123,
  "content": "example_content",
  "created_at": "example_created_at",
  "files": [
    {
      "...": null
    }
  ],
  "id": 123,
  "ticket_id": 123,
  "user": {
    "...": null
  },
  "user_id": 123
}