Coda

Add permission

开发环境

http://dev-cn.your-api-server.com

POST

/docs/{docId}/acl/permissions

Permissions

Adds a new permission to the doc.

请求示例

Python

Shell

JavaScript

Java

curl --location --request POST 'http://dev-cn.your-api-server.com/docs/AbCDeFGH/acl/permissions' \
--header 'Content-Type: application/json' \
--data-raw '{
    "access": "readonly",
    "principal": {
        "email": "example@domain.com",
        "type": "email"
    },
    "suppressEmail": true
}'

响应示例

200 - 示例 1

{}

请求参数

Path 参数

docId

string

必需

ID of the doc.

示例值:

AbCDeFGH

Body 参数application/json

Payload for granting a new permission.

access

enum<string>

必需

Type of access (excluding none).

枚举值:

readonlywritecomment

principal

AddedPrincipal

必需

Metadata about a principal to add to a doc.

string

必需

Email for the principal.

示例值:

example@domain.com

type

enum<string>

必需

The type of this principal.

枚举值:

suppressEmail

boolean

可选

When true suppresses email notification

示例

返回响应

🟢200Confirmation that the request was applied.

application/json

Body

object {0}

🟠400400

🟠401401

🟠403403

🟠404404

🟠429429

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

List permissions

Content export status