Version 2.4.7.20261116085428 · latest

My tickets my-tickets

Users submit, reply to, close, rate and reopen their own tickets.

Pick an endpoint to see its example call on the right.

TicketsAuthentication: User8 endpoints

Authentication

Send the X-API-Key header (create a key on the API Keys page; the key is shown only once at creation). An Authorization: Bearer token obtained by logging in also works.

X-API-Key

Authentication failures return 401; forbidden returns 403 (code such as insufficient_scope).

Conventions

Paging uses page (from 1) and page_size; sort with sort=field or sort=-field.

Times are RFC 3339 (UTC); amounts are in cents.

Writes return 200/201/204 on success; duplicates of a unique key return 409.

GET/api/v2/my-ticketsList my tickets

Authentication: User

Query parameters

FieldTypeDescription
pageinteger Page number, starting from 1
Default 1
page_sizeinteger Items per page
Default 20
statusstring Tab: open, replied or closed; omit for all.
Values ["open","replied","closed"]
qstring Search: digits match the ticket number exactly, otherwise a title substring.
categorystring Filter by category (site, cert, security, l4, billing, other); comma-separated for several.
site_idinteger Filter by the related site or forwarding rule id.
created_fromstring Created at or after.
created_tostring Created before.
POST/api/v2/my-ticketsSubmit a ticket

Authentication: User

Request body application/json

FieldTypeDescription
bodyRequiredstring Body, at most 2000 characters.
categoryRequiredstring Category: site, cert, security, l4, billing or other.
Values ["site","cert","security","l4","billing","other"]
image_idsinteger[] Image ids uploaded via POST /ticket-images, at most 5, unused and uploaded by the caller.
rel_idinteger Related object id; 0 for none.
titleRequiredstring Title, at most 60 characters.
urgentboolean Whether urgent.
POST/api/v2/my-tickets/{id}/closeClose as the user

Authentication: User

POST/api/v2/my-tickets/{id}/ratingRate a ticket

Authentication: User

Request body application/json

FieldTypeDescription
notestring Optional note, at most 500 characters.
ratingRequiredstring Rating: good, normal, bad, or empty if not rated.
Values ["","good","normal","bad"]
POST/api/v2/my-tickets/{id}/reopenReopen as the user

Authentication: User

POST/api/v2/my-tickets/{id}/repliesReply as the user

Authentication: User

Request body application/json

FieldTypeDescription
bodystring Body, at most 2000 characters.
image_idsinteger[] Image ids uploaded via POST /ticket-images, at most 5, unused and uploaded by the caller.
POST/api/v2/my-tickets/{id}/resolveMark as resolved

Authentication: User

Request body application/json

FieldTypeDescription
notestring Optional note, at most 500 characters.
ratingstring Rating: good, normal, bad, or empty if not rated.
Values ["","good","normal","bad"]

My tickets object

FieldTypeDescription
auto_close_atstring When the ticket will be auto-closed: set only while waiting for the user and auto-close is on (reply time plus the configured days, recomputed after settings change); otherwise empty.
bodyRequiredstring Body, at most 2000 characters.
can_rateboolean User side only: closed or awaiting confirmation, not rated and rating enabled (decides whether the resolve dialog shows the rating section).
can_reopenboolean User side only: closed and still within the reopen window.
categorystring Category: site, cert, security, l4, billing or other.
Values ["site","cert","security","l4","billing","other"]
close_reasonstring Close reason: user, staff or timeout; empty while not closed.
Values ["","user","staff","timeout"]
closed_atstring Time the ticket was closed; empty while open.
created_atstring Created at
created_by_adminboolean Submitted by an admin on the user's behalf; admin side only.
idinteger Ticket number.
image_idsinteger[] Image ids uploaded via POST /ticket-images, at most 5, unused and uploaded by the caller.
last_atstring Time of the last message or status change.
last_kindstring Sender of the last message: user, staff, or empty when none. The user-side list prefixes staff messages with a label.
Values ["","user","staff"]
last_snippetstring Snippet of the last user or staff message (whitespace collapsed, at most 80 characters, ellipsis when cut); internal notes and system rows excluded; empty when none.
messagesTicketMessage[] Messages by id ascending; the user side has no notes.
msg_countinteger Number of user and staff messages (including the initial description; internal notes and system rows excluded).
new_countinteger Messages from the other side after read_pos.
notestring Optional note, at most 500 characters.
ratingstring Rating: good, normal, bad, or empty if not rated.
Values ["","good","normal","bad"]
rating_enabledboolean User side only: the rating switch from ticket settings (when off, the resolve dialog hides the rating area).
rating_notestring Rating note.
read_posinteger This side's read position before opening (a message id).
rel_idinteger Related object id; 0 for none.
rel_namestring Related object name (snapshot at submit time).
rel_typestring Related object type: site, stream or empty.
Values ["","site","stream"]
reopen_untilstring User side only: when closed, the reopen deadline.
statusstring open, replied or closed.
Values ["open","replied","closed"]
tenant_idinteger Submitting user (tenant) id.
titlestring Title, at most 60 characters.
unreadinteger Messages from the other side not read yet.
urgentboolean Whether urgent.
userobject Submitting user; admin side only.
user_namestring Submitting user's name; admin side only.

Responses and errors

Success returns the resource JSON directly (HTTP 2xx); failures return application/problem+json (code, detail, plus errors on validation failures); lists carry items + total.

Success
{
  "id": 1,
  "name": "example"
}
List
{
  "items": [
    {
      "id": 1
    }
  ],
  "page": 1,
  "page_size": 20,
  "total": 1
}
Error
{
  "code": "validation_failed",
  "detail": "Invalid request parameters",
  "errors": [
    {
      "code": "required",
      "field": "/name",
      "message": "name is required"
    }
  ],
  "request_id": "0123456789abcdef",
  "status": 422,
  "title": "Unprocessable Entity",
  "type": "about:blank"
}
Get started

Try the live demo

Open the live demo, or contact us for a quote and the install command