Skip to main content

Change which ref a catalog tracks, or the key it authenticates with

PUT 
/api/catalog/:local_name

Updates a catalog's connection without re-subscribing.

Exists because key rotation is inherent to private catalogs: without it, replacing an expired deploy key would mean removing the catalog and adding it again, which is a destructive way to change one setting.

Only the connection changes - the checkout is left where it is, and the next pull is what moves it onto a newly-tracked ref.

Request​

Responses​

Successful Response