Create Workspace

Creates a new workspace within the authenticated organization.

Endpoint

POST /rest/v1/workspaces

Headers

Header	Value
Authorization	Bearer <YOUR_API_KEY>
Content-Type	application/json

Request Body

{
  "name": "Production Plant",
  "description": "Production workspace for IoT devices and monitoring.",
  "time_zone": "Asia/Calcutta",
  "currency_code": "INR"
}

Request Parameters

Field	Type	Required	Description
name	String	Yes	Name of the workspace (3–50 characters).
description	String	Yes	Description of the workspace (3–100 characters).
time_zone	String	Yes	Valid IANA time zone (e.g. Asia/Kolkata).
currency_code	String	No	ISO currency code (e.g. INR, USD).

Validation Rules

Field	Validation
name	Required. Must be between 3 and 50 characters.
description	Required. Must be between 3 and 100 characters.
time_zone	Required. Must be a valid IANA time zone.
currency_code	Optional. Must be a valid ISO 4217 currency code.

Success Response

Status: 201 Created

{
  "data": {
    "uuid": "01kkjzqprq1scsjh81ywp6wmeq",
    "name": "Production Plant",
    "time_zone": "Asia/Calcutta",
    "created_at": "2026-07-09T11:30:25Z",
    "updated_at": "2026-07-09T11:30:25Z",
    "active": true,
    "description": "Production workspace for IoT devices and monitoring.",
    "allow_manage_users": true,
    "currency_code": "INR",
    "enable_iot": true,
    "primary_language": "english",
    "secondary_language": ""
  },
  "meta": {
    "success": true,
    "message": "Workspace created successfully"
  }
}