Legacy: Polling Reviewed Documents

Status

This page is retained only for historical reference.

GET /v1/delivery/outbox is no longer part of the current recommended Numora integration model.

If you are starting a new integration, skip this page and use n8n Outbound Delivery or Delivery Status Callback.

The current product path is route-based:

• workflow for Numora-managed execution
• n8n executor + webhook notify for external orchestration

What To Use Instead

1. Route-Based Dispatch

For reviewed and finalized documents, use POST /v1/documents/{id}/dispatch.

Numora resolves the active delivery route and then:

• dispatches the configured workflow, or
• enqueues an n8n webhook delivery and notifies the shared executor

2. Delivery Status Callback

If the downstream write is executed outside Numora, record the result with:

• POST /v1/documents/{id}/delivery

3. Document Status

Use GET /v1/documents/{id} as the primary status surface:

• reviewed
• push_pending
• push_succeeded
• push_failed

Migration Notes

If you still have any external worker that polls /v1/delivery/outbox, migrate it to the current route-based model:

1. Configure the active delivery route inside Numora.
2. Use dispatch to start downstream delivery.
3. Let Numora notify the shared n8n webhook when the active route uses n8n executor.
4. Use the delivery callback only when the destination write happens outside Numora.

Current Pages

• n8n Outbound Delivery
• Delivery Status Callback
• Document Lifecycle
• Documents