Skip to main content
GET
List Guardrails
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 deprecated guardrail 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