Create Workspace
Creates a new workspace for the authenticated user.
PRO Plan Required - This endpoint requires a PRO or TEAM subscription plan. API write access is not available on the FREE plan.
Endpoint
Authentication
Requires a valid API token in the Authorization header.
Request
| Header | Value | Required |
|---|
Authorization | Bearer token | Yes |
Content-Type | application/json | Yes |
Body Parameters
| Parameter | Type | Required | Description |
|---|
name | string | Yes | Workspace name (max 255 characters) |
description | string | No | Optional description |
Request Body
{
"name": "Design System",
"description": "Main product design system"
}
Response
Success Response
Status: 201 Created
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "Design System",
"description": "Main product design system",
"user_id": "user-123",
"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 \
-H "Authorization: Bearer dtk_your_token_here" \
-H "Content-Type: application/json" \
-d '{
"name": "Design System",
"description": "Main product design system"
}'
Error Responses
400 Bad Request
{
"error": "Name is required and must be a non-empty string"
}
- Missing or empty
name field
name exceeds 255 characters- Invalid field types
401 Unauthorized
{
"error": "Invalid API token"
}
403 Forbidden
{
"error": "API write access requires PRO or TEAM plan. Upgrade at https://app.tokencraft.dev/pricing"
}
500 Internal Server Error
{
"error": "Internal server error"
}
Validation Rules
- name: Required, non-empty string, max 255 characters
- description: Optional string
Next Steps
