Tickets API · Ticket types and states

List ticket states

GET/api/v1/accounts/{account_id}/ticket_states

Authorization

api_access_tokenheaderrequired

A person's access token (Texa Desk, Profile settings → Access token) or an agent bot's token, in the api_access_token header. It acts as that person, with their role's permissions.

Path parameters

account_idintegerrequired

The account's id

Responses

200

The states, ordered by category

payloadarray of object

payload[].idinteger

payload[].namestring

The state as your team sees it

payload[].customer_namestring

The state as the customer sees it

payload[].categorystring

One of: submitted, in_progress, waiting_on_customer, resolved.

payload[].systemboolean

One of the four states every account has

payload[].positioninteger

payload[].archivedboolean

import os, requests headers = {"api_access_token": os.environ["TEXA_DESK_TOKEN"]} r = requests.get("https://desk.texadesk.com/api/v1/accounts/1/ticket_states", headers=headers) r.raise_for_status() print(r.json())

{ "payload": [ { "id": 1, "name": "In progress", "customer_name": "We're working on it", "category": "submitted", "system": true, "position": 1, "archived": true } ] }