Refresh a registry

Re-fetches the registry’s well-known document to confirm it is reachable and still advertises a supported capability, then stamps lastSyncedAt. The stored id is never changed, even if the registry now advertises a different one.

POST /registries/{id}/refresh

Refresh a registry

cURL

curl --request POST \
  --url http://localhost:9371/registries/{id}/refresh

200

{
  "id": "<string>",
  "baseUrl": "<string>",
  "lastSyncedAt": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "authType": "apiKey",
  "tokenExpiresAt": 123
}

Path Parameters

id · string · required

Registry slug identifying the registry.

Minimum string length: 1

Response

200

application/json

The updated registry record.

Record of a registered registry.

id · string · required

Registry slug matching /^[A-Za-z0-9_-]+$/ used as the primary key.

Minimum string length: 1

baseUrl · string · required

Normalized absolute http(s) URL of the registry.

lastSyncedAt · string | null · required

ISO-8601 timestamp of the last successful sync with the registry, or null when it has never been synced.

createdAt · string · required

ISO-8601 timestamp of when the registry was registered.

updatedAt · string · required

ISO-8601 timestamp of the last mutation to the record.

authType · enum<string> | null · required

Authentication method configured for this registry, or null when none is set.

Available options: apiKey, oauth2, null

tokenExpiresAt · number | null · required

Epoch-ms timestamp when the cached OAuth2 access token expires, or null for api key auth or when no token has been fetched.