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

# Update Connection

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

## Path parameters

- `connection_id` string, uuid, required

## Request body

- OpenAPIConnectionUpdate — Patch payload for an OpenAPI connection. All fields optional — unset = unchanged.
  - `auth_config_id` string, uuid, nullable — Optional MCPAuthConfig UUID for OAuth2 token rotation.
  - `base_url` string, nullable
  - `custom_headers` HeaderInput[], nullable — Replace the full custom-header set. Pass [] to clear all. Secret values are stored encrypted in the secret manager.
    - `name` string, required — HTTP header name. Allowed characters: letters, digits, '-', '_'.
    - `value` string — Header value. May not contain CR, LF, or NUL bytes.
  - `description` string, nullable
  - `name` string, nullable
  - `spec_content` object, nullable
  - `spec_url` string, nullable

## Response `200`

Successful Response

- OpenAPIConnectionResponse
  - `auth_config_id` string, uuid, nullable
  - `available_tools` object[]
  - `base_url` string, required
  - `created_at` unknown, required
  - `custom_headers` HeaderOutput[], nullable
    - `name` string, required
    - `secret` boolean, required
    - `value` string, nullable
  - `description` string, nullable
  - `id` string, uuid, required
  - `name` string, required
  - `spec_url` string, nullable
  - `status` string, required
  - `updated_at` unknown, required

## Other responses

- `422` — Validation Error

---

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