Coda

List permissions

开发环境

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

GET

/docs/{docId}/acl/permissions

Permissions

Returns a list of permissions for this Coda doc.

请求示例

Python

Shell

JavaScript

Java

curl --location --request GET 'http://dev-cn.your-api-server.com/docs/AbCDeFGH/acl/permissions'

响应示例

200 - 示例 1

{
    "nextPageToken": "eyJsaW1pd",
    "items": [
        {
            "principal": {
                "email": "example@domain.com",
                "type": "email"
            },
            "access": "readonly",
            "id": "string"
        }
    ],
    "href": "https://coda.io/apis/v1/docs/AbCDeFGH/acl?limit=20",
    "nextPageLink": "https://coda.io/apis/v1/docs/AbCDeFGH/acl?pageToken=eyJsaW1pd"
}

请求参数

Path 参数

docId

string

必需

ID of the doc.

示例值:

AbCDeFGH

Query 参数

limit

integer

可选

Maximum number of results to return in this query.

>= 1

默认值:

示例值:

pageToken

string

可选

An opaque token used to fetch the next page of results.

示例值:

eyJsaW1pd

返回响应

🟢200List of permissions for a doc.

application/json

Body

List of Permissions.

nextPageToken

string

可选

If specified, an opaque token used to fetch the next page of results.

示例值:

eyJsaW1pd

items

array[object (Permission) {3}]

必需

principal

Principal

必需

Metadata about a principal.

access

enum<string>

必需

Type of access.

枚举值:

readonlywritecommentnone

string

必需

Id for the Permission

href

string <url>

必需

API link to these results

示例值:

https://coda.io/apis/v1/docs/AbCDeFGH/acl?limit=20

nextPageLink

string <url>

可选

If specified, a link that can be used to fetch the next page of results.

示例值:

https://coda.io/apis/v1/docs/AbCDeFGH/acl?pageToken=eyJsaW1pd

🟠401401

🟠403403

🟠404404

🟠429429

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

Update ACL settings

Add permission