/{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

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
Body Params

Generic request model.

auth
object

Authentication credentials, which can be one of several types.

credentials
array of objects
credentials
request
object
required

This is a hack to force creation of types that extend this model, that otherwise don't have any properties but we still want the Python types for.

boolean

Whether to include raw data in the response.

page
object

Pagination parameters for requests and responses.

settings
object

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.

Response

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json