Quick Start
Run your first Athena gateway and operations calls.
This guide assumes Athena is running at http://localhost:4052.
1. Fetch Rows
curl -X POST "http://localhost:4052/gateway/fetch" \
-H "content-type: application/json" \
-H "x-athena-client: athena_logging" \
-d '{
"table": "gateway_operation_log",
"columns": ["id", "client_name", "operation", "created_at"],
"limit": 10
}'2. Execute SQL
curl -X POST "http://localhost:4052/query/sql" \
-H "content-type: application/json" \
-H "x-athena-client: athena_logging" \
-d '{
"driver": "postgresql",
"query": "select now() as current_time"
}'3. Simulate a Pipeline
curl -X POST "http://localhost:4052/pipelines/simulate" \
-H "content-type: application/json" \
-H "x-athena-client: athena_logging" \
-d '{
"source": {
"table_name": "gateway_operation_log",
"limit": 25
},
"transform": {
"group_by": "client_name",
"aggregation_column": "duration_ms",
"aggregation_strategy": "avg"
}
}'4. Inspect Cluster Health
curl "http://localhost:4052/health/cluster"5. Download API Contracts
curl "http://localhost:4052/openapi.yaml"
curl "http://localhost:4052/openapi-wss.yaml"Next Steps
- Read API Overview
- Integrate the Athena.js npm SDK (
@xylex-group/athena) - Integrate Athena RS SDK
- Configure MCP Server workflows
- Follow Cluster Operations runbooks