Start a connection extraction
Use this endpoint to create an extraction request for a discovered connection and submit it to the extraction engine for the authenticated tenant.
Authorizations
Bearer token authentication (format: "Bearer {token}")
Headers
A unique identifier for tracing the request across services.
Path Parameters
The unique identifier of the connection. Connection ID (UUID)
"3fa85f64-5717-4562-b3fc-2c963f66afa6"
Body
Extraction request payload
Per-table extraction configuration keyed by table name; at least one entry required
Optional inclusive end date (RFC 3339); must be on or after startDate
"2026-06-30"
Optional extraction filters
Optional inclusive start date (RFC 3339)
"2026-06-01"
Response
Extraction request created
Connection the extraction runs against
"3fa85f64-5717-4562-b3fc-2c963f66afa6"
Timestamp the extraction request was created (RFC 3339)
"2026-06-17T14:32:05Z"
Internal extraction request identifier
"3fa85f64-5717-4562-b3fc-2c963f66afa6"
Current lifecycle status of the extraction request
"pending"
Per-table extraction configuration keyed by table name
Timestamp the extraction request was last updated (RFC 3339)
"2026-06-17T14:32:05Z"
Inclusive end date of the extracted range (RFC 3339)
"2026-06-30"
Sanitized error message when the extraction failed; empty otherwise
Extraction filters applied to the request, when set
Ingestion job created from the extracted data, once available
"3fa85f64-5717-4562-b3fc-2c963f66afa6"
Inclusive start date of the extracted range (RFC 3339)
"2026-06-01"

