List allow/block rules

GET

/workspaces/{workspaceId}/conversation-allowblock-rules

List allow/block rules. This will return a maximum of 100 rules per page, with 10 as default. You can use the limit and pageToken query parameters to paginate the results. Learn more about pagination in the Common API Usage pagination section.

查询参数

limit

integer

pageToken

string

reverse

boolean

type

string

Allow/Block type

Possible values: allow, reject, suspend

category

string

Allow/Block category

Possible values: all, domain, domain_suffix, email

value

string

Allow/Block value

响应载荷

nextPageToken

string

The token to fetch the next page of results. If empty, there are no more results to fetch.

results

array of object

必填

显示子属性

results.category

string

必填

The category of the AllowBlockRule.

Possible values: all, domain, domain_suffix, email

results.createdAt

string

必填

results.createdBy

string

必填

results.id

string

必填

results.type

string

必填

The type of the AllowBlockRule.

Possible values: allow, reject, suspend

results.updatedAt

string

必填

results.updatedBy

string

必填

results.value

string

必填

results.workspaceId

string

必填

代码示例

curl -X GET 'https://api.bird.com/workspaces/{workspaceId}/conversation-allowblock-rules' \
  -H 'Authorization: AccessKey YOUR_ACCESS_KEY'

Examples

代码示例

curl "https://api.bird.com/workspaces/e58899bf-1e8d-4ff7-b9db-a60befaf90d2/conversation-allowblock-rules" \
-H "Authorization: AccessKey abcd"

代码示例

{
  "results": [
    {
      "id": "01937899-aa2c-7224-bf2b-db9ca8f6362c",
      "workspaceId": "6b1908bd-2bc7-409e-bab4-ccfcd3ec69b9",
      "category": "email",
      "value": "test@example.com",
      "type": "allow",
      "createdBy": "00000000-0000-0000-0000-000000000000",
      "createdAt": "2024-11-29T15:45:56.780546536Z",
      "updatedBy": "00000000-0000-0000-0000-000000000000",
      "updatedAt": "2024-11-29T15:45:56.780546536Z"
    },
    {
      "id": "01937888-e7c4-79dd-af1f-c00d91a0f3a6",
      "workspaceId": "6b1908bd-2bc7-409e-bab4-ccfcd3ec69b9",
      "category": "domain",
      "value": "test.com",
      "type": "reject",
      "createdBy": "00000000-0000-0000-0000-000000000000",
      "createdAt": "2024-11-29T15:27:38.436082756Z",
      "updatedBy": "00000000-0000-0000-0000-000000000000",
      "updatedAt": "2024-11-29T15:27:38.436082756Z"
    }
  ]
}

Note: if there are more than 10 allow/block rules, the results may be paginated. Please refer to Pagination on how to use nextPageToken.