Skip to main content
POST
Test a Scheduled Function
Ejecuta el borrador de una función programada en una copia de prueba que no puede cambiar nada. Si no hay borrador, la prueba ejecuta el código publicado.

Qué pasa durante una prueba

Sin ctx, la prueba carga los leads, agentes y hosts que coinciden ahora con el alcance de consulta guardado. Cargarlos solo lee datos. Una prueba tiene los mismos límites de tiempo y de solicitudes que una ejecución real. Aparece en el historial con trigger_source test, pero no cambia run_count, last_run_at ni last_run_status.
Riesgos aceptados de una prueba
  • Un GET que cambia algo en el otro sistema, como un enlace para darse de baja o un webhook que se dispara con GET, se ejecuta de verdad.
  • Las escrituras reciben una respuesta simulada {}. El código que lee campos de esa respuesta, como un ID que espera de vuelta, puede tomar un camino distinto al de producción.
  • Una escritura enviada con globalThis.fetch en vez del fetch o axios que provee Nexor también se retiene, pero no aparece en run.requests.
  • Una conexión TCP directa abierta con una API de sockets no se retiene.

Lee el resultado

  • run.status es success, error o timeout. Un error en tu código es una llamada exitosa con run.status error.
  • run.effects lista los cambios en leads previsualizados.
  • run.requests lista cada solicitud hecha con fetch o axios. Las que tienen blocked: true no se enviaron.
  • run.mode es test.
Un 503 DEPLOYMENT_NOT_CURRENT significa que no se pudo preparar la copia de prueba. No se ejecutó ni se registró nada. Reintenta en un momento. Para verificar una escritura real, publica el código con la función en pausa, y luego usa Ejecutar ahora después de que el operador lo confirme.

Autorizaciones

X-API-Key
string
header
requerido

API key for authentication. Keys are prefixed with nxr_live_.

Parámetros de ruta

id
string<uuid>
requerido

Scheduled Function id.

Cuerpo

application/json
ctx
object

Optional ctx to test with. Without it, the test loads the leads, agents and hosts that the saved lookup scope matches now, as a read.

Respuesta

The test ran. A function error or timeout is reported in run.status and run.error, not as an HTTP error.

success
enum<boolean>
requerido
Opciones disponibles:
true
run
object
requerido
test
enum<boolean>
requerido
Opciones disponibles:
true
Última modificación el 6 de octubre de 2026