/lending/v1/hierarchies/{id}/nodes/{node_id}

Actualizar nodo de una jerarquía

El endpoint lending/v1/hierarchies/{id}/nodes/{node_id} te permite actualizar el estado, el nombre, las tarjetas, la configuración de crédito y las reglas de un nodo.

  • Se actualiza solo lo enviado. Si el nodo no existe en la jerarquía, se responde 404 NOT_FOUND.
  • El nodo raíz de la jerarquía no se puede actualizar: se rechaza con 400 ROOT_NODE_UPDATE_NOT_ALLOWED. Un nodo CANCELED tampoco: se rechaza con 409 CONFLICT.
  • lifecycle.status: desde PENDING podés pasar a ACTIVE o CANCELED; desde ACTIVE, a PAUSED o CANCELED; desde PAUSED, a ACTIVE o CANCELED. EXPIRED no admite cambios de estado. Cualquier otra transición se rechaza con 400 BAD_REQUEST. Enviar el estado actual no produce cambios.
  • Enviá name, card_ids o credit.renewal_policy solo a los tipos de nodo que los admiten; si el tipo no los admite, la solicitud responde 400 BAD_REQUEST.
  • card_ids agrega tarjetas al nodo: las que ya tiene se ignoran y una que ya está asociada a otro nodo se rechaza con 409 CONFLICT. Si el nodo no está ACTIVE y no enviás lifecycle.status, agregar tarjetas lo activa.
  • rules: las reglas del nodo que no enviás se conservan, y si omitís rules las reglas no cambian. Si una regla es inválida o repite type y condition de otra regla del nodo, la solicitud responde 400 INVALID_NODE_RULES.
  • En rules se devuelven solo rule_id y type de cada regla; para ver su detalle, consultá el nodo con GET.

Parámetros disponibles

Path Parameters
idString
node_idString
Cuerpo de solicitud
application/json
lifecycleobject1 propiedades
namestring
card_idsarray
creditobject3 propiedades
rulesarray6 propiedades

Autenticación

🔒BearerAuthhttp

Detalle de respuestas

401
El token falta o es inválido. La respuesta no tiene cuerpo.
403
Sin cuerpo. El token es válido pero no tiene el scope que requiere el endpoint.

Ejemplo de solicitud
{
  "lifecycle": {
    "status": {
      "value": "PAUSED"
    }
  }
}
Ejemplo de código
curl -X PATCH "https://api.pomelo.la/lending/v1/hierarchies/example_value/nodes/example_value" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "lifecycle": {
    "status": {
      "value": "PAUSED"
    }
  }
}'
Ejemplo de respuesta (200)Nodo de la jerarquía
{
  "data": {
    "id": "nod-2HMwKzetERdOEhbT86UweXamPle",
    "hierarchy_id": "hie-2HMwKzetERdOEhbT86UweXamPle",
    "parent_node_id": "nod-2HMvSDccc5PZzCvZ98lfeXamPle",
    "lifecycle": {
      "status": {
        "value": {}
      },
      "created_at": "2026-10-03T14:20:11.120Z",
      "updated_at": "2026-10-03T14:20:11.120Z"
    },
    "name": "Marketing",
    "type": "COMPANY_AREA",
    "link_ref": {
      "id": "lcr-2HMwKzetERdOEhbT86UweXamPle",
      "type": "CREDIT_LINE"
    },
    "card_ids": [
      "crd-2HMvSDccc5PZzCvZ98lfeXamPle"
    ],
    "ancestor_ids": [
      "nod-2HMvSDccc5PZzCvZ98lfeXamPle"
    ],
    "credit": {
      "validity_period": {
        "start_date": "2026-11-01",
        "end_date": "2027-10-31"
      },
      "renewal_policy": {
        "frequency": "MONTHLY"
      },
      "balance": {
        "source": "OWNED",
        "currency": "PEN",
        "limit_type": "PER_OPERATION",
        "restitution_type": "EXTENDED",
        "single_payment": {
          "limit": 4000,
          "utilization": 1250,
          "available": 2750
        },
        "installments": {
          "limit": 4000,
          "utilization": 1250,
          "available": 2750
        },
        "cash_advance": {
          "limit": 1000,
          "utilization": 0,
          "available": 1000,
          "percentage_of_single_payment": 30
        }
      }
    },
    "rules": [
      {
        "rule_id": "2HMwKzetERdOEhbT86UweXamPle",
        "type": "MCC",
        "condition": {},
        "value": [
          "5411",
          "5412"
        ],
        "action": {}
      }
    ]
  }
}

Pomelo AI

Asistente de inteligencia artificial para consultas sobre la API de Pomelo
¡Hola!¿Cómo puedo ayudarte hoy?
Actualizar nodo de una jerarquía | Pomelo API Reference