List allow/block rules

List Allow/Block rules

get

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.

Authorizations
Path parameters
workspaceIdstring · uuidRequired

The workspace ID

Example: b4e02c85-c6d2-4b15-8885-e09671799c61
Query parameters
limitinteger · int64Optional
pageTokenstringOptional
reversebooleanOptional
typestring · enumOptional

The type of the AllowBlockRule.

Possible values:
categorystring · enumOptional

The category of the AllowBlockRule.

Possible values:
valuestringOptional

Allow/Block value

Responses
200

A paginated list of Allow/Block rules.

application/json
Responseall of
get
GET /workspaces/{workspaceId}/conversation-allowblock-rules HTTP/1.1
Host: api.bird.com
Authorization: AccessKey YOUR_SECRET_TOKEN
Accept: */*
200

A paginated list of Allow/Block rules.

{
  "nextPageToken": "text",
  "results": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "workspaceId": "123e4567-e89b-12d3-a456-426614174000",
      "category": "all",
      "value": "text",
      "type": "allow",
      "createdBy": "123e4567-e89b-12d3-a456-426614174000",
      "createdAt": "2025-08-13T15:53:17.206Z",
      "updatedBy": "123e4567-e89b-12d3-a456-426614174000",
      "updatedAt": "2025-08-13T15:53:17.206Z"
    }
  ]
}

Examples

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

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

Last updated

Was this helpful?