Saltar al contenido principal
PATCH /workflows/:id/tools/:toolId/stage-gate Gatea una tool personalizada a stages específicos del funnel, para que el agente solo la ofrezca cuando un lead llegue al status correcto.

Parámetros de Ruta

ParámetroTipoRequeridoDescripción
idstring (uuid)ID del agente
toolIdstring (uuid)ID de la tool

Cuerpo de la Solicitud

CampoTipoRequeridoDescripción
available_in_statusesstring[] | nullKeys de status del funnel donde se ofrece la tool. null limpia el gate, dejándola disponible en todos los statuses

Respuestas

200 — Actualizado

{
  "success": true,
  "tool": {
    "id": "9a1b2c3d-0000-4000-8000-000000000001",
    "name": "check_availability",
    "available_in_statuses": ["qualified", "negotiating"]
  }
}

400 — Error de validación

{
  "error": "Invalid input",
  "message": "available_in_statuses must be an array of status keys, or null to clear"
}

401 — Error de autenticación

Ver Autenticación.

404 — No encontrado

{
  "error": "Not found",
  "message": "Tool not found"
}

500 — Error interno del servidor

Última modificación el 10 de julio de 2026