Delete Repository

Removes a repository configuration together with the whole repository content. Supported by local, remote, virtual and federated repositories.

Since: 2.3.0

Supported JFrog Subscriptions: Local, remote, and virtual repositories require a Pro subscription. Federated repositories are supported from Artifactory 7.18.3 and require an Enterprise X or Enterprise+ subscription.

Security: Requires an admin user.

Produces: application/json — structured RemoveRepositorySuccessReport or RemoveRepositoryFailureReport.

Status codes:

  • 200 — Repository config removed; all artifacts deleted successfully.
  • 202 — A delete for this repository is already in progress (deletion lock held). Response uses the success report shape; retry later.
  • 207 — Partial artifact deletion — some artifacts failed. Repository config is not removed. Delete remaining artifacts and retry.
  • 400 — Invalid repo key (blank, trash, or support-bundle repo).
  • 403 — Permission denied, validation failure, or all artifacts failed to delete.
  • 404 — Repository does not exist.
  • 409 — Import still in progress, or a Worker vetoed deletion (BEFORE_REPO_DELETE).
  • 424 — Federated repository could not be removed from remote federation members.
  • 500 — Unexpected failure or lock acquisition failure.

errors in a failure report is capped at artifact.delete.report.failure.examples.max (default 50); deleteArtifactsFailureCount reflects the true total.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

The repository key

Responses

Language
Credentials
:
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json