Saltar al contenido principal
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_. To work inside a sub-account with a main account key, also send the optional X-Nexor-Sub-Account-Id header.

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.

async
boolean
predeterminado:false

Return a queued run_id immediately and poll the run instead of holding this request open.

idempotency_key
string

Async tests: reuse on retries; change to intentionally rerun unchanged code and context.

Required string length: 1 - 128

Respuesta

The test completed, or an async test was accepted with a queued run_id. Poll the same run to a terminal status; function errors/timeouts are in run.status/run.error, not HTTP errors.

success
enum<boolean>
requerido
Opciones disponibles:
true
run
object
requerido
test
enum<boolean>
requerido
Opciones disponibles:
true
run_id
string<uuid>

Stable execution id returned for async tests; poll the run endpoint.

Última modificación el 6 de octubre de 2026