Sign in

v1

latestOpenAPI 3.1.02026-07-263644911022.4 KB
Discovery

Start a connection extraction

Use this endpoint to create an extraction request for a discovered connection and submit it to Fetcher for the authenticated tenant.

post/v1/discovery/connections/{connectionId}/extractions

Path parameters

connectionIdstring required

The unique identifier of the connection.

Headers

X-Request-Idstring

A unique identifier for tracing the request across services.

Request body

tablesobject required

Tables to extract data from, keyed by table name

startDatestring

Start of the date range to extract (RFC 3339)

endDatestring

End of the date range to extract (RFC 3339)

Response

Extraction request created

idstring

Internal identifier for the extraction request

connectionIdstring

Connection this extraction was submitted to

statusstring

Current lifecycle status of the extraction

ingestionJobIdstring

Job identifier returned by Fetcher

startDatestring

Start of the extracted date range

endDatestring

End of the extracted date range

tablesobject

Per-table extraction status

errorMessagestring

Error details if the extraction failed

createdAtstring

Timestamp when the extraction was requested

updatedAtstring

Timestamp of the last status update

bridgeAttemptsinteger

Number of times the Matcher bridge pipeline has attempted to retrieve and ingest this extraction

bridgeLastErrorstring

Error class of the last bridge pipeline failure

bridgeLastErrorMessagestring

Appended-history error message from the bridge pipeline; primary failure stays at the head

bridgeFailedAtstring date-time nullable

Timestamp of the first terminal bridge failure; omitted when no failure has occurred

custodyDeletedAtstring date-time nullable

Timestamp when the custody object was deleted; omitted when still held