Image tags

Delete an image tag

Removes one tag; org owner/admin only (write:repos for a key). The same untag as the registry’s DELETE /v2/{org}/{name}/manifests/{tag}: the name goes and the image stays, reachable by digest and by any other tag that names it.

What makes a repository convertible afterwards is the kind switch itself: PATCH to another kind first collects every image no tag reaches (a multi-arch index’s per-platform images included) and is refused with 409 kind_has_content only for images a tag still names. So delete the tags the listing shows, then switch.

DELETE

api

repos

{org}

{name}

tags

{tag}

CSharp (SDK)

using MeetKai.MKA1;
using MeetKai.MKA1.Types.Components;

var sdk = new SDK(bearerAuth: "<YOUR_BEARER_TOKEN_HERE>");

var res = await sdk.Repos.Tags.DeleteAsync(
    org: "<value>",
    name: "<value>",
    tag: "<value>"
);

// handle response

import { SDK } from "@meetkai/mka1";

const sdk = new SDK({
  bearerAuth: "<YOUR_BEARER_TOKEN_HERE>",
});

async function run() {
  await sdk.repos.tags.delete({
    org: "<value>",
    name: "<value>",
    tag: "<value>",
  });


}

run();

package main

import(
	"context"
	mka1 "github.com/MeetKai/mka1-sdks/go"
	"log"
)

func main() {
    ctx := context.Background()

    s := mka1.New(
        mka1.WithSecurity("<YOUR_BEARER_TOKEN_HERE>"),
    )

    res, err := s.Repos.Tags.Delete(ctx, "<value>", "<value>", "<value>", nil)
    if err != nil {
        log.Fatal(err)
    }
    if res != nil {
        // handle response
    }
}

const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

fetch('https://apigw.mka1.com/api/v1/repos/{org}/{name}/tags/{tag}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://apigw.mka1.com/api/v1/repos/{org}/{name}/tags/{tag}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

require 'uri'
require 'net/http'

url = URI("https://apigw.mka1.com/api/v1/repos/{org}/{name}/tags/{tag}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "correlation_id": "<string>",
  "error": "not_found"
}

{
  "correlation_id": "<string>",
  "error": "not_found"
}

{
  "correlation_id": "<string>",
  "error": "not_found"
}

{
  "correlation_id": "<string>",
  "error": "not_found"
}

Authorizations

Authorization

string

header

required

Send Authorization: Bearer , using an MKA1 API key for automation or an OAuth API access token for a signed-in application. Use a dynamic security callback to refresh OAuth access tokens. Browser session-only operations still require their declared cookie.

Headers

X-On-Behalf-Of

string

Optional external end-user identifier forwarded by the API gateway.

Path Parameters

org

string

required

The organization URL slug.

name

string

required

The repository name (URL label).

Pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$

tag

string

required

The image tag, exactly as pushed (tags are case-sensitive).

Pattern: ^[A-Za-z0-9_][A-Za-z0-9._-]{0,127}$

Response

Deleted.

⌘I

CSharp (SDK)

using MeetKai.MKA1;
using MeetKai.MKA1.Types.Components;

var sdk = new SDK(bearerAuth: "<YOUR_BEARER_TOKEN_HERE>");

var res = await sdk.Repos.Tags.DeleteAsync(
    org: "<value>",
    name: "<value>",
    tag: "<value>"
);

// handle response

import { SDK } from "@meetkai/mka1";

const sdk = new SDK({
  bearerAuth: "<YOUR_BEARER_TOKEN_HERE>",
});

async function run() {
  await sdk.repos.tags.delete({
    org: "<value>",
    name: "<value>",
    tag: "<value>",
  });


}

run();

package main

import(
	"context"
	mka1 "github.com/MeetKai/mka1-sdks/go"
	"log"
)

func main() {
    ctx := context.Background()

    s := mka1.New(
        mka1.WithSecurity("<YOUR_BEARER_TOKEN_HERE>"),
    )

    res, err := s.Repos.Tags.Delete(ctx, "<value>", "<value>", "<value>", nil)
    if err != nil {
        log.Fatal(err)
    }
    if res != nil {
        // handle response
    }
}

const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

fetch('https://apigw.mka1.com/api/v1/repos/{org}/{name}/tags/{tag}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://apigw.mka1.com/api/v1/repos/{org}/{name}/tags/{tag}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

require 'uri'
require 'net/http'

url = URI("https://apigw.mka1.com/api/v1/repos/{org}/{name}/tags/{tag}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "correlation_id": "<string>",
  "error": "not_found"
}

{
  "correlation_id": "<string>",
  "error": "not_found"
}

{
  "correlation_id": "<string>",
  "error": "not_found"
}

{
  "correlation_id": "<string>",
  "error": "not_found"
}

Overview

Responses and conversations

Models and routing

Images and audio

Files and retrieval

Agents

Tools and sandbox

Evals and feedback

Compute

Repositories

Dataset generations

Organizations and access

Usage and budgets

Application utilities

Analytics

Legacy APIs

Additional APIs

Delete an image tag

Authorizations

Headers

Path Parameters

Response