Orbital Actions icon

Orbital Actions

Orbital Actions (Fractalia) — Pipelines con plantillas, steps enriquecidos, webhooks, callbacks, documentos y notificaciones. Zero-config: el JWT y la URL se resuelven automáticamente.

Actions3

Finalizar Flujo

AI-generated

Summary

Finalize an Orbital workflow job by completing it successfully or reporting an error, optionally attaching content, documents, and notifications.

Inputs

  • authType (required) — Authentication method: 'jwt' (paste token or reference node) or 'credential' (saved n8n header auth).
  • authToken (required) — JWT token for the job (expected in body.auth.token of a Webhook Trigger payload).
  • flowStatus (required) — Final status: 'success' (completed) or 'error' (failed). Determines which fields are available.
  • finishJobTitle — Custom title for the job visible in Orbital's task list (defaults to existing title).
  • finishContentType — Content type for the result (, article, markdown, text, image, file, video). Only shown if status=success.
  • resultJson — Result payload (JSON). Can be an expression (e.g., {{ $ }}). Only shown if status=success and type=.
  • finishDocTitle — Title for the generated document in the Document Center (defaults to job title).
  • finishDocSections — Array of sections [{title, content}] for article-type documents. Only shown if type=article.
  • finishDocContent — Document body (markdown/text). Only shown if type=markdown or text.
  • finishDocUrl — URL for images, files, or videos. Only shown if type=image, file, or video.
  • finishDocType — Document category (report, analysis, research, etc.).
  • finishDocDescription — Brief description visible in the document card.
  • finishMetadata — Free-form JSON metadata (sources, tokens, etc.).
  • finishErrorMessage — User-facing error message. Only shown if status=error.
  • finishErrorCategory — Error classification (external_service, timeout, auth, validation, etc.). Only shown if status=error.
  • finishNotify — Enable sending a notification to the user's Orbital bell.
  • finishNotifyMessage — Custom notification message (auto-generated if empty).
  • finishNotifyUrl — Custom link the user navigates to when clicking the notification.

Output shape

A single record containing the final job status, document ID, content URL, and other details.

The operation sends a POST request to Orbital's callback endpoint. If a document is created, the response includes documentId and documentCenterUrl. Errors are mapped to user-friendly messages based on HTTP status codes.

Examples

Example 1: Successful completion with JSON result and document.

Set flowStatus=success, finishContentType=, finishDocType=report, and resultJson={{ $ }}.

Example 2: Failure reporting with category.

Set flowStatus=error, finishErrorMessage='Service timeout', and finishErrorCategory='timeout'.

Example 3: Article with sections.

Set flowStatus=success, finishContentType=article, finishDocSections to an array of {title, content} objects.

Links

Discussion