Exports API
Manage export configs that stream gateway trace data to external observability and evaluation tools.
Export configs stream gateway trace data to an external tool in near-real-time, as OTLP traces or signed webhook deliveries. See Trace Exports for concepts: kind semantics, delivery guarantees, source filtering, and secret handling.
Entitlement and roles
integrations entitlement (Enterprise plan). Reads need the viewer role; writes (create/update/delete) need admin.List Export Configs
/api/v1/exportsList the org's export configs.
{"exports": [ /* ExportConfig, ... */ ]}Create Export Config
/api/v1/exportsCreate an export config. Takes effect immediately, no restart required.
curl -X POST https://api.ingateai.com/api/v1/exports \
-H "X-Ingate-Key: sk-ingate-your-key" \
-H "Content-Type: application/json" \
-d '{
"name": "phoenix-otlp",
"kind": "otlp",
"endpoint": "http://phoenix.internal:6006/v1/traces",
"headers": {},
"include_sources": ["proxy", "api"],
"enabled": true
}'| Field | Type | Required | Default | Description |
|---|---|---|---|---|
name | string | yes | none | Unique per org |
kind | string | yes | none | otlp or webhook |
endpoint | string | yes | none | Destination URL |
headers | object | no | {} | Static headers sent with every delivery (e.g. Authorization) |
secret | string | no | none | Webhook kind only: HMAC signing secret |
include_sources | string[] | no | ["proxy", "api"] | Must be a subset of proxy, api, otel |
enabled | bool | no | true | Whether the config is live immediately |
Response 201: the created ExportConfig.
Write-only secrets
headers and secret are write-only: encrypted at rest and never echoed back by any endpoint, including GET. has_secret is the only visible signal that a webhook secret is set.Get Export Config
/api/v1/exports/:idGet an export config.
Response 200: the ExportConfig.
Update Export Config
/api/v1/exports/:idPartial update: only provided fields change; omitted fields are left as-is.
Request: same fields as create, all optional. Response 200: the updated ExportConfig.
Delete Export Config
/api/v1/exports/:idDelete an export config.
{"deleted": true}Delete also removes the config from the live registry, so in-flight delivery for that config stops immediately.
Errors
| Status | error_code | Cause |
|---|---|---|
400 | invalid_config | kind is not otlp/webhook, or include_sources has an unrecognized value |
409 | duplicate_name | An export config with this name already exists in the org |
400 | invalid_id | The :id path parameter is not a valid ID (get/update/delete) |
404 | not_found | No export config with that ID (get/update/delete) |
400 | invalid_body | Malformed update request body |