Create Tokenset

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

import requests

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

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

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

print(response.text)

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

fetch('https://app.tokencraft.dev/api/v1/workspaces/{id}/tokensets', 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/workspaces/{id}/tokensets",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  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/workspaces/{id}/tokensets"

	req, _ := http.NewRequest("POST", 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.post("https://app.tokencraft.dev/api/v1/workspaces/{id}/tokensets")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

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

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

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

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

POST

workspaces

{id}

tokensets

Create Tokenset

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

import requests

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

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

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

print(response.text)

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

fetch('https://app.tokencraft.dev/api/v1/workspaces/{id}/tokensets', 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/workspaces/{id}/tokensets",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  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/workspaces/{id}/tokensets"

	req, _ := http.NewRequest("POST", 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.post("https://app.tokencraft.dev/api/v1/workspaces/{id}/tokensets")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

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

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

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

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

Create Tokenset

Creates a new tokenset within a workspace.

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

POST /workspaces/{id}/tokensets

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	Workspace ID

Body Parameters

Parameter	Type	Required	Description
`name`	string	Yes	Tokenset name (max 255 characters)
`description`	string	No	Optional description

Request Body

{
  "name": "Colors",
  "description": "Color tokens for the design system"
}

Response

Success Response

Status: 201 Created

{
  "id": "tokenset-123",
  "workspace_id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Colors",
  "description": "Color tokens for the design system",
  "created_at": "2025-01-15T10:00:00Z",
  "updated_at": "2025-01-15T10:00:00Z"
}

Examples

curl -X POST https://app.tokencraft.dev/api/v1/workspaces/550e8400-e29b-41d4-a716-446655440000/tokensets \
  -H "Authorization: Bearer tkc_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Colors",
    "description": "Color tokens for the design system"
  }'

const workspaceId = '550e8400-e29b-41d4-a716-446655440000';

const response = await fetch(
  `https://app.tokencraft.dev/api/v1/workspaces/${workspaceId}/tokensets`,
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer tkc_your_token_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      name: 'Colors',
      description: 'Color tokens for the design system'
    })
  }
);

const tokenset = await response.json();
console.log('Created tokenset:', tokenset.id);

workspace_id = '550e8400-e29b-41d4-a716-446655440000'

response = requests.post(
    f'https://app.tokencraft.dev/api/v1/workspaces/{workspace_id}/tokensets',
    headers={
        'Authorization': 'Bearer tkc_your_token_here',
        'Content-Type': 'application/json'
    },
    json={
        'name': 'Colors',
        'description': 'Color tokens for the design system'
    }
)

tokenset = response.json()
print(f"Created tokenset: {tokenset['id']}")

Error Responses

400 Bad Request

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

404 Not Found

{
  "error": "Workspace not found"
}

Causes:

Workspace ID doesn’t exist
You do not have access to this workspace

Use Cases

1. Create Multiple Tokensets

const categories = ['Colors', 'Typography', 'Spacing', 'Shadows'];

for (const category of categories) {
  await createTokenset(workspaceId, {
    name: category,
    description: `${category} tokens`
  });
}

2. Create with Default Mode

After creating a tokenset, you may want to create modes:

const tokenset = await createTokenset(workspaceId, {
  name: 'Colors'
});

// Create light and dark modes
await createMode(tokenset.id, { name: 'Light', is_default: true });
await createMode(tokenset.id, { name: 'Dark' });

Next Steps

Update Tokenset

Update tokenset details

Create Mode

Add modes to your tokenset

Get Tokenset Update Tokenset

​Create Tokenset

​Endpoint

​Authentication

​Request

​Headers

​Path Parameters

​Body Parameters

​Request Body

​Response

​Success Response

​Examples

​Error Responses

​400 Bad Request

​404 Not Found

​Use Cases

​1. Create Multiple Tokensets

​2. Create with Default Mode

​Next Steps

Update Tokenset

Create Mode

Create Tokenset

Endpoint

Authentication

Request

Headers

Path Parameters

Body Parameters

Request Body

Response

Success Response

Examples

Error Responses

400 Bad Request

404 Not Found

Use Cases

1. Create Multiple Tokensets

2. Create with Default Mode

Next Steps