List workspace template categories

GET/workspace-template-categories

Sample request

cURL

curl -X GET "https://api.abyssale.com/workspace-template-categories" \
  -H "x-api-key: $ABYSSALE_API_KEY"

Node.js

import abyssale from '@abyssale/sdk';

const { data, error } = await abyssale.listWorkspaceTemplateCategories();

if (error) console.error(error.id, error.message);
else console.log(data);

Python

from abyssale import Abyssale

with Abyssale() as client:
    result = client.list_workspace_template_categories()

print(result)

Example 200 response

[
  {
    "id": "1c7a9e35-0b62-4d18-8f4a-2e5c7b90d146",
    "name": "Brand assets",
    "color": "#4F46E5",
    "icon": "star",
    "created_at": 1649942114
  }
]

Example 401 error response

{
  "message": "Unauthorized: missing or invalid API key.",
  "id": "unauthorized"
}

The categories that group your workspace templates. Use an id from here as the category_id filter on GET /workspace-templates.

Behaviour, limits and caveats

This is the workspace-template counterpart of GET /projects, which groups designs.

Response 200

The categories grouping workspace templates.

Errors

Every failure uses the shared error envelope — {id, message, errors?}. Branch on id, never on message. See Errors.

Status	When
401	Unauthorized — missing or invalid API key.
429	Too Many Requests.
500	Internal Server Error — an unexpected error occurred on our side.

Related

• Workspace Templates guide