Tickets

Access and modify organization's Tickets

Authorization: All requests must be authenticated and authorized by adding a special Header to each request containing the Organization Key (available in https://app.xyte.io/settings/api_keys)

GET https://hub.xyte.io/core/v1/organization/tickets

Return array of all open tickets

Headers

[
  {
    "id": "b9a53d31...",
    "title": "Ticket title",
    "description": "Ticket description",
    "status": "open",
    "created_at": "2023-07-05T11:37:26Z",
    "device_id": "a3983ff2...",
    "user_name": "Demo User",
    "user_email": "demo@xyte.io"
  }
]

GET https://hub.xyte.io/core/v1/organization/tickets/:ticket_id

Return detailed information on a Ticket

Path Parameters

Headers

{
  "id": "b9a53d31...",
  "title": "Ticket title ",
  "description": "Ticket description",
  "status": "resolved",
  "created_at": "2023-07-05T11:37:26Z",
  "device_id": "a3983ff2...",
  "user_name": "Demo User",
  "user_email": "demo@xyte.io",
  "comments": [
    {
      "id": 1,
      "text": "Cannot open door",
      "created_at": "2023-08-14T06:22:42.310Z",
      "system": false,
      "user": "Demo User",
      "owner": "Xyte Lab",
      "owner_type": "organization"
    }
  ]
}

PUT https://hub.xyte.io/core/v1/organization/tickets/:ticket_id

Update ticket status

Path Parameters

Headers

Request Body

Detailed ticket information - see Get Ticket API

POST https://hub.xyte.io/core/v1/organization/tickets/:ticket_id/resolved

Mark Ticket as resovled

Path Parameters

Headers

{
    "success": true
}

POST https://hub.xyte.io/core/v1/organization/tickets/:ticket_id/message

Add comment to an existing Ticket

Path Parameters

Headers

Request Body

{
  "success": true
}

Error Handling

  • 401 Unauthorized: If the api_key is not provided or is invalid.

  • 403 Forbidden: If the user does not have permission to perform the requested action.

  • 422 Unprocessable Entity: If a required parameter is missing or invalid.

Last updated