Skip to main content
GET
Get Guardrails
For AI agents, use https://docs.tavus.io/openapi.yaml for the full HTTP API contract.

Authorizations

x-api-key
string
header
required

Path Parameters

guardrail_id
string
required

The unique identifier of the guardrail.

Example:

"g1234567890ab"

Response

Successfully retrieved the guardrail

uuid
string
Example:

"g1234567890ab"

guardrail_name
string
Example:

"healthcare_compliance_guardrail"

guardrail_prompt
string
Example:

"Never share sensitive medical information or provide medical advice outside approved guidelines."

modality
enum<string>
Available options:
verbal,
visual
Example:

"verbal"

callback_url
string
Example:

"https://your-server.com/guardrails-webhook"

tags
string[]
Example:
app_message
boolean

Whether triggering this guardrail emits a real-time app-message event on the conversation.

Example:

true

created_at
string
Example:

"2024-01-15T10:30:00Z"

updated_at
string
Example:

"2024-01-15T10:30:00Z"