Delete tag API Reference

DELETE

/tenants/{tenant}/registries/{name}/repositories/{repository}/tags/{tag}

const url = 'https://api.kupe.cloud/api/v1/tenants/acme/registries/registry/repositories/team-a%252Fapi/tags/v1.4.2';
const options = {method: 'DELETE', headers: {Authorization: '<Authorization>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

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

Remove one tag from its image. The image and its other tags stay; an image left with no tag is listed with tagged=false until it is deleted. Admin only.

Authorizations

BearerAuth

Parameters

Path Parameters

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

tag

required

string

Tag

Responses

204

Tag deleted

400

Invalid name, repository or tag

object

code

string

error

string

field

string

message

string

severity

string

401

Missing or invalid authentication

object

code

string

error

string

field

string

message

string

severity

string

403

Admin access required

object

code

string

error

string

field

string

message

string

severity

string

404

object

code

string

error

string

field

string

message

string

severity

string

409

The tag is protected (code image_protected), the registry is not ready (code registry_not_ready) or is being deleted (code terminating)

object

code

string

error

string

field

string

message

string

severity

string

429

Rate limit exceeded

object

code

string

error

string

field

string

message

string

severity

string

503

The registry is busy or temporarily unavailable; retry

object

code

string

error

string

field

string

message

string

severity

string