---
title: "Update Connection"
method: PATCH
path: "/api/v1/api-connections/{connection_id}"
tags: ["api-connections"]
---

# Update Connection

`PATCH /api/v1/api-connections/{connection_id}`

## Request

- Base URL: `https://api.netter.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.netter.ai/api/v1/api-connections/{connection_id}`
- Auth: none declared

## Path parameters

- `connection_id` string, uuid, required

## Request body

- ConnectionUpdate
  - `expected_version` integer, required
  - `name` string, nullable
  - `description` string, nullable
  - `documentation_url` string, nullable
  - `secret` string, password, nullable
  - `enabled` boolean, nullable

## Response `200`

Successful Response

- ConnectionRead
  - `id` string, uuid, required
  - `name` string, required
  - `description` string, required
  - `documentation_url` string, required
  - `provider` 'custom' | 'netter_anthropic', required
  - `base_url` string, required
  - `auth_type` string, required
  - `auth_name` string, required
  - `enabled` boolean, required
  - `version` integer, required
  - `created_by` string, uuid, nullable, required
  - `can_use` boolean, required
  - `can_edit` boolean, required
  - `can_manage` boolean, required
  - `grants` ConnectionGrant[]
    - `principal` 'company' | 'user' | 'group', required
    - `principal_id` string, uuid, nullable
    - `permission` 'use' | 'edit' | 'manage', required

## Other responses

- `422`: Validation Error

## Changes

> 61 revisions in range; 1 not diffed.

- **2026-10-13** `a67e7004da7f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/netter/apis/dmi-backend/changes/api/v1/api-connections/:connection_id/patch.md)

---

[API](https://skmtc.dev/netter/apis/dmi-backend.md) - [All operations](https://skmtc.dev/netter/apis/dmi-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/netter/apis/dmi-backend/revisions/68e89013efe0?raw)