Delete Tokenset

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

import requests

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

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}', 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}",
  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}"

	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}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

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

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}

Delete Tokenset

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

import requests

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

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}', 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}",
  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}"

	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}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

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

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 Tokenset

Permanently deletes a tokenset and all its associated modes and 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}

Authentication

Requires a valid API token in the Authorization header.

Request

Headers

Header	Value	Required
`Authorization`	Bearer token	Yes

Path Parameters

Parameter	Type	Required	Description
`id`	string	Yes	Tokenset ID

Response

Success Response

Status: 200 OK

{
  "message": "Tokenset deleted successfully"
}

Examples

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

const tokensetId = 'tokenset-123';

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

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

tokenset_id = 'tokenset-123'

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

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

Error Responses

404 Not Found

{
  "error": "Tokenset not found"
}

Cascade Deletion

When a tokenset is deleted, the following are also deleted:

✅ All modes in the tokenset
✅ All tokens in those modes

This operation is irreversible. All data will be permanently deleted. Make sure to export your tokens before deletion if you need a backup.

Best Practices

Export Before Deletion

async function safeDeleteTokenset(tokensetId) {
  // Export all modes first
  const modes = await getModes(tokensetId);
  
  for (const mode of modes) {
    await exportMode(tokensetId, mode.id, 'json');
  }
  
  // Then delete
  await deleteTokenset(tokensetId);
}

Next Steps

Export Tokenset

Export before deletion

Create Tokenset

Create a new tokenset

Update Tokenset List Modes

​Delete Tokenset

​Endpoint

​Authentication

​Request

​Headers

​Path Parameters

​Response

​Success Response

​Examples

​Error Responses

​404 Not Found

​Cascade Deletion

​Best Practices

​Export Before Deletion

​Next Steps

Export Tokenset

Create Tokenset

Delete Tokenset

Endpoint

Authentication

Request

Headers

Path Parameters

Response

Success Response

Examples

Error Responses

404 Not Found

Cascade Deletion

Best Practices

Export Before Deletion

Next Steps