API Reference

Execute a dynamic metric query against the integration's stored metric data (Parquet via DuckDB).

post
https://platform.routy.app/api/v1/traffic-sources/integrations//metric-query

Requires the TrafficSourceRead policy. Returns 400 when the S3/DuckDB metric reader is not
enabled or when the query fails validation. Returns an enveloped 404 condition when the
integration or its provider metric schema is not found.

🔐 Required permission: traffic-source.read

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
int32
required

Numeric id of the integration.

Body Params

The dynamic metric query (fields, aggregations, filters, date range).

Dynamic metric query — supports any combination of columns, filters, group by, aggregations.
All field names are validated against the provider's metric schema before execution.

date-time
date-time
select
array of strings | null
select
aggregations
array of objects | null
aggregations
groupBy
array of strings | null
groupBy
filters
array of objects | null
filters
orderBy
array of objects | null
orderBy
int32
int32
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
string
enum
Defaults to application/json

Generated from available request content types

Allowed:
Responses

Updated 2 days ago

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
text/plain
application/json
text/json

Updated 2 days ago