curl --request GET \
--url 'https://api-prod.usefini.com/v2/business-rules/public?source=widget' \
--header 'Authorization: Bearer fini_your_api_key'
const response = await fetch('https://api-prod.usefini.com/v2/business-rules/public?source=widget', {
method: 'GET',
headers: {
Authorization: 'Bearer fini_your_api_key'
}
});
const data = await response.json();
import requests
response = requests.get(
"https://api-prod.usefini.com/v2/business-rules/public?source=widget",
headers={"Authorization": "Bearer fini_your_api_key"},
)
data = response.json()
[
{
"id": "b8b8d87b-2f0c-47f6-8a8a-546da73e0820",
"name": "Refund escalation",
"description": "Route refund requests to the right workflow.",
"type": "business",
"isDraft": false,
"status": "PUBLISHED",
"source": "widget",
"triggerType": "on_escalation",
"defaultBusinessRuleId": null,
"defaultRuleId": null,
"inputSchema": [
{
"name": "Conversation URL",
"dataType": "string",
"path": "conversationUrl",
"required": true
}
],
"botIds": [
"2a1cf0f0-f35d-46ad-8e61-a15c86b2b312"
],
"createdAt": "2026-07-28T08:55:32.000Z",
"updatedAt": "2026-07-28T09:10:18.000Z"
}
]
Business Rules
List Business Rules
List Business Rules in the workspace.
GET
/
v2
/
business-rules
/
public
curl --request GET \
--url 'https://api-prod.usefini.com/v2/business-rules/public?source=widget' \
--header 'Authorization: Bearer fini_your_api_key'
const response = await fetch('https://api-prod.usefini.com/v2/business-rules/public?source=widget', {
method: 'GET',
headers: {
Authorization: 'Bearer fini_your_api_key'
}
});
const data = await response.json();
import requests
response = requests.get(
"https://api-prod.usefini.com/v2/business-rules/public?source=widget",
headers={"Authorization": "Bearer fini_your_api_key"},
)
data = response.json()
[
{
"id": "b8b8d87b-2f0c-47f6-8a8a-546da73e0820",
"name": "Refund escalation",
"description": "Route refund requests to the right workflow.",
"type": "business",
"isDraft": false,
"status": "PUBLISHED",
"source": "widget",
"triggerType": "on_escalation",
"defaultBusinessRuleId": null,
"defaultRuleId": null,
"inputSchema": [
{
"name": "Conversation URL",
"dataType": "string",
"path": "conversationUrl",
"required": true
}
],
"botIds": [
"2a1cf0f0-f35d-46ad-8e61-a15c86b2b312"
],
"createdAt": "2026-07-28T08:55:32.000Z",
"updatedAt": "2026-07-28T09:10:18.000Z"
}
]
Returns Business Rules in the workspace as summary objects.
Headers
string
required
Bearer token containing your Fini workspace API key. Format:
Bearer fini_... The key needs read scope.Query parameters
string
Optional source filter. The current enum value is
widget.Response
Returns an array of Business Rule summary objects withoutflowConfig. Each item includes its botIds.
curl --request GET \
--url 'https://api-prod.usefini.com/v2/business-rules/public?source=widget' \
--header 'Authorization: Bearer fini_your_api_key'
const response = await fetch('https://api-prod.usefini.com/v2/business-rules/public?source=widget', {
method: 'GET',
headers: {
Authorization: 'Bearer fini_your_api_key'
}
});
const data = await response.json();
import requests
response = requests.get(
"https://api-prod.usefini.com/v2/business-rules/public?source=widget",
headers={"Authorization": "Bearer fini_your_api_key"},
)
data = response.json()
[
{
"id": "b8b8d87b-2f0c-47f6-8a8a-546da73e0820",
"name": "Refund escalation",
"description": "Route refund requests to the right workflow.",
"type": "business",
"isDraft": false,
"status": "PUBLISHED",
"source": "widget",
"triggerType": "on_escalation",
"defaultBusinessRuleId": null,
"defaultRuleId": null,
"inputSchema": [
{
"name": "Conversation URL",
"dataType": "string",
"path": "conversationUrl",
"required": true
}
],
"botIds": [
"2a1cf0f0-f35d-46ad-8e61-a15c86b2b312"
],
"createdAt": "2026-07-28T08:55:32.000Z",
"updatedAt": "2026-07-28T09:10:18.000Z"
}
]
Business Rules are not versioned. List responses do not include
flowConfig; fetch a single Business Rule when you need the full tree.Errors
400 Bad Request
400 Bad Request
A query parameter is malformed or uses an unsupported enum value.
401 Unauthorized
401 Unauthorized
The API key is missing, malformed, revoked, or invalid.
403 Forbidden
403 Forbidden
The API key does not include the
read scope required for this route.500 Internal Server Error
500 Internal Server Error
Fini failed while loading Business Rules.
Was this page helpful?

