TRtraversal
integrations-v3

List

Changed on

Search integration instances, with optional filtering.

Query parameters (all optional):

ParameterDescription
idReturn only the instance with this UUID.
integration_typeFilter by integration type (e.g. LogService, opensearch).
organization_idScope to this org. Defaults to the caller's org. Cross-org queries require platform-admin.
third_party_idFilter by third-party system identifier (e.g. a LogService ID).

Permissions: org member, org setup user, or org admin (own org); platform admin (any org).

Results are ordered by created_at descending.

get/v3/integrations/search

Request

  • Base URL
    https://api.traversal.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.traversal.com/v3/integrations/search
  • Auth
    none declared

Query parameters

idstring nullable
integration_type'anthropic' | 'openai' | 'gradient_ai' | 'datadog' | 'elasticsearch' | 'prometheus' | 'mimir' | 'victoria_metrics' | 'grafana' | 'appdynamics' | 'servicenow' | 'github' | 'github_webhook' | 'gitlab' | 'thousandeyes' | 'linear' | 'notion' | 'loki' | 'opensearch' | 'splunk' | 'gcp' | 'motherduck' | 'confluence' | 'coralogix' | 'firehydrant' | 'pagerduty' | 'slack' | 'teams' | 'jira' | 'kubernetes' | 'traversal' | 'traversal_webhook' | 'traversal_api_key' | 'incident_io' | 'sentry' | 'tempo' | 'alexandria' | 'honeycomb' | 'alertmanager' | 'emim' | 'trailblazer' | 'dynatrace' | 'cribl' | 'mcp' | 'aws_cli' | 'artifactory' | 'spinnaker' | 'amex_webex_captions' | 'deptracker' | 'do_service_catalog' | 'cloudwatch' | 'azure_devops' | 'azure'

Canonical integration platform types.

Represents the platform or system where data originates from. Used to determine appropriate connectors, authentication, and API clients.

organization_idstring nullable
third_party_idstring nullable

Response

Successful Response

idstring required

Stable UUID for this integration instance. Use this in PUT /v3/integrations/{id} and DELETE /v3/integrations/{id}.

organization_idstring required

UUID of the organization that owns this integration instance.

namestring required

Human-readable display name set at creation time.

descriptionstring nullable

Optional free-text description of this integration instance. Surfaced to Traversal's AI during investigations to help it understand when and how to use this integration.

type'anthropic' | 'openai' | 'gradient_ai' | 'datadog' | 'elasticsearch' | 'prometheus' | 'mimir' | 'victoria_metrics' | 'grafana' | 'appdynamics' | 'servicenow' | 'github' | 'github_webhook' | 'gitlab' | 'thousandeyes' | 'linear' | 'notion' | 'loki' | 'opensearch' | 'splunk' | 'gcp' | 'motherduck' | 'confluence' | 'coralogix' | 'firehydrant' | 'pagerduty' | 'slack' | 'teams' | 'jira' | 'kubernetes' | 'traversal' | 'traversal_webhook' | 'traversal_api_key' | 'incident_io' | 'sentry' | 'tempo' | 'alexandria' | 'honeycomb' | 'alertmanager' | 'emim' | 'trailblazer' | 'dynatrace' | 'cribl' | 'mcp' | 'aws_cli' | 'artifactory' | 'spinnaker' | 'amex_webex_captions' | 'deptracker' | 'do_service_catalog' | 'cloudwatch' | 'azure_devops' | 'azure' required

Canonical integration platform types.

Represents the platform or system where data originates from. Used to determine appropriate connectors, authentication, and API clients.

third_party_idstring nullable

Optional opaque identifier from the third-party system (e.g. a Log Store instance ID). Populated automatically from the integration payload when present.

enabled_data_typesstring[] required

List of data-type capabilities enabled for this integration (e.g. ["logs", "metrics"]). Controlled by the integration payload.

metadataobject

Non-secret integration-specific metadata stored with this instance.

created_atstring date-time nullable

ISO-8601 timestamp of when this integration instance was created.

updated_atstring date-time nullable

ISO-8601 timestamp of the most recent update to this instance.

created_bystring nullable

UUID of the user who created this integration instance, if known.

connector_idstring nullable

UUID of the org connector this instance routes through. Null when the instance connects over the public internet.

network_accessstring nullable

Name of the network this integration connects through (e.g. an internal VPN). Null when the integration connects over the public internet.

environment_labelsstring[]

The customer's own names for the environments this integration's data covers, e.g. ["prod", "staging"], normalized to lowercase. Empty when the instance has none. The single reserved value "unscoped" means the data is deliberately not split by environment, which is distinct from the empty list meaning nobody has labelled it yet.

Changes

  • 31e1a8b7cf89Revision changes
    • warning

      added the new azure enum value to the / response property for the response status

    • info

      added the enum value azure to the property anyOf[subschema #1: IntegrationType]/ of the query request parameter integration_type

  • 75b9e4398c46Revision changes
    • warning

      added the new traversal enum value to the / response property for the response status

    • info

      added the enum value traversal to the property anyOf[subschema #1: IntegrationType]/ of the query request parameter integration_type