Sources

Per-source freshness map

Changed on

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

Request

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

    • breaking

      the response property became nullable for the status

    • breaking

      the / response's property type changed from string to string null, and format from date to date-time for status

    • breaking

      the // response's property type changed from string to string null, and format from no format to uri for status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      added the new current enum value to the / response property for the response status

    • info

      api operation id getSourcesFreshness was added

    • info

      the endpoint scheme security apiKey was added to the API

    • info

      the endpoint scheme security bearerAuth was added to the API

    • info

      added the new optional header request parameter If-None-Match

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      the response property // became required for the status

    • info

      removed the fresh enum value from the / response property for the response status

    • info

      removed the recent enum value from the / response property for the response status

    • info

      removed the very_stale enum value from the / response property for the response status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      added the new empty enum value to the // response property for the response status

    • warning

      added the new recent enum value to the // response property for the response status

    • warning

      added the new static enum value to the // response property for the response status

    • warning

      added the new very_stale enum value to the // response property for the response status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status