Saltar al contenido principal
POST
/
v1
/
rules
Crear una Regla
curl --request POST \
  --url https://tracer.lerian.io/v1/rules \
  --header 'Content-Type: <content-type>' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "name": "Bloquear transacciones de alto valor",
  "description": "Denegar transacciones superiores a BRL 10,000 para pagos con tarjeta",
  "expression": "amount > 1000000",
  "action": "DENY",
  "scopes": [
    {
      "transactionType": "CARD"
    }
  ]
}
'
{
  "ruleId": "cc1e8400-e29b-41d4-a716-446655440020",
  "name": "Bloquear transacciones de alto valor",
  "description": "Denegar transacciones superiores a BRL 10,000 para pagos con tarjeta",
  "expression": "amount > 1000000",
  "action": "DENY",
  "scopes": [
    {
      "transactionType": "CARD"
    }
  ],
  "status": "DRAFT",
  "createdAt": "2026-01-30T10:00:00Z",
  "updatedAt": "2026-01-30T10:00:00Z"
}

Encabezados

​
Content-Type
string
requerido

El tipo de medio del recurso. Debe ser application/json.

​
X-API-Key
string
requerido

La clave API para autenticacion. Este encabezado es requerido para todos los endpoints excepto verificaciones de salud.

​
X-Request-Id
string<uuid>

Un identificador unico usado para rastrear y seguir cada solicitud.

Cuerpo

application/json

Entrada para crear una nueva regla.

​
name
string
requerido

Nombre de regla legible para humanos (debe ser globalmente unico).

Required string length: 1 - 255
​
expression
string
requerido

Expresion CEL que debe evaluar a booleano.

Required string length: 1 - 5000
​
action
enum<string>
requerido

Accion tomada cuando la expresion de la regla evalua a verdadero.

Opciones disponibles:
ALLOW,
DENY,
REVIEW
​
description
string

Proposito y explicacion de la logica de la regla.

Maximum string length: 1000
​
scopes
object[]

Alcances que determinan a que transacciones aplica esta regla.

Maximum array length: 100

Respuesta

Indica que la regla fue creada exitosamente en estado DRAFT.

Regla de validacion.

​
ruleId
string<uuid>

Identificador unico de la regla.

​
name
string

Nombre de regla legible para humanos (globalmente unico).

Maximum string length: 255
​
description
string

Proposito y explicacion de la logica de la regla.

Maximum string length: 1000
​
expression
string

Expresion CEL que debe evaluar a booleano.

Maximum string length: 5000
​
action
enum<string>

Accion tomada cuando la expresion de la regla evalua a verdadero.

Opciones disponibles:
ALLOW,
DENY,
REVIEW
​
scopes
object[]

Alcances que determinan a que transacciones aplica esta regla.

​
status
enum<string>

Estado del ciclo de vida de la regla.

Opciones disponibles:
DRAFT,
ACTIVE,
INACTIVE,
DELETED
​
createdAt
string<date-time>

Cuando se creo la regla.

​
updatedAt
string<date-time>

Cuando se modifico la regla por ultima vez.

​
activatedAt
string<date-time> | null

Cuando la regla fue activada por ultima vez (null si nunca fue activada).

​
deactivatedAt
string<date-time> | null

Cuando la regla fue desactivada por ultima vez (null si nunca fue desactivada).

​
deletedAt
string<date-time> | null

Cuando la regla fue eliminada (null si no fue eliminada).