Sign in
Proxy Logs

Time-bucketed AI-agent request volume, split by provider or agent.

Changed on

Powers the "AI agents over time" stacked chart. Same data source as the AI agent breakdown (request logs), just bucketed.

get/proxy-logs/stats/ai-agents/timeline

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/proxy-logs/stats/ai-agents/timeline
  • Auth: HTTP bearer

Query parameters

project_idinteger nullable

Filter by project ID.

environment_idinteger nullable

Filter by environment ID.

start_timestring nullable

Start time (ISO 8601). Defaults to end_time - 7d.

end_timestring nullable

End time (ISO 8601). Defaults to now.

group_bystring nullable

Grouping dimension: provider (default) or agent.

bucketstring nullable

Bucket interval override (e.g. 1 hour, 1 day). Auto-selected from the window width when omitted.

Response

AI agent timeline

bucketstring required

Bucket interval used for the buckets (so the UI can label the x-axis).

end_timestring required
group_bystring required

Echoes the grouping dimension actually applied.

start_timestring required

Example response

{
  "bucket": "1 hour",
  "group_by": "provider",
  "items": [
    {
      "bucket": "2026-05-29T12:00:00Z",
      "key": "OpenAI"
    }
  ]
}

Changes

  • 4b228ebed583Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 1dc3e6788214Revision changes
    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status