---
title: "Update Connection"
method: PUT
path: "/api/connections/{id}"
tags: ["Connections"]
---

# Update Connection

`PUT /api/connections/{id}`

Updates a connection's configuration.

Updating a connection is a **full replacement** of its configuration. Any
`configuration` field you omit is cleared. To make a partial change, fetch
the current connection with
[`GET /api/connections/{id}`](../../../api-reference/connections/get), apply your edits, and send the
complete object back.

> 📘 The connection is re-validated against the upstream service after every
> update. The request will fail if the new credentials or endpoint cannot be
> reached.

Syncs that are already running when the update is submitted are not
interrupted; the updated configuration takes effect on their next execution.

## Path parameters

- `id` string, uuid, required

## Headers

- `X-Polytomic-Version` string

## Request body

- UpdateConnectionRequestSchema
  - `configuration` object, required
  - `healthcheck_interval` string — Override interval for connection health checking.
  - `name` string, required
  - `organization_id` string, uuid, nullable
  - `policies` string[], nullable
  - `reconnect` boolean
  - `type` string
  - `validate` boolean — Validate connection configuration.

## Response `200`

OK

- CreateConnectionResponseEnvelope
  - `data` CreateConnectionResponseSchema
    - `auth_code` string — Code to enter in order to complete connection authentication.
    - `auth_url` string — URL to visit to complete connection authentication.
    - `configuration` object, nullable
    - `healthcheck_interval` string — Interval for connection health checking.
    - `id` string, uuid
    - `name` string
    - `organization_id` string, uuid
    - `policies` string[]
    - `saved` boolean
    - `status` string
    - `status_error` string
    - `type` ConnectionTypeSchema
      - `id` string
      - `logo_dark_url` string
      - `logo_url` string
      - `name` string
      - `operations` string[], nullable

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.net/polytomic/apis/polytomic-api.md) · [All operations](https://skmtc.net/polytomic/apis/polytomic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/polytomic/polytomic-api/versions/5e9bcd4cfb2d/schema)