---
title: "Reauthorize Mcp Oauth"
method: POST
path: "/v3/integrations/mcp/{id}/oauth/consume"
tags: ["integrations-v3"]
---

# Reauthorize Mcp Oauth

`POST /v3/integrations/mcp/{id}/oauth/consume`

Apply a completed pending OAuth flow to an existing MCP integration.

Merges the pending row's tokens onto the existing integration's
secret, rotating credentials in place.

**Permissions**: integration setup user — matches the permission
required to create the integration in the first place.

## Path parameters

- `id` string, required

## Query parameters

- `organization_id` string, nullable

## Request body

- McpOAuthReauthorizeRequest — Body for ``POST /v3/integrations/mcp/{id}/oauth/consume`` (edit mode).
  - `pending_integration_id` string, required — ID returned by ``POST /v3/integrations/mcp/oauth/start``. The backend merges the pending row's tokens onto the existing integration's secret, rotating credentials in place.

## Response `200`

Successful Response

- IntegrationInstanceResponse — Metadata about a single integration instance. Credential fields are never included in this response. Use the integration-type-specific credential rotation endpoints to update secrets.
  - `id` string, required — Stable UUID for this integration instance. Use this in PUT /v3/integrations/{id} and DELETE /v3/integrations/{id}.
  - `organization_id` string, required — UUID of the organization that owns this integration instance.
  - `name` string, required — Human-readable display name set at creation time.
  - `description` string, 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_id` string, 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_types` string[], required — List of data-type capabilities enabled for this integration (e.g. ``["logs", "metrics"]``). Controlled by the integration payload.
  - `metadata` object — Non-secret integration-specific metadata stored with this instance.
  - `created_at` string, date-time, nullable — ISO-8601 timestamp of when this integration instance was created.
  - `updated_at` string, date-time, nullable — ISO-8601 timestamp of the most recent update to this instance.
  - `created_by` string, nullable — UUID of the user who created this integration instance, if known.
  - `last_health_check` HealthCheckResponse — Aggregate result of an integration's connection health check.
    - `status` 'pending' | 'connected' | 'partial' | 'failed', required — Overall status of a connection health check.
    - `steps` HealthCheckStepResponse[], required
      - `step` 'connectivity' | 'auth' | 'query', required — Identifies which health check step a result is for.
      - `passed` boolean, required
      - `message` string, required
      - `details` object
    - `checked_at` string, date-time, required
  - `network_access` string, nullable — Name of the network this integration connects through (e.g. an internal VPN). Null when the integration connects over the public internet.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/traversal/apis/fastapi.md) · [All operations](https://skmtc.net/traversal/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/traversal/fastapi/revisions/2134ebffd1ef/schema)