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

Reportar Progreso

AI-generated

Summary

Updates the status, message, and progress of an Orbital job, optionally creating a timeline step, sending a notification, skipping a pipeline phase, requesting approval, or creating a document.

Inputs

  • authType (required) — Authentication method: 'jwt' (paste token or reference from Webhook Trigger) or 'credential' (saved HTTP Bearer Auth).
  • authToken (required) — JWT token of the job (required if authType is 'jwt').
  • title — Visible title for the job (leaves existing title empty).
  • status (required) — Job status: 'running' (default) or 'waiting' (pauses job).
  • message — User-facing message displayed in the job header.
  • progress — Global progress percentage (0-100).
  • phase — Reference of the active pipeline phase.
  • phaseLabel — Human-readable label for the phase (defaults to 'phase' if empty).
  • addStep — Enable to register a detailed step in the job timeline.
  • notifyToggle — Send a visible notification to the user alongside this progress.
  • notifyTitle — Notification title (required if notifyToggle is enabled).
  • notifyMessage — Notification message (required if notifyToggle is enabled).
  • notifyType — Notification type: 'system_info', 'system_warning', or 'action_required'.
  • skipPhaseToggle — Mark a pipeline phase as skipped with a reason.
  • skipPhaseRef — Exact reference of the phase to skip (must exist in pipeline).
  • skipReason — Reason for skipping the phase (visible in dashboard).
  • approvalToggle — Pause the job and request human approval (forces status to 'waiting').
  • approvalTitle — Approval prompt title (defaults to 'Aprobación requerida').
  • approvalMessage — Approval prompt message (required if approvalToggle is enabled).
  • approvalResumeUrl — Webhook URL for Orbital to resume the flow after approval (default: n8n execution resumeUrl).
  • createDocToggle — Create a document in the user's document center.
  • docTitle — Document title (required if createDocToggle is enabled).
  • docType — Document category: 'research', 'report', 'analysis', 'document', 'presentation', 'image', 'data', 'code', 'other'.
  • docContentType — Content type: 'markdown', 'html', 'portable-text', '', 'image', 'url', 'embed', 'download'.
  • docContent — Document content body (text/markdown/JSON).
  • stepTitle — Step title (visible in timeline, required if addStep is enabled).
  • stepSubtitle — Step subtitle (context shown when collapsed).
  • stepKind — Step classification: 'process', 'ai', 'io', 'decision', 'human', 'milestone'.
  • stepStatus — Step status: 'success', 'warning', 'error', 'skipped' (drives color).
  • stepContent — Expandable step content body (markdown, JSON, code, etc.).

Output shape

A single record containing job state, pipeline context, created step, and created document.

Returns job state from the backend (including auto-progress and current phase). Includes 'step' object if addStep was enabled. Includes 'documentId' and 'documentCenterUrl' if a document was created. Toggles (notify, skipPhase, approval, createDoc) are reported in the output summary.

Examples

Example 1: Update job progress to 50% and notify the user.

Set status='running', progress=50, message='Analizando datos...', notifyToggle=true, notifyTitle='Progreso actualizado', notifyMessage='El análisis ha alcanzado el 50%.'

Example 2: Pause job for human approval after a processing step.

Set status='waiting', addStep=true, stepTitle='Validación de resultados', approvalToggle=true, approvalMessage='¿Confirmar resultados finales?'

Example 3: Skip a pipeline phase due to a false positive and notify.

Set skipPhaseToggle=true, skipPhaseRef='correlation', skipReason='Falso positivo — cerrado en triage L1', notifyToggle=true, notifyMessage='Fase correlación saltada automáticamente.'

Links

Discussion