---
title: "Update discovery connection"
method: PATCH
path: "/v1/discovery/connections/{connectionId}"
tags: ["Discovery"]
---

# Update discovery connection

`PATCH /v1/discovery/connections/{connectionId}`

Updates a Matcher-owned Fetcher connection and synchronizes the local discovery cache.

## Path parameters

- `connectionId` string, uuid, required — Matcher connection ID

## Request body

- ConnectionUpdateRequest
  - `configName` string — Connection configuration name
  - `databaseName` string — Database name
  - `databaseType` string — Database engine type; canonical token or a common alias (e.g. postgres -> POSTGRESQL, mysql -> MYSQL)
  - `host` string — Database host
  - `password` string
  - `port` integer — Database TCP port (1-65535)
  - `schema` string — Optional schema/namespace within the database
  - `userName` string — Database user name the connection authenticates as

## Response `200`

OK

- ConnectionResponse — A discovered Fetcher database connection
  - `id` string — Internal identifier for the connection
  - `configName` string — Name of the Fetcher configuration that produced this connection
  - `databaseType` string — Type of database (e.g. postgres, mysql)
  - `status` string — Current connection status
  - `schemaDiscovered` boolean — Whether the table schema has been discovered for this connection
  - `lastSeenAt` string — Timestamp when this connection was last observed in Fetcher

## Other responses

- `default` — Error

---

[API](https://skmtc.net/lerian/apis/identity-plugin.md) · [All operations](https://skmtc.net/lerian/apis/identity-plugin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lerian/identity-plugin/versions/25daba385532/schema)