Skip to main content
GET
/
v2
/
guardrails
/
{guardrail_id}
Get Guardrails
curl --request GET \
  --url https://tavusapi.com/v2/guardrails/{guardrail_id} \
  --header 'x-api-key: <api-key>'
{
  "uuid": "g1234567890ab",
  "guardrail_name": "healthcare_compliance_guardrail",
  "guardrail_prompt": "Never share sensitive medical information or provide medical advice outside approved guidelines.",
  "modality": "verbal",
  "callback_url": "https://your-server.com/guardrails-webhook",
  "tags": [
    "compliance",
    "healthcare"
  ],
  "app_message": true,
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-01-15T10:30:00Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.tavus.io/llms.txt

Use this file to discover all available pages before exploring further.

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:
["compliance", "healthcare"]
​
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"