Get connection schema history

Use this endpoint to list the earlier generations of a connection’s schema map, oldest first. Each generation records when it stopped being the live schema map, and retirementCause records what Matcher observed when it retired it.

GET /v1/discovery/connections/{connectionId}/schema/history

Get connection schema history

cURL

curl --request GET \
  --url https://matcher.sandbox.lerian.net/v1/discovery/connections/{connectionId}/schema/history \
  --header 'Authorization: Bearer <token>'

200

Example

{ "connectionId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "generations": [ { "archivedAt": "2026-07-15T12:30:00Z", "tables": [ { "columns": [ { "name": "amount", "nullable": true, "type": "numeric" } ], "tableName": "transactions", "columnsNarrowed": true, "columnsStale": true, "notYetExtractableReason": "COLUMNS_NOT_ENUMERATED", "retirementCause": "ABSENT_FROM_CATALOG" } ], "fieldReport": "SAMPLED", "retirementCause": "ABSENT_FROM_CATALOG" } ] }

Autorizaciones

Authorization · string · header · requerido

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

Parámetros de ruta

connectionId · string<uuid> · requerido

Connection ID (UUID)

Ejemplo:

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

Respuesta

200

application/json

OK

connectionId · string · requerido

Internal Matcher connection identifier the history belongs to

Ejemplo:

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

generations · object[] | null · requerido

Prior generations of the schema map, oldest first; empty when the map has never changed

Show child attributes