Open API v1

Create and resolve tickets

Open a helpdesk ticket from your system, then mark it solved when the work is done.

Required scopes: tickets:write, optionally tickets:read.

Create

contact_id and conversation_id must belong to the same workspace as the API key.

bash

curl -X POST https://api.taggoai.com/open/v1/tickets \
  -H "Authorization: Bearer tg_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "Order #1042 has not arrived",
    "type": "Problem",
    "priority": "High",
    "contact_id": "CONTACT_ID",
    "category": "shipping"
  }'

Status starts as New unless you set it.

Ownership statuses

Status	Meaning
`New`	Just opened
`On you`	Waiting on your team
`On customer`	Waiting on the customer
`On hold`	Parked
`Solved`	Work is done
`Closed`	Closed after solve or by policy
`Cancelled`	Will not be worked

Solved, Closed, and Cancelled are terminal. Setting one of them stamps solved_at or closed_at.

Resolve

bash

curl -X PATCH https://api.taggoai.com/open/v1/tickets/TICKET_ID \
  -H "Authorization: Bearer tg_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "status": "Solved" }'