> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telzino.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update and Delete Guardrails

> Update a guardrail's name, description, or enabled state, or delete it

## Path Parameters

<ParamField path="guardrailId" type="string" required>
  Guardrail ID (UUID).
</ParamField>

## Update a Guardrail

Partial update — send only the fields you want to change (at least one).

<ParamField body="name" type="string">
  New name, 1-100 characters, unique within the organization.
</ParamField>

<ParamField body="description" type="string | null">
  New rule text (up to 1000 characters), or `null` to clear it.
</ParamField>

<ParamField body="enabled" type="boolean">
  Set `false` to pause the rule without deleting it — it stays listed but is
  not injected into agent prompts.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X PATCH https://api.telzino.com/v1/guardrails/11111111-1111-1111-1111-111111111111 \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{ "enabled": false }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true
  }
  ```

  ```json 400 theme={null}
  // The patch body was empty — send at least one of name, description, enabled.
  {
    "error": "Invalid request data",
    "details": [
      {
        "code": "custom",
        "path": [],
        "message": "At least one field is required"
      }
    ]
  }
  ```

  ```json 404 theme={null}
  {
    "error": "not_found",
    "error_description": "Resource not found or access denied"
  }
  ```

  ```json 409 theme={null}
  {
    "error": "conflict",
    "error_description": "A guardrail with that name already exists"
  }
  ```
</ResponseExample>

## Delete a Guardrail

`DELETE` to the same path. Agents stop following the rule on their next call.

<RequestExample>
  ```bash cURL theme={null}
  curl -X DELETE https://api.telzino.com/v1/guardrails/11111111-1111-1111-1111-111111111111 \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true
  }
  ```

  ```json 404 theme={null}
  {
    "error": "not_found",
    "error_description": "Resource not found or access denied"
  }
  ```
</ResponseExample>