Create discovery connection

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

POST /v1/discovery/connections

Create discovery connection

cURL

curl --request POST \
  --url https://matcher.sandbox.lerian.net/v1/discovery/connections \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "configName": "prod-ledger-db",
  "databaseName": "ledger",
  "databaseType": "POSTGRESQL",
  "host": "db.internal.example.com",
  "port": 5432,
  "userName": "matcher_ro",
  "password": "<string>",
  "schema": "public"
}
'

201

Example

{
  "configName": "prod-ledger-db",
  "databaseName": "ledger",
  "databaseType": "POSTGRESQL",
  "host": "db.internal.example.com",
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "lastSeenAt": "2026-06-17T14:32:05Z",
  "port": 5432,
  "schemaDiscovered": true,
  "status": "available",
  "userName": "matcher_ro",
  "baseURL": "https://sandbox.provider.example",
  "schema": "public"
}

Autorizaciones

Authorization · string · header · requerido

Bearer token authentication (format: "Bearer {token}")

Cuerpo

application/json

configName · string · requerido

Connection configuration name

Minimum string length: 1

Ejemplo:

"prod-ledger-db"

databaseName · string · requerido

Database name

Minimum string length: 1

Ejemplo:

"ledger"

databaseType · string · requerido

Database engine type; canonical token or a common alias (e.g. postgres -> POSTGRESQL, mysql -> MYSQL)

Minimum string length: 1

Ejemplo:

"POSTGRESQL"

host · string · requerido

Database host

Minimum string length: 1

Ejemplo:

"db.internal.example.com"

port · integer<int64> · requerido

Database TCP port (1-65535)

Rango requerido: 1 <= x <= 65535

Ejemplo:

5432

userName · string · requerido

Database user name the connection authenticates as

Minimum string length: 1

Ejemplo:

"matcher_ro"

password · string

schema · string

Optional schema/namespace within the database

Ejemplo:

"public"

Respuesta

201

application/json

Created

configName · string · requerido

Connection configuration name

Ejemplo:

"prod-ledger-db"

databaseName · string · requerido

Database name

Ejemplo:

"ledger"

databaseType · string · requerido

Database engine type (canonical engine token as stored)

Ejemplo:

"POSTGRESQL"

host · string · requerido

Database host; empty for REST connector connections, whose service address is reported as baseURL

Ejemplo:

"db.internal.example.com"

id · string · requerido

Internal Matcher connection identifier

Ejemplo:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

lastSeenAt · string<date-time> · requerido

Timestamp the connection was last observed healthy (RFC 3339)

Ejemplo:

"2026-06-17T14:32:05Z"

port · integer<int64> · requerido

Database port

Ejemplo:

5432

schemaDiscovered · boolean · requerido

Whether table schemas have been discovered for this connection

status · string · requerido

Current lifecycle status of the connection as reported by the extraction engine

Ejemplo:

"available"

userName · string · requerido

Database user name the connection authenticates as

Ejemplo:

"matcher_ro"

baseURL · string<uri>

Per-connection API base URL of a REST connector connection; absent when the deployment default applies and for database connectors

Ejemplo:

"https://sandbox.provider.example"

schema · string

Schema/namespace within the database, when set

Ejemplo:

"public"