---
title: "List Guardrails"
method: GET
path: "/v2/guardrails"
tags: ["Guardrails"]
---

# List Guardrails

`GET /v2/guardrails`

Return a flat list of guardrails owned by the caller. Pass `legacy=false` - recommended for all new integrations. The `legacy=true` behavior returns the deprecated guardrail set list.

## Query parameters

- `legacy` 'true' | 'false'
- `limit` integer
- `page` integer
- `sort` 'ascending' | 'descending'
- `name_or_uuid` string
- `tags` string

## Response `200`

Successfully retrieved guardrails

- object
  - `data` object[] — Guardrails for the current page; use `total_count` for the full count under the applied filters.
    - `uuid` string
    - `guardrail_name` string
    - `guardrail_prompt` string
    - `modality` 'verbal' | 'visual'
    - `callback_url` string
    - `tags` string[]
    - `app_message` boolean — Whether triggering this guardrail emits a real-time app-message event on the conversation.
    - `created_at` string
    - `updated_at` string
  - `total_count` integer — Total number of guardrails matching the filter.
  - `page` integer
  - `limit` integer

## Other responses

- `401` — UNAUTHORIZED

---

[API](https://skmtc.dev/tavus/apis/tavus-developer-api-collection.md) · [All operations](https://skmtc.dev/tavus/apis/tavus-developer-api-collection/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tavus/tavus-developer-api-collection/revisions/c878e2f6508d/schema)