Create a workspace. ## Request description To achieve low latency, it is recommended that you select the corresponding service address based on the Region where your resources are located. For details, see [Service Address](https://www.volcengine.com/docs/6461/1802289). * Request method: POST * Request URL: https://cp.cn\-beijing.volcengineapi.com?Action=CreateWorkspace&Version=2023\-05\-01 ## Request parameters |**Parameter** |**Type** |**Required** |**Sample Value** |**Description** | |---|---|---|---|---| |Action |String |Yes |CreateWorkspace |The API name. The current API is named `CreateWorkspace`. | |Version |String |Yes |2023\-05\-01 |The API version. The current version of the API is `2023-05-01`. | |Name |String |Yes |workspace\-demo |Workspace name.

* Any character is supported. The length must be between 2 and 50 characters.

* The name must be unique within the same account. | |Description |String |no |Description |The workspace description can contain any characters, with a length limit of 0 to 256 characters. | |Visibility |String |Yes |Specified |Workspace visibility options

* Account: Visible to all users

* Visible to specified users | |VisibleUsers |Array of [IAMUser](https://www.volcengine.com/docs/6461/1278084#iamuser) |no |[

{

"AccountId": 24506499\*\*\*\*,

"UserId": 0

}

] |Visible user list.

When workspace member visibility is set to Specified, you must further specify the visible users. A account (main account) is required. | ### IAMUser |**Parameter** |**Type** |**Required** |**Sample Value** |**Description** | |---|---|---|---|---| |AccountId |Long |no |210048\*\*\*\* |account (main account) ID. | |UserId |Long |no |28\*\*\*\* |Sub\-user (IAM user) ID. | ## Sample requests ```json POST https://cp.cn-beijing.volcengineapi.com?Action=CreateWorkspace&Version=2023-05-01 HTTP/1.1 Content-Type: application/json { "Name": "workspace-demo", "Description": "demo", "Visibility": "Specified", "VisibleUsers": [ { "AccountId": 24506499****, "UserId": 0 } ] } ``` ## Response parameters |**Parameter** |**Type** |**Sample Value** |**Description** | |---|---|---|---| |Id |String |2c7a85e4ac034eb790b096705694\*\*\*\* |Workspace ID. | ## Sample response ```json HTTP/1.1 200 OK Content-Type: application/json { "ResponseMetadata": { "RequestId": "20230604110420****10023228002****", "Action": "CreateWorkspace", "Version": "2023-05-01", "Service": "cp", "Region": "cn-beijing" }, "Result": { "Id": "2c7a85e4ac034eb790b096705694****" } } ``` ## Error code The following table lists the error codes related to this interface and its business logic. For public error codes, see the [Public Error Codes](https://www.volcengine.com/docs/6461/1271177) documentation. |**HTTP Status Code** |**Error code** |**Error Message** |**Descriptions** | |---|---|---|---| |403 |Forbidden.{parameter} |The request is refused because it does not have access to Quota |Insufficient quota to create a workspace. Please purchase a package. |

Code Pipeline