Pick an agent for a call
Returns your published agents that can make a call (can=dial, the default: outgoing or both ways) or take one (can=answer: incoming or both ways), A to Z, 20 at a time (limit up to 100). Narrow by name with search; pass next_cursor back as cursor for the next page. total counts every match, and unpublished (on the first page without a search) counts agents you haven’t published yet.
Scopes: agent:read
Authorizations
An API key from Settings → API keys, sent as Authorization: Bearer kb_live_…. A workspace key starts kb_; a personal key starts kbp_ and acts as its owner.
Headers
The API version to answer as, a date (YYYY-MM-DD). Leave it out for the current version (2026-11-07). An unknown version is refused with 400 unsupported_api_version.
2026-11-07 "2026-11-07"
Query Parameters
dial, answer 1001 <= x <= 100512Response
Successful Response
Live agents that can make (or take) a call, A-Z.
The items on this page, in the list's order.
True when another page follows this one.
Every agent matching the filter, across all pages.
Your agents not published yet (first page without a search only; 0 otherwise).
Pass as cursor to get the next page. Null on the last page. Opaque: don't parse it.