Create Workspace

Creates a new client workspace for the agency. Agency plan required.

POST /workspaces

Create Workspace

cURL

curl --request POST \
  --url https://api.kakiyo.com/v1/workspaces \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Acme Corporation"
}
'

201

{
  "id": "workspace_abc123def456",
  "name": "Acme Corporation",
  "clientTeamId": "team_xyz789abc123",
  "createdAt": "2024-01-15T10:30:00.000Z"
}

Agency Plan Required - This endpoint is only available for teams on the Agency plan.

Endpoint

POST https://api.kakiyo.com/v1/workspaces

Request Body

Field	Type	Required	Description
name	string	Yes	Display name for the workspace

Response

{
  "id": "69724d900007cfde1d88",
  "name": "Acme Corporation",
  "clientTeamId": "69724d91000403019498",
  "createdAt": "2024-01-15T10:30:00.000Z"
}

Example Request

curl -X POST "https://api.kakiyo.com/v1/workspaces" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Acme Corporation"}'

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

name · string · required

Display name for the client workspace

Example:

"Acme Corporation"

Response

201

application/json

Workspace created successfully

A client workspace for agency management

id · string

Unique workspace identifier

Example:

"workspace_abc123def456"

name · string

Display name of the workspace

Example:

"Acme Corporation"

clientTeamId · string

Internal team identifier for client member management

Example:

"team_xyz789abc123"

createdAt · string<date-time>

Timestamp of workspace creation

Example:

"2024-01-15T10:30:00.000Z"