List Modes

Get all modes for a tokenset

List Modes

Retrieves all modes (themes/variations) for a specific tokenset.

Endpoint

GET /api/v1/tokensets/{id}/modes

Request

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	Tokenset ID

Response

Status: 200 OK

{
  "modes": [
    {
      "id": "mode-light",
      "tokenset_id": "tokenset-123",
      "name": "Light",
      "is_default": true,
      "created_at": "2025-01-15T10:00:00Z",
      "updated_at": "2025-01-15T10:00:00Z"
    },
    {
      "id": "mode-dark",
      "tokenset_id": "tokenset-123",
      "name": "Dark",
      "is_default": false,
      "created_at": "2025-01-15T10:05:00Z",
      "updated_at": "2025-01-16T14:30:00Z"
    }
  ],
  "total": 2
}

Response Fields

Field	Type	Description
modes	array	Array of mode objects
total	number	Total number of modes

Mode Object

Field	Type	Description
id	string	Unique mode identifier
tokenset_id	string	Parent tokenset ID
name	string	Mode name (e.g., “Light”, “Dark”)
is_default	boolean	Whether this is the default mode
created_at	string	ISO 8601 timestamp
updated_at	string	ISO 8601 timestamp

Examples

cURL

curl -H "Authorization: Bearer dtk_your_token_here" \
  https://app.tokencraft.dev/api/v1/tokensets/tokenset-123/modes

Next Steps

Get Tokens

List tokens in a mode

Export Mode

Export a specific mode