Reglas

Secure reglas definir lo que Escaneos busca. Cada regla tiene un tipo (lo que inspecciona), una acción (block, flag, log), una gravedad, y un alcance (todos los agentes, o específicos). Puede listar, crear y actualizar reglas sobre la API.

Reglas de lista#

GET /v1/secure/rules - Requiere el alcance secure:rules:read.

curl "https://api.maetra.io/v1/secure/rules" \
  -H "Authorization: Bearer $MAETRA_API_KEY"

{
  "rules": [
    {
      "id": "rule_71c",
      "name": "Outbound PII",
      "description": "Flag customer PII leaving the system.",
      "type": "data_pattern",
      "action": "flag",
      "severity": "medium",
      "status": "active",
      "is_built_in": false,
      "applies_to_all": true,
      "trigger_count": 12,
      "last_triggered_at": "2026-07-06T22:04:00.000Z",
      "version": 3,
      "updated_at": "2026-07-01T09:12:00.000Z"
    }
  ]
}

Ver el objeto de artículo por cada campo.

Crear una regla#

POST /v1/secure/rules - Requiere el alcance secure:rules:write. Devoluciones 201.

Tipos de reglas

Solicitud de cuerpo

Nota Nuevas reglas por defecto status: draft - no afectan los escaneos hasta que active. Crear como draft, prueba, luego promover (con Actualizar una regla).

curl -X POST "https://api.maetra.io/v1/secure/rules" \
  -H "Authorization: Bearer $MAETRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Block secrets in tool calls",
  "type": "data_pattern",
  "action": "block",
  "severity": "high",
  "status": "active",
  "data_direction": "outbound",
  "custom_patterns": [
    "AKIA[0-9A-Z]{16}",
    "-----BEGIN (RSA )?PRIVATE KEY-----"
  ]
}'

{
  "rule": {
    "id": "rule_9f2",
    "name": "Block secrets in tool calls",
    "type": "data_pattern",
    "action": "block",
    "severity": "high",
    "status": "active",
    "is_built_in": false,
    "applies_to_all": true,
    "trigger_count": 0,
    "last_triggered_at": null,
    "version": 1,
    "updated_at": "2026-07-07T11:40:00.000Z"
  }
}

Actualizar una regla#

PATCH /v1/secure/rules/{id} - Requiere el alcance secure:rules:write.

Sólo los campos que envían son cambiados; omitir el resto para dejarlos intactos. Acepta las los mismos campos que crear (todo lo opcional aquí). Las reglas incorporadas no pueden ser editadas. Un uso común está dando vueltas draft Reglas para active, o marcar una acción de block hacia abajo flag:

curl -X PATCH "https://api.maetra.io/v1/secure/rules/rule_9f2" \
  -H "Authorization: Bearer $MAETRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "status": "active",
  "action": "flag"
}'

{
  "rule": {
    "id": "rule_9f2",
    "name": "Block secrets in tool calls",
    "action": "flag",
    "status": "active",
    "version": 2,
    "updated_at": "2026-07-07T12:02:00.000Z"
  }
}

Nota Campos de tipo Lista (custom_patterns, tool_names, agent_ids, ... reemplazado cuando los envías, envía la lista completa deseada, no un delta. Omitir una lista enteramente para dejarla sin cambios.

Artículo objeto#