---
title: "Update connection"
method: PUT
path: "/unified/connection/{id}"
tags: ["unified", "connection"]
---

# Update connection

`PUT /unified/connection/{id}`

## Path parameters

- `id` string, required

## Request body

- Connection — A connection represents a specific authentication of an integration.
  - `id` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `workspace_id` string
  - `integration_type` string, required
  - `integration_name` string
  - `external_xref` string
  - `permissions` string[], required
  - `categories` string[], required — The Integration categories that this connection supports
  - `auth` PropertyConnectionAuth — An authentication object that represents a specific authorized user's connection to an integration.
    - `token` string
    - `access_token` string
    - `refresh_token` string
    - `expiry_date` string, date-time
    - `expires_in` number
    - `emails` string[]
    - `name` string
    - `user_id` string
    - `app_id` string
    - `client_id` string
    - `client_secret` string
    - `consumer_key` string
    - `consumer_secret` string
    - `meta` object
    - `state` string
    - `other_auth_info` string[] — When integration.auth_type = "other", this field contains the authentication credentials in the same order as token_names
    - `api_url` string
    - `authorize_url` string
    - `token_url` string
    - `refresh_url` string
    - `pem` string
    - `key` string
    - `refresh_token_expires_in` number
    - `refresh_token_expires_date` string, date-time
    - `dev_api_key` string
    - `audience` string
  - `is_paused` boolean
  - `environment` string
  - `last_healthy_at` string, date-time
  - `last_unhealthy_at` string, date-time
  - `last_unhealthy_code` string
  - `secretsmanager_id` string
  - `secretsmanager_key` string

## Response `200`

Successful

- Connection — A connection represents a specific authentication of an integration.
  - `id` string
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `workspace_id` string
  - `integration_type` string, required
  - `integration_name` string
  - `external_xref` string
  - `permissions` string[], required
  - `categories` string[], required — The Integration categories that this connection supports
  - `auth` PropertyConnectionAuth — An authentication object that represents a specific authorized user's connection to an integration.
    - `token` string
    - `access_token` string
    - `refresh_token` string
    - `expiry_date` string, date-time
    - `expires_in` number
    - `emails` string[]
    - `name` string
    - `user_id` string
    - `app_id` string
    - `client_id` string
    - `client_secret` string
    - `consumer_key` string
    - `consumer_secret` string
    - `meta` object
    - `state` string
    - `other_auth_info` string[] — When integration.auth_type = "other", this field contains the authentication credentials in the same order as token_names
    - `api_url` string
    - `authorize_url` string
    - `token_url` string
    - `refresh_url` string
    - `pem` string
    - `key` string
    - `refresh_token_expires_in` number
    - `refresh_token_expires_date` string, date-time
    - `dev_api_key` string
    - `audience` string
  - `is_paused` boolean
  - `environment` string
  - `last_healthy_at` string, date-time
  - `last_unhealthy_at` string, date-time
  - `last_unhealthy_code` string
  - `secretsmanager_id` string
  - `secretsmanager_key` string

---

[API](https://skmtc.net/unified/apis/unified-to-api.md) · [All operations](https://skmtc.net/unified/apis/unified-to-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unified/unified-to-api/revisions/021e9b45420a/schema)