/{connector_id}/get_data_recency
Retrieve the recency information for data surfaced by standard capabilities.
This operation enables connectors to indicate how “fresh” the data is that they surface through their standard capabilities. This is particularly important for connectors that source data from scheduled dumps, snapshots, or other non-real-time data sources.
Use Cases
- Data Freshness Assessment: Understand how current the data is from each capability
- Scheduled Data Sources: Handle connectors that read from CSV files, database snapshots, or other periodically updated data sources
- Data Quality Monitoring: Track data staleness for compliance and accuracy
Capability Recency Mapping
The response maps each standard capability to an optional datetime indicating when the data for that capability was last updated:
- Non-null datetime: Indicates the data for this capability is current as of the specified timestamp
- null datetime: Indicates the connector cannot determine or does not track recency for this capability
Connector Implementation
Connectors should implement this capability when:
- They source data from scheduled dumps or snapshots
- They can provide meaningful recency information
Connectors that always provide “live” data may return null for all capabilities or omit this capability entirely.
Data Reconciliation
Path Parameters
Body
Authenticated request.
The main request payload.
Whether to include raw data in the response.
Pagination information for the request.
Connector-specific settings for the request.
These are settings that are shared across all capabilities.
Usually contain additional required configuration options not specified by the capability schema.
The authentication credentials for the request.
Response
The request has succeeded.
- Option 1
- Option 2
Response containing data recency information for standard capabilities.
This response model wraps the DataRecency data and provides standard response metadata including success status and any error information.
Response model containing data recency information for standard capabilities.
This model maps each standard capability to an optional datetime indicating when the data for that capability was last updated or refreshed.
Pagination parameters for requests and responses.