Remove a ticket state

DELETE/api/v1/accounts/{account_id}/ticket_states/{id}

A state in use is archived; the four system states stay.

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

idintegerrequired

Responses

200

Removed or archived

curl -X DELETE 'https://desk.texadesk.com/api/v1/accounts/1/ticket_states/1' \
  -H "api_access_token: $TEXA_DESK_TOKEN"

import os, requests

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

const r = await fetch("https://desk.texadesk.com/api/v1/accounts/1/ticket_states/1", {
  method: "DELETE",
  headers: { "api_access_token": `${process.env.TEXA_DESK_TOKEN}` },
});
if (!r.ok) throw new Error(`${r.status}: ${await r.text()}`);