Updates user role

开发环境

POST

/workspaces/{workspaceId}/users/role

Workspaces

Updates the workspace user role of a user that matches the parameters. Only succeeds if the requesting user has admin permissions in the workspace.

请求示例

Python

Shell

JavaScript

Java

curl --location --request POST 'http://dev-cn.your-api-server.com/workspaces/ws-1Ab234/users/role' \
--header 'Content-Type: application/json' \
--data-raw '{
    "newRole": "Admin",
    "email": "hello@coda.io"
}'

响应示例

200 - 示例 1

{
  "roleChangedAt": "2018-04-11T00:18:57.946Z"
}

请求参数

Path 参数

workspaceId

string

必需

ID of the workspace.

示例值:

ws-1Ab234

Body 参数application/json

Parameters for changing a workspace user role.

newRole

enum<string>

必需

枚举值:

AdminDocMakerEditor

string

必需

Email of the user.

示例值:

hello@coda.io

示例

返回响应

🟢200User's info that was updated.

application/json

Body

The result of changing a user's workspace user role.

roleChangedAt

string <date-time>

必需

Timestamp for when the user's role last changed in this workspace.

示例值:

2018-04-11T00:18:57.946Z

🟠401401

🟠403403

🟠404404

🟠429429

修改于 2024-03-20 08:13:15

List workspace roles

List Packs