List allow/block 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.
Authorizations
Path parameters
workspaceIdstring · uuidRequiredExample:
The workspace ID
b4e02c85-c6d2-4b15-8885-e09671799c61
Query parameters
limitinteger · int64Optional
pageTokenstringOptional
reversebooleanOptional
typestring · enumOptionalPossible values:
The type of the AllowBlockRule.
categorystring · enumOptionalPossible values:
The category of the AllowBlockRule.
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?