Tickets

The Tickets API lets you manage IT support tickets programmatically — create incidents, update status, add notes, and query ticket history.

Create a Ticket

curl -X POST "https://apps.aurionai.net/api/v1/tickets" \
  -H "X-API-Key: ak_live_xxxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: idem_xxxx" \
  -d '{
    "subject": "VPN not connecting",
    "description": "Unable to connect to corporate VPN since this morning.",
    "priority": "high",
    "category": "Network"
  }'

Response (201 Created):

{
  "id": 1042,
  "subject": "VPN not connecting",
  "status": "open",
  "priority": "high",
  "category": "Network",
  "created_at": "2026-02-20T14:30:00Z"
}

Get a Ticket

curl "https://apps.aurionai.net/api/v1/tickets/1042" \
  -H "X-API-Key: ak_live_xxxx"

List Tickets

curl "https://apps.aurionai.net/api/v1/tickets?status=open&priority=high&limit=10&offset=0" \
  -H "X-API-Key: ak_live_xxxx"

Query Parameters:

Parameter	Type	Description
`status`	string	Filter by status: `open`, `pending`, `resolved`, `closed`
`priority`	string	Filter by priority: `low`, `medium`, `high`, `urgent`
`category`	string	Filter by category
`search`	string	Full-text search in subject and description
`limit`	integer	Results per page (default: 25, max: 100)
`offset`	integer	Number of results to skip

See Pagination for details on paginating through results.

Update a Ticket

curl -X PUT "https://apps.aurionai.net/api/v1/tickets/1042" \
  -H "X-API-Key: ak_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "pending",
    "priority": "medium"
  }'

Add a Note

curl -X POST "https://apps.aurionai.net/api/v1/tickets/1042/notes" \
  -H "X-API-Key: ak_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "body": "User confirmed the issue started after the latest Windows update.",
    "private": true
  }'

Close a Ticket

curl -X POST "https://apps.aurionai.net/api/v1/tickets/1042/close" \
  -H "X-API-Key: ak_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "resolution_notes": "Resolved by reinstalling VPN client v4.2."
  }'

Idempotency

For POST requests that create resources, include an Idempotency-Key header to prevent duplicate creation on retries:

curl -X POST "https://apps.aurionai.net/api/v1/tickets" \
  -H "Idempotency-Key: idem_xxxx" \
  ...

If a request with the same idempotency key is received within 24 hours, the API returns the original response without creating a duplicate.

Ticket Lifecycle

open → pending → resolved → closed
  ↑                           |
  └───── reopen ──────────────┘

Tickets progress through statuses. A closed ticket can be reopened, which returns it to open status.

Tickets

On this page