Skip to main content

Check a catalog source for updates now

POST 
/catalog-sources/:id/refresh

Required role: admin. Only an account or token with the admin role can call this operation.

Example request
curl --request POST \
  --header "Authorization: Bearer $HOSERVA_TOKEN" \
  "https://$HOSERVA_HOST:8008/api/v1/catalog-sources/{id}/refresh"

Runs one check of the source and returns how it ended, as refreshCatalog does for the curated catalog (the curated id runs that same check). A user-added source is only ever fetched when it is added or refreshed here, never by the background interval. A newer archive replaces the source's copy only if it verifies the way the source was added (against its public key, or well-formed for an unsigned source) and its serial is strictly higher. Any other outcome keeps the installed copy and everything recorded about the source, and is failed with a reason and a message (200). A remembered rejection never carries over from one source to another. An unknown id is 404 catalog_source_not_found.

Request​

Responses​

The check's outcome.