---
title: "Create Ruleset"
method: POST
path: "/rules/v1/ruleset"
---

# Create Ruleset

`POST /rules/v1/ruleset`

## Request

- Base URL: `https://api.qualityclouds.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.qualityclouds.ai/rules/v1/ruleset`
- Auth: one of:
  - HTTP bearer
  - OpenID Connect (`https://account.qualityclouds.com//realms/ai-production/.well-known/openid-configuration`)

Endpoint para crear un nuevo ruleset.

Args:
    body: Datos del ruleset a crear
        - ruleset_version_id: ID único del ruleset
        - name: Nombre del ruleset
        - launch_date: Fecha de lanzamiento (YYYY-MM-DD)
        - tool_id: ID del tool asociado (debe existir)

Returns:
    RulesetVersionResponse con los datos del ruleset creado (HTTP 201)
    
Raises:
    HTTPException 422: Si hay errores de validación
        - tool_id no existe
        - ruleset_version_id ya existe
        - datos inválidos
    
Requiere token del engine (mismo validador que external tool rules).

## Request body

- CreateRulesetInput
  - `ruleset_version_id` string, required
  - `name` string, required
  - `launch_date` string, required
  - `tool_id` string, required

## Response `201`

Successful Response

- RulesetVersionResponse: Response para versiones de ruleset.
  - `ruleset_version_id` string, required
  - `name` string, required
  - `launch_date` string, date, required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `422`: Validation Error

---

[API](https://skmtc.dev/qualityclouds/apis/qai-orchestrator-api.md) · [All operations](https://skmtc.dev/qualityclouds/apis/qai-orchestrator-api/llms.txt) · [OpenAPI document](https://skmtc.dev/qualityclouds/apis/qai-orchestrator-api/revisions/250c849925af?raw)