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
| Property | Field | Description |
|---|---|---|
| Actor ID | inActorID | Actor ID or name (e.g. apify/web-scraper or ~my-actor) |
| Client ID | inClientID | Client ID from Connect node (optional if credentials provided) |
| Input | inInput | JSON input to override Actor's default configuration |
Outputs
| Property | Field | Description |
|---|---|---|
| Dataset ID | outDatasetID | ID of the default dataset for this run |
| Result | outResult | Full run details as JSON object |
| Run ID | outRunID | ID of the Actor run |
| Status | outStatus | Current status of the run (READY,RUNNING,SUCCEEDED,FAILED,etc.) |
Options
| Property | Field | Description |
|---|---|---|
| Credentials | optCredentials | Apify API token (optional - use instead of Connect node) |
| Timeout (seconds) | optTimeout | Maximum time to wait for Actor completion (only when Wait for Finish is enabled) |
| Wait for Finish | optWaitForFinish | Wait 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.
Related nodes
Connect · Disconnect · Get Run · Get Dataset Items · Toolkit
See also
- Apify — every node in this package
- Message object — how properties read values from
msg - Handling failure — Continue On Error, Catch and retries