List Workspaces

curl --request GET \
  --url https://app.tokencraft.dev/api/v1/workspaces \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.tokencraft.dev/api/v1/workspaces"

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

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

print(response.text)

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

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

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

require 'uri'
require 'net/http'

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

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

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

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

GET

workspaces

List Workspaces

curl --request GET \
  --url https://app.tokencraft.dev/api/v1/workspaces \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.tokencraft.dev/api/v1/workspaces"

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

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

print(response.text)

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

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

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

require 'uri'
require 'net/http'

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

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

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

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

List Workspaces

Retrieves all workspaces visible to the authenticated token user. For TEAM-owned workspaces, this includes owned + shared workspaces where the caller is a member. For non-TEAM-owned workspaces, visibility remains owner-only.

Endpoint

GET /workspaces

Authentication

Requires a valid API token in the Authorization header.

Authorization: Bearer tkc_your_token_here

Request

Headers

Header	Value	Required
`Authorization`	Bearer token	Yes

Parameters

None

Response

Success Response

Status: 200 OK

{
  "workspaces": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Design System",
      "description": "Main product design system",
      "user_id": "user-123",
      "user_role": "owner",
      "is_owner": true,
      "created_at": "2025-01-15T10:00:00Z",
      "updated_at": "2025-01-15T10:00:00Z"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "name": "Marketing Site",
      "description": "Marketing website tokens",
      "user_id": "owner-456",
      "user_role": "editor",
      "is_owner": false,
      "created_at": "2025-01-10T08:30:00Z",
      "updated_at": "2025-01-14T16:45:00Z"
    }
  ],
  "total": 2
}

Response Fields

Field	Type	Description
`workspaces`	array	Array of workspace objects
`total`	number	Total number of workspaces

Workspace Object

Field	Type	Description
`id`	string	Unique workspace identifier
`name`	string	Workspace name
`description`	string\|null	Optional description
`user_id`	string	Owner’s user ID
`user_role`	`"owner"\|"admin"\|"editor"\|"viewer"`	Caller role in this workspace
`is_owner`	boolean	`true` when caller role is owner
`created_at`	string	ISO 8601 timestamp
`updated_at`	string	ISO 8601 timestamp

Examples

curl -H "Authorization: Bearer tkc_your_token_here" \
  https://app.tokencraft.dev/api/v1/workspaces

const token = 'tkc_your_token_here';

const response = await fetch('https://app.tokencraft.dev/api/v1/workspaces', {
  headers: {
    'Authorization': `Bearer ${token}`
  }
});

const data = await response.json();
console.log(data.workspaces);

import requests

token = 'tkc_your_token_here'

response = requests.get(
    'https://app.tokencraft.dev/api/v1/workspaces',
    headers={'Authorization': f'Bearer {token}'}
)

data = response.json()
print(data['workspaces'])

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    token := "tkc_your_token_here"
    
    client := &http.Client{}
    req, _ := http.NewRequest("GET", "https://app.tokencraft.dev/api/v1/workspaces", nil)
    req.Header.Set("Authorization", "Bearer "+token)
    
    resp, _ := client.Do(req)
    defer resp.Body.Close()
    
    var data map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&data)
    fmt.Println(data["workspaces"])
}

Error Responses

401 Unauthorized

{
  "error": "Invalid API token"
}

500 Internal Server Error

{
  "error": "Internal server error"
}

Use Cases

1. Initial App Load

Fetch all workspaces when user opens your application:

async function loadWorkspaces() {
  const data = await fetch(url, { headers }).then(r => r.json());
  
  // Display in UI
  renderWorkspaceSelector(data.workspaces);
  
  // Store in state
  store.dispatch(setWorkspaces(data.workspaces));
}

2. Workspace Selector

Build a dropdown menu:

function WorkspaceSelector({ workspaces }) {
  return (
    <select>
      {workspaces.map(ws => (
        <option key={ws.id} value={ws.id}>
          {ws.name}
        </option>
      ))}
    </select>
  );
}

3. Check for Workspaces

Verify user has created workspaces:

const { workspaces, total } = await getWorkspaces();

if (total === 0) {
  showOnboarding('Create your first workspace!');
}

Rate Limiting

This endpoint counts toward your rate limit of 100 requests per minute. See Rate Limits for details.

Next Steps

Get Workspace

Get details of a specific workspace

Get Tokensets

List tokensets in a workspace

Rate Limits Create Workspace

​List Workspaces

​Endpoint

​Authentication

​Request

​Headers

​Parameters

​Response

​Success Response

​Response Fields

​Workspace Object

​Examples

​Error Responses

​401 Unauthorized

​500 Internal Server Error

​Use Cases

​1. Initial App Load

​2. Workspace Selector

​3. Check for Workspaces

​Rate Limiting

​Next Steps

Get Workspace

Get Tokensets

List Workspaces

Endpoint

Authentication

Request

Headers

Parameters

Response

Success Response

Response Fields

Workspace Object

Examples

Error Responses

401 Unauthorized

500 Internal Server Error

Use Cases

1. Initial App Load

2. Workspace Selector

3. Check for Workspaces

Rate Limiting

Next Steps