Skip to content

Support

support_status_create

Add a status to this product status dictionary.

Tool

support_status_create

Add a status to this product status dictionary.

Add a status to this product status dictionary. The name is what people see; the category is what automation and reporting read, and it cannot change once threads sit on the status

Behavior

HTTP
POST /support/statuses

Arguments

NameTypeRequiredDescription
namestringStatus name as the customer wants to see it. Unique within the product
colorstringDisplay colour as a six-digit hex string, e.g. #2563eb
orderintegerSort order within the status dictionary, lowest first
categorystringLifecycle bucket the status belongs to. Automation and reporting read the category, never the name — so it cannot be changed once threads sit on the status

Response

FieldTypeAlwaysDescription
idstringStatus id
namestringStatus name, unique within the product
colorstringDisplay colour as a hex string
orderintegerSort order within the status dictionary
archivedbooleanArchived statuses stay readable but are not offered as targets
categorystringLifecycle bucket the status belongs to

Try it

Add a status to this product status dictionary.

When to use

Add a status to this product status dictionary. The name is what people see; the category is what automation and reporting read, and it cannot change once threads sit on the status

Example

Ask your agent something like this:

Add a status to this product status dictionary.

The agent will invoke support_status_create with these arguments:

{
  "name": "<name>",
  "color": "<color>",
  "order": "<order>",
  "category": "<category>"
}

Esc

Start typing to search the docs.

navigateselect