Composers

Documentation Index

Fetch the complete documentation index at: https://docs.royaltyport.com/llms.txt

Use this file to discover all available pages before exploring further.

​

What is a Composer?

A Composer is the top-level orchestrator in Automations. It lets you connect multiple automations and hooks on a visual canvas to define an execution flow. Think of it as the master plan that controls which workflows run and how they chain together.

​

Creating a Composer

​

The Composer Canvas

When you select a composer from the sidebar, the main area opens the composer canvas — a visual flow editor where you build your orchestration. It works similarly to the Workflow Canvas: steps are nodes, and you connect them with edges to define the execution order.

​

Trigger Node

Every composer has a Trigger node at the top of the canvas. Click the trigger node to open its configuration panel on the right and set how the composer starts:

​

Step Types

​

Adding Steps

Add steps to the canvas in two ways:

• Header button — Click the Step dropdown in the canvas header and select a step type.
• Right-click menu — Right-click anywhere on the canvas to open a context menu with all step types.

​

Connecting Steps

Drag from the output handle of one node to the input handle of another to connect them. The execution flows along these connections. Cycles are not permitted — the canvas prevents you from creating a circular connection.

​

Configuring a Step

Click any node on the canvas to select it and open its configuration panel on the right side:

• Automation step — Toggle the step enabled or disabled. Click the drill-in icon on the node to open that automation’s workflow canvas.
• Sleep step — Set the duration (e.g. 30s, 5m, 1h).
• Review step — Enter a message for reviewers and a timeout after which the composer continues automatically.

​

Repositioning Nodes

Drag nodes to rearrange them. The visual layout does not affect execution — only the connections matter.

​

Removing Steps

Select a node and either press Backspace or click the trash icon in the configuration panel.

​

View Mode and Edit Mode

The Automations page has two modes, switchable with the View / Edit toggle in the sidebar header.

​

Reviews Tab

The Reviews tab is the first thing you see in View Mode. It shows every composer run that is currently paused at a Review step, waiting for a human to approve or reject before execution continues. Runs are grouped by workflow. Each group header shows:

• The workflow name
• How long ago the latest awaiting run started
• A Pending badge with the number of review requests in that group

Below each group, every pending review message is displayed with its approve and reject controls. Resolving a review immediately unpauses execution and refreshes the list. If no runs are awaiting review, the tab shows an empty state.

​

Automations Tab

The Automations tab lists all your composers with their last-run status. Use it to run your workflows in batch and to inspect step logs without leaving View Mode.

​

Running Composers in View Mode

​

Composer Status in View Mode

Each row in the Automations tab shows the composer’s current batch or last-run status:

​

Viewing Step Logs in View Mode

Expand any composer row in the Automations tab to see its execution logs. The expanded panel contains two tabs: Each row in the History tab shows the run’s status icon, how long ago it started, its duration, and a mode badge (e.g. Manual, Scheduled). The run tagged Latest is highlighted with a Latest badge. Click any history row to expand it and see its step-by-step logs. Click any step log entry to open a step detail sheet on the right side of the screen. The sheet shows step-type-specific information: Any step that encountered an error also shows the error message at the bottom of the sheet.

​

Running a Single Composer

To run a single composer from the canvas, click the Run button in the canvas header. While running, active nodes pulse to show live execution status. Toggle the Logs panel (the logs icon in the header) to see step-by-step execution output inline. When the composer reaches a Review step, execution pauses and the run status changes to Awaiting Review. A clock icon appears on the run card in the sidebar and in the Runs page. Execution resumes automatically once a reviewer approves or rejects the step (or when the configured timeout elapses).

​

Running Workflows from View Mode

When the automations page is in View Mode, you can select one or more workflows and click Run to open the Start Workflow dialog. This dialog lets you:

• Check and drag-reorder which workflows will run.
• Review and update Variables before execution begins. Royaltyport variables show a project picker; Custom variables show a UI / Raw toggle — UI mode displays each field as an individual input, Raw mode shows the full JSON editor. Each variable is collapsible so you can focus on what matters.
• Click Run to execute all selected workflows in order, one at a time.

​

Managing Composers

​

Renaming

Click on the composer name in the sidebar to edit it inline.

​

Deleting

Delete a composer from the sidebar context menu. This removes the composer and all its step references.

​

Managing Automations from the Sidebar

When a composer is expanded in the sidebar, the automations it references are listed beneath it. Hover over any automation item to reveal a three-dot menu (⋮) with the following actions:

• Rename — Edit the automation’s name inline. Press Enter to save or Escape to cancel.
• Delete — Permanently delete the automation and all its steps, connectors, and execution logs. A confirmation dialog is shown before anything is removed.

​

Related Documentation