Sources

Per-source freshness map

Return a minimized freshness projection only for sources authorized by the versioned public-source catalog. The timestamp comes from the offline projection, never request time. Its ETag is bound to the shared asv1 stats generation and uses 60-second must-revalidate caching. Unknown, review and restricted sources are omitted. Connector health, errors, schedules and row counts are never exposed.

get/api/v1/sources/freshness

Headers

If-None-Matchstring

Optional RFC 9110 entity-tag validator. Weak validators, comma-separated validator lists and * are accepted.

Response

Freshness map

generated_atstring date-time nullable

Offline projection generation time; null only for a legacy cache without provenance.

source_catalog_versionstring

countinteger

_legal_noticestring

Changes

Changed in 1 of the 3 revisions of this API.3822

Jul 26, 2026996f96a117583822See the full diff
- ▲
  the response property became nullable for the status
  response-property-became-nullable
- ▲
  the / response's property type changed from string to string null, and format from date to date-time for status
  response-property-type-changed
- ▲
  the // response's property type changed from string to string null, and format from no format to uri for status
  response-property-type-changed
- ●
  removed the optional property // from the response with the status
  response-optional-property-removed
- ●
  removed the optional property // from the response with the status
  response-optional-property-removed
- ●
  removed the optional property // from the response with the status
  response-optional-property-removed
- ●
  removed the optional property // from the response with the status
  response-optional-property-removed
- ●
  removed the optional property // from the response with the status
  response-optional-property-removed
- ●
  removed the optional property // from the response with the status
  response-optional-property-removed
- ●
  removed the optional property // from the response with the status
  response-optional-property-removed
- ●
  added the new current enum value to the / response property for the response status
  response-property-enum-value-added
- ○
  api operation id getSourcesFreshness was added
  api-operation-id-added
- ○
  the endpoint scheme security apiKey was added to the API
  api-security-added
- ○
  the endpoint scheme security bearerAuth was added to the API
  api-security-added
- ○
  added the new optional header request parameter If-None-Match
  new-optional-request-parameter
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  added the non-success response with the status
  response-non-success-status-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  the response property // became required for the status
  response-property-became-required
- ○
  the response property // became required for the status
  response-property-became-required
- ○
  the response property // became required for the status
  response-property-became-required
- ○
  the response property // became required for the status
  response-property-became-required
- ○
  removed the fresh enum value from the / response property for the response status
  response-property-enum-value-removed
- ○
  removed the recent enum value from the / response property for the response status
  response-property-enum-value-removed
- ○
  removed the very_stale enum value from the / response property for the response status
  response-property-enum-value-removed
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
- ○
  added the required property // to the response with the status
  response-required-property-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history