v1

latestOpenAPI 3.0.12026-07-2696152184.1 KB

Agents

Export Metric Results

Exports metric results as a CSV file.

By default, with no pagination parameters, the endpoint streams the entire matching result set as a single CSV. To page through results instead, pass limit and starting_after / ending_before. Paginated responses include the X-Has-More and X-Next-Cursor headers. Up to 100,000 rows can be exported per request in either mode; requests whose total matching set exceeds this cap return a 400 error.

get/agents/metrics/results/export

Query parameters

agent_idstring nullable

The ID of the agent.

deployment_idstring nullable

The ID of the deployment.

metric_idstring nullable

The ID of the metric.

call_idstring nullable

The ID of the call.

start_datestring date-time nullable

Example:2024-04-01T00:00:00Z

Filter metric results created at or after this RFC 3339 datetime.

end_datestring date-time nullable

Example:2024-04-30T23:59:59Z

Filter metric results created before or at this RFC 3339 datetime.

limitinteger

The maximum number of rows to return in this CSV page, between 1 and 1000. Passing this parameter enables paginated mode; omit it (along with starting_after and ending_before) to stream the full result set.

starting_afterstring nullable

An opaque pagination cursor. Returns the page of results after this cursor. Pass the X-Next-Cursor value from the previous page to fetch the next page. Treat the cursor as an opaque string. Cannot be combined with ending_before.

ending_beforestring nullable

An opaque pagination cursor. Returns the page of results before this cursor. Treat the cursor as an opaque string. Cannot be combined with starting_after.

Headers

Cartesia-Version'2026-03-01' date required

Example:2026-03-01

API version header.

Response

Successfully exported metric results as a CSV file.