Saltar al contenido principal
El catálogo guarda rulesets para que puedas referenciarlos por name@version en /v1/evaluate en vez de enviar el body inline en cada llamada.

​
Endpoints

MétodoPathPropósito
POST/v1/rulesetsCrea un nuevo (name, version).
GET/v1/rulesetsLista rulesets (paginado).
GET/v1/rulesets/{name}Obtiene la versión más reciente.
GET/v1/rulesets/{name}/{version}Obtiene una versión específica.

​
Crear

curl -X POST https://api-attestly.code4source.com/v1/rulesets \
  -H "Authorization: Bearer atk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "br-rural-credit",
    "version": 1,
    "sets":   { },
    "checks": [ ]
  }'
version es un entero. Omítelo para que la API asigne el siguiente número libre. Los pares (name, version) son inmutables — re-POSTear el mismo par devuelve 409 RULESET_ALREADY_EXISTS.

​
Response

{
  "data": {
    "ruleset": "br-rural-credit",
    "version": 1,
    "body": { },
    "body_hash": "8a3c...",
    "created_at": "2026-05-05T12:00:00Z",
    "created_by": "org_01HX...",
    "display_name": null,
    "description": null,
    "tags": [],
    "resolved_colors": {
      "ruleset": "#3b82f6",
      "checks": { "no_indigenous_overlap": "#dc2626" },
      "outcomes": {
        "compliant": "#16a34a",
        "warning": "#f59e0b",
        "non_compliant": "#dc2626",
        "degraded": "#6b7280"
      }
    }
  }
}

​
Listar

GET /v1/rulesets?page=1&page_size=25
GET /v1/rulesets?tag=preset
GET /v1/rulesets?tag=preset&tag=brazil
Query paramNotas
page1-indexado. Por defecto 1.
page_sizeÍtems por página. Por defecto 25, máximo 200.
tagRepite para exigir múltiples tags (AND). Usa tag=preset para listar presets oficiales.
Devuelve un listado de metadata paginado: 
{
  "data": {
    "items": [
      {
        "ruleset": "br-rural-credit",
        "version": 1,
        "body_hash": "8a3c...",
        "created_at": "2026-05-05T12:00:00Z",
        "created_by": "org_01HX...",
        "display_name": null,
        "description": null,
        "tags": [],
        "color": "#3b82f6"
      }
    ],
    "pagination": { "page": 1, "page_size": 25, "total_count": 42, "total_pages": 2 }
  }
}

​
Obtener

GET /v1/rulesets/br-rural-credit          # versión más reciente
GET /v1/rulesets/br-rural-credit/1        # versión fijada
Ambos devuelven el mismo shape que la respuesta del POST arriba.