curl --request GET \
--url "https://api-prod.usefini.com/v2/guardrail-policies/public?botId=11111111-1111-4111-8111-111111111111" \
--header "Authorization: Bearer $FINI_API_KEY"
const response = await fetch("https://api-prod.usefini.com/v2/guardrail-policies/public?botId=11111111-1111-4111-8111-111111111111", {
method: "GET",
headers: { Authorization: `Bearer ${process.env.FINI_API_KEY}` },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());
import os
import requests
response = requests.get(
"https://api-prod.usefini.com/v2/guardrail-policies/public?botId=11111111-1111-4111-8111-111111111111",
headers={"Authorization": f"Bearer {os.environ['FINI_API_KEY']}"},
timeout=30,
)
response.raise_for_status()
print(response.json())
[
{
"id": "22222222-2222-4222-8222-222222222222",
"companyId": "33333333-3333-4333-8333-333333333333",
"botId": "11111111-1111-4111-8111-111111111111",
"checkType": "banned_terms",
"config": {
"terms": [
"guaranteed approval"
]
},
"enabled": true,
"sources": [
"widget"
],
"createdAt": "2026-10-01T08:00:00.000Z",
"updatedAt": "2026-10-01T08:00:00.000Z"
}
]
Guardrails
List guardrail policies
List guardrail policies through the workspace-scoped public API.
GET
/
v2
/
guardrail-policies
/
public
curl --request GET \
--url "https://api-prod.usefini.com/v2/guardrail-policies/public?botId=11111111-1111-4111-8111-111111111111" \
--header "Authorization: Bearer $FINI_API_KEY"
const response = await fetch("https://api-prod.usefini.com/v2/guardrail-policies/public?botId=11111111-1111-4111-8111-111111111111", {
method: "GET",
headers: { Authorization: `Bearer ${process.env.FINI_API_KEY}` },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());
import os
import requests
response = requests.get(
"https://api-prod.usefini.com/v2/guardrail-policies/public?botId=11111111-1111-4111-8111-111111111111",
headers={"Authorization": f"Bearer {os.environ['FINI_API_KEY']}"},
timeout=30,
)
response.raise_for_status()
print(response.json())
[
{
"id": "22222222-2222-4222-8222-222222222222",
"companyId": "33333333-3333-4333-8333-333333333333",
"botId": "11111111-1111-4111-8111-111111111111",
"checkType": "banned_terms",
"config": {
"terms": [
"guaranteed approval"
]
},
"enabled": true,
"sources": [
"widget"
],
"createdAt": "2026-10-01T08:00:00.000Z",
"updatedAt": "2026-10-01T08:00:00.000Z"
}
]
Returns all policies for the agent, including disabled ones, ordered by creation time. The response is an array, not a paginated envelope. It can be empty when no policies exist.
See the Guardrails overview for shared schemas and runtime limitations.
string
required
Bearer workspace API key. The key needs
read scope.string
required
Agent UUID in the authenticated workspace.
Response
string
Policy UUID.
string
Owning workspace UUID.
string
Agent UUID.
string
Check type from the catalogue.
object
Check-specific definition. See the configuration schemas.
boolean
Whether the policy is enabled.
array
Channel names, or
null for all channels.datetime
Creation timestamp.
datetime
Last update timestamp.
curl --request GET \
--url "https://api-prod.usefini.com/v2/guardrail-policies/public?botId=11111111-1111-4111-8111-111111111111" \
--header "Authorization: Bearer $FINI_API_KEY"
const response = await fetch("https://api-prod.usefini.com/v2/guardrail-policies/public?botId=11111111-1111-4111-8111-111111111111", {
method: "GET",
headers: { Authorization: `Bearer ${process.env.FINI_API_KEY}` },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());
import os
import requests
response = requests.get(
"https://api-prod.usefini.com/v2/guardrail-policies/public?botId=11111111-1111-4111-8111-111111111111",
headers={"Authorization": f"Bearer {os.environ['FINI_API_KEY']}"},
timeout=30,
)
response.raise_for_status()
print(response.json())
[
{
"id": "22222222-2222-4222-8222-222222222222",
"companyId": "33333333-3333-4333-8333-333333333333",
"botId": "11111111-1111-4111-8111-111111111111",
"checkType": "banned_terms",
"config": {
"terms": [
"guaranteed approval"
]
},
"enabled": true,
"sources": [
"widget"
],
"createdAt": "2026-10-01T08:00:00.000Z",
"updatedAt": "2026-10-01T08:00:00.000Z"
}
]
Was this page helpful?