Skip to content

Delete repository API Reference

DELETE
/tenants/{tenant}/registries/{name}/repositories/{repository}
curl --request DELETE \
--url https://api.kupe.cloud/api/v1/tenants/acme/registries/registry/repositories/team-a%252Fapi \
--header 'Authorization: <Authorization>'

Delete a repository and every image and tag in it. They cannot be restored. The storage is freed when the registry’s weekly clean-up runs. Admin only.

tenant
required
string

Tenant name

name
required
string

Registry name: always registry

repository
required
string

Repository name without the registry and tenant, with each / encoded as %2F

Repository deleted

Invalid name or repository

object
code
string
error
string
field
string
message
string
severity
string

Missing or invalid authentication

object
code
string
error
string
field
string
message
string
severity
string

Admin access required

object
code
string
error
string
field
string
message
string
severity
string
object
code
string
error
string
field
string
message
string
severity
string

The registry is not ready yet (code registry_not_ready) or is being deleted (code terminating)

object
code
string
error
string
field
string
message
string
severity
string

Rate limit exceeded

object
code
string
error
string
field
string
message
string
severity
string

The registry is busy or temporarily unavailable; retry

object
code
string
error
string
field
string
message
string
severity
string