Skip to content

Tools that read calls or events by time use a window from since to until.

  • A window is at most 31 days. Longer windows are refused; ask for longer periods in parts.
  • Without since and until, the window is the last 24 hours.
  • All times are in UTC.
  • A date without a time, such as 2026-09-30, means 00:00 UTC that day.
  • until is exclusive. For a single day, use that day as since and the next day as until. For example, 30 September 2026 is since 2026-09-30, until 2026-10-01.
  • A date-time needs a timezone, for example 2026-09-30T00:00:00Z or +05:00.

Long lists come in pages. The assistant asks for the next page when it needs more.

Tool Per page Default
List tools (page_size) 1 to 100 20
Search calls (limit) 1 to 50 25
Call report groups (limit) 1 to 100 50

For counts and totals, the assistant uses the call report instead of paging through calls.

Each result is kept under about 45,000 characters, so it fits within the assistant’s limits. If a result is larger, whole items are left out from the end, the result is marked as truncated, and a note says how many were left out. Ask for a smaller page, fewer included parts or a narrower filter to see them.

One tool call can take up to 45 seconds and make up to 50 reads from Teleflows. Larger requests stop with a message asking you to narrow them: fewer included parts, a smaller window or a more specific filter.

If Teleflows is busy, rate limiting or does not answer, the server may wait a few seconds and try once more. If that fails, it stops the rest of that request and says so.

Records are shown as Teleflows returns them. Money fields ending in _cents are in cents. Where Teleflows does not document what a value means, the assistant says so instead of guessing.

Exact inputs and limits for each tool: Tools.