Update Tokenset

curl --request PATCH \
  --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.patch(url, headers=headers)

print(response.text)

const options = {method: 'PATCH', 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 => "PATCH",
  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("PATCH", 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.patch("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::Patch.new(url)
request["Authorization"] = 'Bearer <token>'

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

PATCH

tokensets

{id}

Update Tokenset

curl --request PATCH \
  --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.patch(url, headers=headers)

print(response.text)

const options = {method: 'PATCH', 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 => "PATCH",
  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("PATCH", 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.patch("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::Patch.new(url)
request["Authorization"] = 'Bearer <token>'

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

Update Tokenset

Updates an existing tokenset. Only provided fields will be updated.

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

PATCH /tokensets/{id}

Authentication

Requires a valid API token in the Authorization header.

Request

Headers

Header	Value	Required
`Authorization`	Bearer token	Yes
`Content-Type`	application/json	Yes

Path Parameters

Parameter	Type	Required	Description
`id`	string	Yes	Tokenset ID

Body Parameters

Parameter	Type	Required	Description
`name`	string	No	New tokenset name (max 255 characters)
`description`	string	No	New description (null to remove)

All body parameters are optional. Only provided fields will be updated.

Request Body

{
  "name": "Brand Colors",
  "description": "Updated description"
}

Response

Success Response

Status: 200 OK

{
  "id": "tokenset-123",
  "workspace_id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Brand Colors",
  "description": "Updated description",
  "created_at": "2025-01-15T10:00:00Z",
  "updated_at": "2025-01-15T14:30:00Z"
}

Examples

curl -X PATCH https://app.tokencraft.dev/api/v1/tokensets/tokenset-123 \
  -H "Authorization: Bearer tkc_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Brand Colors",
    "description": "Primary brand color palette"
  }'

const tokensetId = 'tokenset-123';

const response = await fetch(
  `https://app.tokencraft.dev/api/v1/tokensets/${tokensetId}`,
  {
    method: 'PATCH',
    headers: {
      'Authorization': 'Bearer tkc_your_token_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      name: 'Brand Colors',
      description: 'Primary brand color palette'
    })
  }
);

const tokenset = await response.json();

tokenset_id = 'tokenset-123'

response = requests.patch(
    f'https://app.tokencraft.dev/api/v1/tokensets/{tokenset_id}',
    headers={
        'Authorization': 'Bearer tkc_your_token_here',
        'Content-Type': 'application/json'
    },
    json={
        'name': 'Brand Colors',
        'description': 'Primary brand color palette'
    }
)

tokenset = response.json()

Error Responses

400 Bad Request

{
  "error": "Name must be a non-empty string"
}

404 Not Found

{
  "error": "Tokenset not found"
}

Next Steps

Delete Tokenset

Permanently delete a tokenset

List Modes

View tokenset modes

Create Tokenset Delete Tokenset

​Update Tokenset

​Endpoint

​Authentication

​Request

​Headers

​Path Parameters

​Body Parameters

​Request Body

​Response

​Success Response

​Examples

​Error Responses

​400 Bad Request

​404 Not Found

​Next Steps

Delete Tokenset

List Modes

Update Tokenset

Endpoint

Authentication

Request

Headers

Path Parameters

Body Parameters

Request Body

Response

Success Response

Examples

Error Responses

400 Bad Request

404 Not Found

Next Steps