---
title: "Update Integration Connection"
method: PUT
path: "/v1/integrations/connection/{integration_connection_id}"
tags: ["integrations", "integration-connections"]
---

# Update Integration Connection

`PUT /v1/integrations/connection/{integration_connection_id}`

## Request

- Base URL: `https://api.mentium.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mentium.io/v1/integrations/connection/{integration_connection_id}`
- Auth: HTTP bearer

Update an integration connection's name and/or scope.

## Path parameters

- `integration_connection_id` string, uuid, required

## Headers

- `mentium-workspace-id` string, nullable

## Request body

- IntegrationConnectionUpdateInput
  - `name` string, nullable
  - `scope` 'ORGANIZATION' | 'WORKSPACE' | 'USER'
  - `keys` KeyInfo[], nullable
    - `key` string, required
    - `value` string, required
    - `is_secret` boolean, required
  - `contributes_to_carrier_pool` boolean, nullable
  - `preferred_load_identifier` 'EXTERNAL_REFERENCE_ID' | 'TMS_DISPLAY_REFERENCE_ID'
  - `past_pickup_grace_days` integer, nullable
  - `equipment_length_feet` object, nullable
  - `default_equipment_length_feet` integer, nullable

## Response `200`

Successful Response

- IntegrationConnectionResponse
  - `id` string, required
  - `integration_id` string, required
  - `organization_id` string, required
  - `workspace_id` string, nullable
  - `user_id` string, nullable
  - `secret_id` string, required
  - `name` string, nullable
  - `params` object, nullable
  - `connected_with_deployed_workflow` boolean
  - `contributes_to_carrier_pool` boolean
  - `preferred_load_identifier` 'EXTERNAL_REFERENCE_ID' | 'TMS_DISPLAY_REFERENCE_ID'
  - `past_pickup_grace_days` integer
  - `equipment_length_feet` object
  - `default_equipment_length_feet` integer, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mentium/apis/mentium-api.md) - [All operations](https://skmtc.dev/mentium/apis/mentium-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mentium/apis/mentium-api/revisions/b4ed8e59432e?raw)