Update Token

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

import requests

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

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}/modes/{modeId}/tokens/{tokenId}', 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}/tokens/{tokenId}",
  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}/modes/{modeId}/tokens/{tokenId}"

	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}/modes/{modeId}/tokens/{tokenId}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

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

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}

modes

{modeId}

tokens

{tokenId}

Update Token

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

import requests

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

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}/modes/{modeId}/tokens/{tokenId}', 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}/tokens/{tokenId}",
  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}/modes/{modeId}/tokens/{tokenId}"

	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}/modes/{modeId}/tokens/{tokenId}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

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

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 Token

Updates an existing design token. 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}/modes/{modeId}/tokens/{tokenId}

Request

Path Parameters

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

Body Parameters

Parameter	Type	Required	Description
`name`	string	No	New token name
`type`	string	No	New token type
`value`	string	No	New token value
`description`	string	No	New description
`alias_to`	string	No	New alias reference

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

Response

Status: 200 OK

{
  "id": "token-123",
  "tokenset_id": "tokenset-123",
  "mode_id": "mode-light",
  "name": "colors.primary.500",
  "type": "color",
  "value": "#2563eb",
  "description": "Updated primary brand color",
  "alias_to": null,
  "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/modes/mode-light/tokens/token-123 \
  -H "Authorization: Bearer tkc_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "value": "#2563eb"
  }'

curl -X PATCH https://app.tokencraft.dev/api/v1/tokensets/tokenset-123/modes/mode-light/tokens/token-123 \
  -H "Authorization: Bearer tkc_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Updated description"
  }'

curl -X PATCH https://app.tokencraft.dev/api/v1/tokensets/tokenset-123/modes/mode-light/tokens/token-123 \
  -H "Authorization: Bearer tkc_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "value": "",
    "alias_to": "colors.blue.500"
  }'

const tokensetId = 'tokenset-123';
const modeId = 'mode-light';
const tokenId = 'token-123';

// Update value
const response = await fetch(
  `https://app.tokencraft.dev/api/v1/tokensets/${tokensetId}/modes/${modeId}/tokens/${tokenId}`,
  {
    method: 'PATCH',
    headers: {
      'Authorization': 'Bearer tkc_your_token_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      value: '#2563eb',
      description: 'Updated primary brand color'
    })
  }
);

const token = await response.json();

tokenset_id = 'tokenset-123'
mode_id = 'mode-light'
token_id = 'token-123'

response = requests.patch(
    f'https://app.tokencraft.dev/api/v1/tokensets/{tokenset_id}/modes/{mode_id}/tokens/{token_id}',
    headers={
        'Authorization': 'Bearer tkc_your_token_here',
        'Content-Type': 'application/json'
    },
    json={
        'value': '#2563eb',
        'description': 'Updated primary brand color'
    }
)

token = response.json()

Error Responses

400 Bad Request

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

{
  "error": "Type must be one of: color, dimension, ..."
}

404 Not Found

{
  "error": "Token not found"
}

Common Use Cases

1. Update Token Value

await updateToken(tokensetId, modeId, tokenId, {
  value: '#2563eb'
});

2. Change Token Type

await updateToken(tokensetId, modeId, tokenId, {
  type: 'dimension',
  value: '16px'
});

3. Convert to Alias

await updateToken(tokensetId, modeId, tokenId, {
  value: '',
  alias_to: 'colors.primary.500'
});

4. Remove Alias

await updateToken(tokensetId, modeId, tokenId, {
  value: '#3b82f6',
  alias_to: null
});

5. Batch Updates

const updates = [
  { tokenId: 'token-1', value: '#3b82f6' },
  { tokenId: 'token-2', value: '#2563eb' },
  { tokenId: 'token-3', value: '#1d4ed8' }
];

for (const { tokenId, value } of updates) {
  await updateToken(tokensetId, modeId, tokenId, { value });
}

Next Steps

Delete Token

Permanently delete a token

Get Token

Retrieve token details

Create Token Delete Token

​Update Token

​Endpoint

​Request

​Path Parameters

​Body Parameters

​Response

​Examples

​Error Responses

​400 Bad Request

​404 Not Found

​Common Use Cases

​1. Update Token Value

​2. Change Token Type

​3. Convert to Alias

​4. Remove Alias

​5. Batch Updates

​Next Steps

Delete Token

Get Token

Update Token

Endpoint

Request

Path Parameters

Body Parameters

Response

Examples

Error Responses

400 Bad Request

404 Not Found

Common Use Cases

1. Update Token Value

2. Change Token Type

3. Convert to Alias

4. Remove Alias

5. Batch Updates

Next Steps