Create a workspace

Enterprise Only

This endpoint is only available in the Enterprise package and requires the authenticated user to be a Super Admin.

Method: POST

URL: https://example.com/<MIXPOST_CORE_PATH>/api/panel/workspaces

Authorization: Bearer <token>

Body:

{
  "name": "My Workspace",
  "hex_color": "#6366f1",
  "owner_id": 1,
  "access_status": "unlimited"
}

Key	Format	Required	Description
name	string	required	Workspace name (max 60 characters)
hex_color	string	required	HEX color for the workspace
owner_id	integer	optional	User ID of the workspace owner
access_status	string	required	Access status: subscription, unlimited, or locked

Response:

200

{
  "uuid": "3bbd0951-5b04-432b-b2a0-688588b0720e",
  "name": "My Workspace",
  "hex_color": "#6366f1",
  "owner_id": 1,
  "owner": {
    "id": 1,
    "name": "John Doe",
    "email": "john@example.com"
  },
  "access_status": "unlimited",
  "created_at": "Jan 15, 2025 10:30 AM"
}

401

{
  "message": "Unauthenticated."
}

403

{
  "message": "Access forbidden."
}

422

{
  "message": "Validation errors",
  "errors": {}
}