curl https://api.telzino.com/v1/organizations/987fcdeb-51a2-3bc4-d567-890123456789/guardrails \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
{
"data": [
{
"id": "11111111-1111-1111-1111-111111111111",
"organization_id": "987fcdeb-51a2-3bc4-d567-890123456789",
"name": "No PII",
"description": "Never reveal or confirm a caller's full account number, SSN, or payment card details.",
"enabled": true,
"created_at": "2026-07-15T12:00:00Z",
"updated_at": "2026-07-15T12:00:00Z"
}
]
}
Guardrails
List and Create Guardrails
List or create organization-level guardrails
GET
/
v1
/
organizations
/
{organization_id}
/
guardrails
curl https://api.telzino.com/v1/organizations/987fcdeb-51a2-3bc4-d567-890123456789/guardrails \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
{
"data": [
{
"id": "11111111-1111-1111-1111-111111111111",
"organization_id": "987fcdeb-51a2-3bc4-d567-890123456789",
"name": "No PII",
"description": "Never reveal or confirm a caller's full account number, SSN, or payment card details.",
"enabled": true,
"created_at": "2026-07-15T12:00:00Z",
"updated_at": "2026-07-15T12:00:00Z"
}
]
}
Path Parameters
string
required
Organization ID (UUID).
List Guardrails
Returns all guardrails in the organization, oldest first.curl https://api.telzino.com/v1/organizations/987fcdeb-51a2-3bc4-d567-890123456789/guardrails \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
{
"data": [
{
"id": "11111111-1111-1111-1111-111111111111",
"organization_id": "987fcdeb-51a2-3bc4-d567-890123456789",
"name": "No PII",
"description": "Never reveal or confirm a caller's full account number, SSN, or payment card details.",
"enabled": true,
"created_at": "2026-07-15T12:00:00Z",
"updated_at": "2026-07-15T12:00:00Z"
}
]
}
Create a Guardrail
Send a JSON body to the same endpoint.string
required
Guardrail name, 1-100 characters. Names must be unique within the organization.
string | null
Optional rule text, up to 1000 characters. Spell out exactly what the agent
must (or must not) do.
boolean
default:"true"
Whether the guardrail is injected into agent prompts.
An organization can have at most 5 guardrails. Creating a sixth returns
409 limit_reached.curl -X POST https://api.telzino.com/v1/organizations/987fcdeb-51a2-3bc4-d567-890123456789/guardrails \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "No PII",
"description": "Never reveal or confirm a caller'\''s full account number, SSN, or payment card details."
}'
{
"data": {
"id": "11111111-1111-1111-1111-111111111111",
"organization_id": "987fcdeb-51a2-3bc4-d567-890123456789",
"name": "No PII",
"description": "Never reveal or confirm a caller's full account number, SSN, or payment card details.",
"enabled": true,
"created_at": "2026-07-15T12:00:00Z",
"updated_at": "2026-07-15T12:00:00Z"
}
}
// Schema validation failed (name empty/too long, description too long,
// or an unknown field was sent).
{
"error": "Invalid request data",
"details": [
{
"code": "too_big",
"maximum": 100,
"path": ["name"],
"message": "String must contain at most 100 character(s)"
}
]
}
// Body was not valid JSON, or the name was only whitespace.
{
"error": "invalid_request",
"error_description": "Name is required"
}
{
"error": "conflict",
"error_description": "A guardrail with that name already exists"
}
{
"error": "limit_reached",
"error_description": "You can create at most 5 guardrails per organization"
}
