Skip to main content
GET
/
v1
/
triage
/
flag-types
List Flag Types
curl --request GET \
  --url https://api.bland.ai/v1/triage/flag-types \
  --header 'authorization: <authorization>'
{
  "data": {
    "items": [
      {
        "type": "missed_handoff",
        "description": "Agent transferred without confirming the email.",
        "usage_count": 4,
        "last_used_at": "2026-05-07T05:26:11.327Z"
      },
      {
        "type": "wrong_pathway_node",
        "description": "Agent jumped to closing without verifying.",
        "usage_count": 2,
        "last_used_at": "2026-05-05T22:14:01.117Z"
      }
    ],
    "next_cursor": null
  },
  "errors": null
}

​
Overview

Catalog of flag types your org has used, with usage counts and the most recent note for each. Use it to render a flag-type picker. Types are normalized to lower_snake_case before storage.

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Query Parameters

​
limit
integer
default:"50"
Number of types to return. Minimum 1, maximum 100.
​
cursor
string
Opaque cursor returned as next_cursor from a previous page.

​
Response

​
data.items
array
Array of flag types.
​
data.next_cursor
string | null
Cursor for the next page, or null.
​
errors
null | array
null on success.
{
  "data": {
    "items": [
      {
        "type": "missed_handoff",
        "description": "Agent transferred without confirming the email.",
        "usage_count": 4,
        "last_used_at": "2026-05-07T05:26:11.327Z"
      },
      {
        "type": "wrong_pathway_node",
        "description": "Agent jumped to closing without verifying.",
        "usage_count": 2,
        "last_used_at": "2026-05-05T22:14:01.117Z"
      }
    ],
    "next_cursor": null
  },
  "errors": null
}
Docs for agents: llms.txt