List ingest routes

get

https://{customerid}.observeinc.com/v1/ingest/routes/{type}

Beta — schema may still change; breaking changes are coordinated with affected customers. Suitable for evaluation, not production reliance.

List ingest routes for a type. Routes are returned in priority order: the
route at index 0 is matched against incoming data first, index 1 is
evaluated next if the first did not match, and so on. The type's default
route is always last, and matches anything the others did not.

Disabled routes are included in the response but are skipped during
matching. This endpoint is not paginated; it returns every route for the
type, and meta.totalCount is that count.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

type

string

enum

required

The type of the ingest route to query. These types correspond to the various source dataset schemas supported by Observe.
any refers to the "default" generic source dataset schema with the FIELDS and EXTRA columns. All of the others
correspond to direct-write source datasets. Each type is also associated with particular ingest HTTP endpoints that emit
compatible data for that type. Incoming data on a given endpoint is routable to any dataset of the corresponding type.

The following [type -> ingest path] mappings are defined:

otellogs <-> /v1/otel/v1/logs
otelmetrics <-> /v1/otel/v1/metrics
oteltraces <-> /v1/otel/v1/traces
prometheus <-> /v1/prometheus
k8sentity <-> /v1/kubernetes
any <-> /v1/*

Allowed:

Query Params

expand

boolean

Whether to expand resources referenced in the response to include additional fields

Responses

200Ingest routes queried successfully

400Bad request

401Unauthorized

403Forbidden

404Resource not found

429Rate limit reached

5XXInternal server error