---
title: "Create discovery connection"
method: POST
path: "/v1/discovery/connections"
tags: ["Discovery"]
---

# Create discovery connection

`POST /v1/discovery/connections`

Provisions a Fetcher connection scoped to Matcher and synchronizes the local discovery cache.

## Request body

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

## Response `201`

Created

- 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)