Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1430332272.3 KB

Returns all active instrumentation configurations for a service and environment. SDKs use this operation to sync configurations and apply client-side filters locally.

Include the previous SyncedAt value to perform incremental syncs. When no changes are detected, the response sets Changed to false and omits configuration details.

post/list-instrumentation-configurations

Request body

Servicestring required

The name of the service to retrieve instrumentation configurations for.

Environmentstring required

The environment that the service is running in.

InstrumentationType'BREAKPOINT' | 'PROBE' required

Type of instrumentation configuration

SyncedAtstring date-time

The timestamp from the last successful sync. When provided, the response returns <code>Changed</code> as <code>false</code> if nothing is new since this time, or returns the latest configurations when changes exist.

MaxResultsinteger

The maximum number of configurations to return in one call. The default is 50 and the maximum is 100.

NextTokenstring

Use the token returned by a previous call to retrieve the next page of configurations.

Response

Success

Servicestring required

The service name associated with the returned configurations.

Environmentstring required

The environment associated with the returned configurations.

Changedboolean required

Indicates whether there are configuration changes since the provided <code>SyncedAt</code> timestamp.

SyncedAtstring date-time required

The server timestamp to supply on the next sync call.

SyncIntervalinteger required

The suggested number of seconds to wait before the next sync request. This is at least 60 seconds to prevent excessive polling.

NextTokenstring

Pagination token to continue listing configurations when more results are available.