PUT /katello/api/repositories/:id/republish
Forces a republish of the specified repository, regenerating metadata and symlinks on the filesystem. Not allowed for repositories with the 'Complete Mirroring' mirroring policy.

Examples

PUT /katello/api/repositories/841753487/republish
{
  "repository": {}
}
400
{
  "displayMessage": "Metadata republishing is risky on 'Complete Mirroring' repositories. Change the mirroring policy and try again.\nAlternatively, use the 'force' parameter to regenerate metadata locally. On the next sync, the upstream repository's metadata will overwrite local metadata for 'Complete Mirroring' repositories.",
  "errors": [
    "Metadata republishing is risky on 'Complete Mirroring' repositories. Change the mirroring policy and try again.\nAlternatively, use the 'force' parameter to regenerate metadata locally. On the next sync, the upstream repository's metadata will overwrite local metadata for 'Complete Mirroring' repositories."
  ]
}

Params

Param name Description
id
required

Repository identifier

Validations:

  • Must be a number.
force
optional

Force metadata regeneration to proceed. Dangerous when repositories use the 'Complete Mirroring' mirroring policy

Validations:

  • Must be one of: true, false, 1, 0.