Skip to main content
GET
/
v2
/
guardrails
List Guardrails
curl --request GET \
  --url https://tavusapi.com/v2/guardrails \
  --header 'x-api-key: <api-key>'
{
  "data": [
    {
      "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"
    }
  ],
  "total_count": 15,
  "page": 0,
  "limit": 10
}

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

Query Parameters

legacy
enum<string>

Pass false to return individual guardrails (recommended). Defaults to true for backwards compatibility, which returns the legacy set list.

Available options:
true,
false
limit
integer

Number of guardrails to return per page. Default is 10.

page
integer

Page number (0-indexed when legacy=false). Default is 0.

sort
enum<string>

Sort direction. Default is ascending.

Available options:
ascending,
descending
name_or_uuid
string

Filter results by guardrail name or UUID.

tags
string

Comma-separated list of tags to filter by. Any-match (OR) semantics.

Response

Successfully retrieved guardrails

data
object[]

Guardrails for the current page; use total_count for the full count under the applied filters.

total_count
integer

Total number of guardrails matching the filter.

Example:

15

page
integer
Example:

0

limit
integer
Example:

10