Delete Mode

curl --request DELETE \
  --url https://app.tokencraft.dev/api/v1/tokensets/{id}/modes/{modeId} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.tokencraft.dev/api/v1/tokensets/{id}/modes/{modeId}"

headers = {"Authorization": "Bearer <token>"}

response = requests.delete(url, headers=headers)

print(response.text)

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

fetch('https://app.tokencraft.dev/api/v1/tokensets/{id}/modes/{modeId}', 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://app.tokencraft.dev/api/v1/tokensets/{id}/modes/{modeId}",
  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;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.tokencraft.dev/api/v1/tokensets/{id}/modes/{modeId}"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.delete("https://app.tokencraft.dev/api/v1/tokensets/{id}/modes/{modeId}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.tokencraft.dev/api/v1/tokensets/{id}/modes/{modeId}")

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

DELETE

tokensets

{id}

modes

{modeId}

Delete Mode

curl --request DELETE \
  --url https://app.tokencraft.dev/api/v1/tokensets/{id}/modes/{modeId} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.tokencraft.dev/api/v1/tokensets/{id}/modes/{modeId}"

headers = {"Authorization": "Bearer <token>"}

response = requests.delete(url, headers=headers)

print(response.text)

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

fetch('https://app.tokencraft.dev/api/v1/tokensets/{id}/modes/{modeId}', 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://app.tokencraft.dev/api/v1/tokensets/{id}/modes/{modeId}",
  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;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.tokencraft.dev/api/v1/tokensets/{id}/modes/{modeId}"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.delete("https://app.tokencraft.dev/api/v1/tokensets/{id}/modes/{modeId}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.tokencraft.dev/api/v1/tokensets/{id}/modes/{modeId}")

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

Delete Mode

Permanently deletes a mode and all its associated tokens. This action cannot be undone.

Write access policy - This endpoint requires the write:tokens scope.

TEAM-owned workspace: owner, admin, editor can write; viewer is blocked (403).
Non-TEAM workspace: only the workspace owner can write.
If the workspace owner plan has no API write access (for example FREE), write is blocked.

Endpoint

DELETE /tokensets/{id}/modes/{modeId}

Request

Path Parameters

Parameter	Type	Required	Description
`id`	string	Yes	Tokenset ID
`modeId`	string	Yes	Mode ID

Response

Status: 200 OK

{
  "message": "Mode deleted successfully"
}

Examples

curl -X DELETE https://app.tokencraft.dev/api/v1/tokensets/tokenset-123/modes/mode-dark \
  -H "Authorization: Bearer tkc_your_token_here"

const tokensetId = 'tokenset-123';
const modeId = 'mode-dark';

const response = await fetch(
  `https://app.tokencraft.dev/api/v1/tokensets/${tokensetId}/modes/${modeId}`,
  {
    method: 'DELETE',
    headers: {
      'Authorization': 'Bearer tkc_your_token_here'
    }
  }
);

const result = await response.json();
console.log(result.message);

tokenset_id = 'tokenset-123'
mode_id = 'mode-dark'

response = requests.delete(
    f'https://app.tokencraft.dev/api/v1/tokensets/{tokenset_id}/modes/{mode_id}',
    headers={'Authorization': 'Bearer tkc_your_token_here'}
)

result = response.json()
print(result['message'])

Error Responses

400 Bad Request

{
  "error": "Cannot delete the last mode in a tokenset"
}

A tokenset must always have at least one mode. You cannot delete the last remaining mode.

404 Not Found

{
  "error": "Mode not found"
}

Cascade Deletion

When a mode is deleted:

✅ All tokens in the mode are deleted

This operation is irreversible. All data will be permanently deleted. Export tokens before deletion if you need a backup.

Restrictions

Cannot Delete Last Mode

// This will fail if only one mode exists
await deleteMode(tokensetId, lastModeId);
// Error: Cannot delete the last mode in a tokenset

Solution: Create a new mode before deleting:

// Create new mode first
const newMode = await createMode(tokensetId, { name: 'New Mode', is_default: true });

// Then delete old mode
await deleteMode(tokensetId, oldModeId);

Best Practices

Export Before Deletion

async function safeDeleteMode(tokensetId, modeId) {
  // Export mode first
  await exportMode(tokensetId, modeId, 'json');
  
  // Then delete
  await deleteMode(tokensetId, modeId);
}

Next Steps

Export Mode

Export before deletion

Create Mode

Create a new mode

Update Mode List Tokens

​Delete Mode

​Endpoint

​Request

​Path Parameters

​Response

​Examples

​Error Responses

​400 Bad Request

​404 Not Found

​Cascade Deletion

​Restrictions

​Cannot Delete Last Mode

​Best Practices

​Export Before Deletion

​Next Steps

Export Mode

Create Mode

Delete Mode

Endpoint

Request

Path Parameters

Response

Examples

Error Responses

400 Bad Request

404 Not Found

Cascade Deletion

Restrictions

Cannot Delete Last Mode

Best Practices

Export Before Deletion

Next Steps