Skip to main content

Run Actor

Runs an actor in Apify.

This node is also exposed as an AI Agent tool.

This node has 1 input port and 1 output port.

Common Properties

Every node shares these.

  • Name — the node's display name on the canvas.
  • Color — the node's colour on the canvas.
  • Delay Before (sec) — wait this long before the node runs.
  • Delay After (sec) — wait this long after the node runs.
  • Continue On Error — carry on instead of failing the flow. Defaults to false.
info

When Continue On Error is true the error is not raised at all, so a Catch node will not see it either.

Inputs

PropertyFieldDescription
Actor IDinActorIDActor ID or name (e.g. apify/web-scraper or ~my-actor)
Client IDinClientIDClient ID from Connect node (optional if credentials provided)
InputinInputJSON input to override Actor's default configuration

Outputs

PropertyFieldDescription
Dataset IDoutDatasetIDID of the default dataset for this run
ResultoutResultFull run details as JSON object
Run IDoutRunIDID of the Actor run
StatusoutStatusCurrent status of the run (READY,RUNNING,SUCCEEDED,FAILED,etc.)

Options

PropertyFieldDescription
CredentialsoptCredentialsApify API token (optional - use instead of Connect node)
Timeout (seconds)optTimeoutMaximum time to wait for Actor completion (only when Wait for Finish is enabled)
Wait for FinishoptWaitForFinishWait for the Actor run to complete before returning

Requirements

  • A Client ID from this package's Connect node, unless you set credentials directly on this node.
  • Apify API Token — API token for Apify authentication. Find it at Settings > Integrations in Apify Console.
    • value — API Token (password, required). Your Apify API token from console.apify.com/settings/integrations

Store these in a Vault and reference the vault item from the node, rather than typing the secret into the property.

Connect · Disconnect · Get Run · Get Dataset Items · Toolkit

See also