Athena
Data

Legacy alias for `/gateway/fetch`

Mirrors `/gateway/fetch` for clients still calling `/gateway/data` with the same payload/response envelope.

POST
/gateway/data

Header Parameters

X-User-Id?string
X-Athena-Client?string
X-Strip-Nulls?string
apikey?string
x-api-key?string

optional API key mirror of the apikey header

x-supabase-url?string

Required when X-Athena-Client is custom_supabase

Formaturi
x-supabase-key?string

Required when X-Athena-Client is custom_supabase

Request Body

application/json

view_name?string
table_name?string
columns?array<>|
conditions*array<>
limit?integer
current_page?integer
page_size?integer
offset?integer
total_pages?integer
strip_nulls?boolean
group_by?string

Column name to group results by

time_granularity?string

Time granularity for grouping timestamp data

Value in"day" | "hour" | "minute"
aggregation_column?string

Column to aggregate (required when using aggregation_strategy)

aggregation_strategy?string

Aggregation strategy to apply (requires aggregation_column)

Value in"cumulative_sum"
aggregation_dedup?boolean

Whether to deduplicate during aggregation

sortBy?

Optional sort (camelCase). Use sort_by for snake_case.

sort_by?

Optional sort (snake_case). Same shape as sortBy.

Response Body

curl -X POST "https://athena-cluster.com/gateway/data" \  -H "Content-Type: application/json" \  -d '{    "conditions": [      {}    ]  }'
Empty
Empty
Empty

Execute SQL using selected driver POST

For `driver: postgresql`, connection resolution matches gateway handlers: send `X-Athena-Client` for a registered client pool, or `X-JDBC-URL` with a `jdbc:postgresql://...` URL for a direct connection (subject to gateway JDBC allowlists when configured).

Fetch deferred request status GET

Returns the current state of a deferred gateway request (`queued`, `running`, `completed`, `failed`, etc.) together with available execution metadata.