integrations-v3

List Datasets

List the datasets an integration instance exposes, most-recently-seen first.

A dataset is one queryable unit of the integration — an index pattern for Elasticsearch/OpenSearch, an application for AppDynamics, a table for ServiceNow. Each entry carries when we last saw it and whether data has arrived for it recently.

Paginated because the count is unbounded in practice: the largest instance in production owns over 100,000 datasets. Use total_count for an "N indexes" label rather than the length of datasets.

search filters server-side on a case-insensitive substring of the dataset's stored key, narrowing total_count alongside the page. It does not match the rendered display_name, which is derived from the stored details and has no column to filter on; the two coincide for most integrations but not AppDynamics, whose key holds an application id while the row displays the application name.

dataset_term narrows to the rows carrying one source-system noun and narrows total_count too. It takes a key from this integration type's dataset_terms (see the integration catalog), which is also what each row reports as dataset_term_key — never the displayed wording, so the filter survives a rewording. log_group returns just the CloudWatch Logs half of an instance that also holds metric namespaces. A valid key belonging to another integration type selects nothing, and that empty page is the honest answer rather than an error. Both filters compose.

Permissions: users with integration-setup permission on the owning org.

Returns HTTP 404 if the instance does not exist in the resolved organization, and HTTP 503 (DATASET_AVAILABILITY_UNAVAILABLE) if the label-value store cannot be reached — availability is unknowable then, and reporting every dataset as not_available would be a false statement about the customer's data rather than about our own reachability.

get/v3/integrations/{id}/datasets

Path parameters

idstring required

Query parameters

organization_idstring nullable
pageinteger
page_sizeinteger
searchstring nullable
dataset_term'index' | 'region' | 'instance' | 'endpoint' | 'table' | 'application' | 'workspace' | 'service' | 'controller' | 'log_group' | 'namespace' | 'account_group'

A noun one integration's datasets are known by, in the source system.

The single identity of a noun: what a variant's term returns, what keys the selector that filters by it, and the value a client sends to filter by it. Each member carries its own spellings, so a noun cannot exist without them.

The enum value is the key rather than the singular, so filtering never depends on display wording and no value needs escaping in a query string.

Response

Successful Response

pageinteger required

1-based page number this response represents.

page_sizeinteger required

Maximum datasets per page.

has_moreboolean required

Whether a further page exists after this one.

total_countinteger required

Total datasets the instance owns, independent of paging. Pair with the integration type's dataset_terms plural for an 'N indices' style count, rather than using the length of datasets.

Changes