Skip to main content
List conversations

Authorizations

Authorization
string
header
required

Every request sends Authorization: Bearer <token>. The token is either a panel session (a JWT from /auth/login, 12 hours) or an API key ft_<id>_<secret>. An API key is accepted only from an address on its IP allowlist (403 ip_not_allowed otherwise; 403 ip_allowlist_required for an old key that has none), is limited to its rate per minute (429 rate_limited with Retry-After; X-RateLimit-Limit/Remaining/Reset on every response), and at most 60 call placements a minute.

Query Parameters

limit
integer
default:50
Required range: x <= 500
offset
integer
default:0
sort
string

Sort key. Each list accepts its own allow-list of keys, given in that endpoint's description; anything else is a 400. ORDER BY cannot be parameterised, so the key is looked up rather than interpolated. Every sort carries a tiebreak on the primary key, so paging stays disjoint when the sort column has duplicates.

order
enum<string>

Sort direction. Defaults to ascending, except the call log, which reads newest first.

Available options:
asc,
desc
q
string

Free-text search across the list's searchable columns (case-insensitive substring). % and _ in the term match themselves.

flagged
boolean

true: only conversations the post-call review flagged; false: only those it did not.

Response

OK

items
object[]
limit
integer
offset
integer
total
integer