Lineage providers

List evidence provider instances and pause or resume acquisition.

A provider instance is one evidence feed attached to a connector, such as query_log or google_data_lineage. These routes inspect provider health and control acquisition. To control which admitted evidence is served, use the lineage policy instead.

GET /v1/lineage/providers

Lists provider instances with their health counters. Requires a read-scoped token and workspace access.

ParameterRequiredDescription
workspace_idYesWorkspace to list providers for.
connector_idNoLimit to one connector.
statusNoactive, paused, disabled, or error.
limitNo1 to 200, default 50.
cursorNonext_cursor from the previous page.
curl --get "https://api.embrasure.ai/v1/lineage/providers" \
  --header "Authorization: Bearer $EMBRASURE_API_TOKEN" \
  --data-urlencode "workspace_id=$WORKSPACE_ID" \
  --data-urlencode "connector_id=$CONNECTOR_ID"

Each item includes the provider identity (id, connector_id, provider_type, display_name, status, capabilities), receipt and processing timestamps (last_event_at, last_received_at, last_accepted_at, last_processed_at, last_success_at, last_error_at, event_watermark), and health counters (backlog_count, oldest_backlog_at, invalid_item_count, unresolved_asset_count, open_gap_count). The response is paginated through next_cursor.

PATCH /v1/lineage/providers/{provider_instance_id}

Pause or resume acquisition for one provider instance. Requires an admin-scoped token and workspace admin role. Pausing stops new intake; previously accepted evidence is not deleted.

{"workspace_id": "workspace-1", "status": "paused"}

status accepts active, paused, or disabled. error is reported by the list route but cannot be set.

Coverage gaps

Detected delivery gaps for one provider are served by GET /v1/lineage/providers/{provider_instance_id}/gaps.