Skip to main content
POST
/
tickets
/
{ticketId}
/
status
Change ticket status
curl --request POST \
  --url https://api.series.hr/tickets/{ticketId}/status \
  --header 'Content-Type: application/json' \
  --header 'apikey: <api-key>' \
  --data '
{
  "staffUserId": 123
}
'
Requires Premium or Enterprise subscription

Overview

Update the status of a ticket. Available statuses: open, in-progress, resolved, closed. Important Notes:
  • A system message is automatically added when the status changes
  • Common transitions: open → in-progress → resolved → closed
  • Tickets can be reopened from closed/resolved status

Path Parameters

ticketId
string
required
Ticket ID

Request Body

status
string
required
New status: open, in-progress, resolved, closed
staffUserId
integer
required
UserId of the staff member changing the status

Response

success
boolean
Whether the request was successful
data
object

Example

curl -X POST "https://api.series.hr/tickets/TICKET-1234567890-ABCD/status" \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "resolved",
    "staffUserId": 987654321
  }'

Response Example

{
  "success": true,
  "data": {
    "message": "Status changed to resolved"
  }
}

Error Responses

{
  "success": false,
  "error": {
    "code": 400,
    "message": "Invalid status. Must be one of: open, in-progress, resolved, closed"
  }
}
{
  "success": false,
  "error": {
    "code": 403,
    "message": "Tickets module requires a Premium or Enterprise subscription"
  }
}
{
  "success": false,
  "error": {
    "code": 404,
    "message": "Ticket not found"
  }
}

Rate Limit

25 requests per second per API key

Authorizations

apikey
string
header
required

Pass your API key in the apikey header. Alternatively, the x-api-key header is also accepted.

Path Parameters

ticketId
string
required

Ticket ID

Body

application/json
status
enum<string>
required

New status

Available options:
open,
in-progress,
resolved,
closed
staffUserId
integer
required

UserId of the staff member

Response

Status changed successfully