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

​
Overview

Transfer a ticket to a different department. This automatically unclaims the ticket. Important Notes:
  • The ticket is moved to the new department
  • The ticket is automatically unclaimed
  • System messages are added for transfer and unclaim actions
  • The new department must be configured to handle the ticket’s category

​
Path Parameters

​
ticketId
string
required
Ticket ID

​
Request Body

​
departmentId
string
required
ID of the target department
​
staffUserId
integer
required
UserId of the staff member transferring the ticket

​
Response

​
success
boolean
Whether the request was successful
​
data
object

​
Example

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

​
Response Example

{
  "success": true,
  "data": {
    "message": "Ticket transferred to Moderation Department"
  }
}

​
Error Responses

{
  "success": false,
  "error": {
    "code": 404,
    "message": "Department not found"
  }
}

{
  "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
​
departmentId
string
required

ID of the target department

​
staffUserId
integer
required

UserId of the staff member

Response

Ticket transferred successfully