FruxonDocs
AgentsExecution Records

Gets the agent's conversations and escalations bucketed over time.

A conversation is a customer visit, counted the way the Application's support KPIs count it: the customer's messages in one conversation, split wherever they went quiet for four hours. It is escalated when the agent handed it to a person, or tried to and reached nobody (`deadEnded`). Production traffic only. Each conversation is counted in the bucket it started in; buckets with none are omitted. Counting is live over the workspace's run history, so a window reaching further back is counted from `countedFromMs`.

GET
/v1/tenants/{tenant}/agents/{agent}/conversationTimeseries

Authorization

Bearer
AuthorizationBearer <token>

JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.

In: header

Path Parameters

agent*string

Agent identifier.

tenant*string

The tenant identifier

Query Parameters

interval?string

Bucket granularity (hour, day, week). Defaults to day.

Default"DAY"
Value in"UNSPECIFIED" | "HOUR" | "DAY" | "WEEK"
from?integer

Window start as Unix milliseconds (inclusive). Defaults to 30 days before to.

Formatint64
to?integer

Window end as Unix milliseconds (exclusive). Defaults to now.

Formatint64

Response Body

curl -X GET "https://api.fruxon.com/v1/tenants/string/agents/string/conversationTimeseries"
{
  "agentId": "string",
  "interval": "HOUR",
  "window": {
    "fromMs": 0,
    "toMs": 0
  },
  "countedFromMs": 0,
  "points": [
    {
      "bucketStartMs": 0,
      "conversations": 0,
      "escalated": 0,
      "deadEnded": 0
    }
  ]
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}

Executes an agent using its currently deployed revision with streaming output.

Returns results as Server-Sent Events (SSE) for real-time progress updates.

Gets per-environment execution summaries for an agent.

Returns aggregated execution count, total cost, and last activity time for each environment that has execution records for this agent, ordered by environment slug. Pass `?include=trends` to also populate week-over-week deltas (current 7-day window vs. prior 7-day window).