Sign in
integrations-v3

Consume Mcp Oauth

Finalize a pending OAuth flow into a brand-new MCP integration.

Looks up the pending row, ensures it's been authorized, then creates a new IntegrationInstance with the stored tokens. Returns 404 if the pending row isn't found in the caller's org, or 400 if it hasn't reached the completed state yet.

Permissions: integration setup user.

post/v3/integrations/mcp/oauth/consume

Query parameters

organization_idstring nullable

Request body

namestring required

Display name for the new integration.

descriptionstring nullable

Optional description for the new integration.

pending_integration_idstring required

ID returned by POST /v3/integrations/mcp/oauth/start. The backend looks up the stored tokens and binds them to the new integration's secret.

network_accessstring nullable

Optional named network this integration should connect through.

blocked_toolsstring[]

Legacy list of MCP tool names to hide from the agent. Preserved for older clients that still finalize OAuth integrations with blocked tool settings.

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' | 'gitlab' | 'thousandeyes' | 'linear' | 'notion' | 'loki' | 'opensearch' | 'splunk' | 'gcp' | 'motherduck' | 'confluence' | 'coralogix' | 'firehydrant' | 'slack' | 'teams' | 'jira' | 'kubernetes' | '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' 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.

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.

Changes

No changes recorded. 6 of the 24 revisions have no diff computed, so they could not be searched.