Update the 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=UpdateWorkspace&Version=2023\-05\-01 ## Request parameters |**Parameter** |**Type** |**Required** |**Sample Value** |**Description** | |---|---|---|---|---| |Action |String |Yes |UpdateWorkspace |The API name. The name of the current API is `UpdateWorkspace`. | |Version |String |Yes |2023\-05\-01 |The API version. The current version of the API is `2023-05-01`. | |Id |String |Yes |18be9d623fba45a1aca409f5e19c\*\*\*\* |Workspace ID. | |Name |String |no |workspace\-demo |The workspace name.

* Any character is supported. Length is limited to 2–50 characters.

* The name must be unique within the same account. | |Description |String |no |This is a description. |Workspace description. Supports any characters, with a length limit of 0 to 256 characters. | |Visibility |String |no |Account |Workspace member visibility

* Account: Visible to all users

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

{

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

"UserId": 0

}

] |Visible to users. When the workspace visibility for members is set to "Specified", you must specify which users are visible. 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=UpdateWorkspace&Version=2023-05-01 HTTP/1.1 Content-Type: application/json { "Id": "2c7a85e4ac034eb790b096705694****", "Name": "workspace-demo", "Description": "test", "Visibility": "Account" } ``` ## Response parameters This interface does not have any unique return parameters. ## Sample response ```json HTTP/1.1 200 OK Content-Type: application/json { "ResponseMetadata": { "RequestId": "202404031138595E5D8BD124299EB9****", "Action": "UpdateWorkspace", "Version": "2023-05-01", "Service": "cp", "Region": "cn-beijing" }, "Result": {} } ``` ## Error code This API does not currently have independent error codes. If an exception occurs during API calls, refer to [the public error codes](https://www.volcengine.com/docs/6461/1271177) for troubleshooting.

Code Pipeline