---
title: "Register Guardrail"
method: POST
path: "/guardrails/register"
tags: ["guardrails"]
---

# Register Guardrail

`POST /guardrails/register`

Register a guardrail for onboarding (team submission).

Accepts a guardrail config in the
[Generic Guardrail API](https://docs.litellm.ai/docs/adding_provider/generic_guardrail_api) format.
The submission is stored with status `pending_review` until an admin approves it.

## Request body

- RegisterGuardrailRequest — Request body for POST /guardrails/register. Follows Generic Guardrail API config.
  - `guardrail_info` object, nullable
  - `guardrail_name` string, required
  - `litellm_params` object, required
  - `team_id` string, nullable

## Response `200`

Successful Response

- RegisterGuardrailResponse
  - `guardrail_id` string, required
  - `guardrail_name` string, required
  - `status` string, required
  - `submitted_at` string, date-time, nullable

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-01** `5c00a227eebf` — 2 info
  - api tag `guardrails` added
  - api tag `Guardrails` removed
- **2026-08-30** `24ad9eaf6a00` — 2 info
  - api tag `Guardrails` added
  - api tag `guardrails` removed
- **2026-08-27** `4a06c3148b6c` — 2 info
  - api tag `guardrails` added
  - api tag `Guardrails` removed
- **2026-08-13** `9dbf4ea7ee00` — 2 info
  - api tag `Guardrails` added
  - api tag `guardrails` removed

[Change history](https://skmtc.dev/flock/apis/litellm-api/changes/guardrails/register/post.md)

---

[API](https://skmtc.dev/flock/apis/litellm-api.md) · [All operations](https://skmtc.dev/flock/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/flock/litellm-api/revisions/5c00a227eebf/schema)