Start Actor - Automate.ax

apify.startActor starts an Apify Actor run and returns its initial state.

Example

automations/apify-start-actor.automation.ts

import { automation, onHttpRequest } from "automate.ax"
import { apify } from "automate.ax/apify"

export default automation("Start Actor", () => {
  onHttpRequest({ scope: "automation" })

  apify.startActor({
    actorId: "apify/web-scraper",
    input: { startUrls: [{ url: "https://example.com" }] },
    memoryMbytes: 1024,
  })
})

Inputs

Field	Type	Required	Description
`actorId`	`string`	Yes	Actor ID or `username/name` reference.
`input`	JSON	No	Actor-defined input.
`build`	`string`	No	Build tag or number.
`maxItems`	`number`	No	Maximum paid dataset items.
`maxTotalChargeUsd`	`number`	No	Maximum total charge in US dollars.
`memoryMbytes`	`number`	No	Power-of-two memory from 128 to 32768 MB.
`restartOnError`	`boolean`	No	Restart after a container error.
`timeoutSecs`	`number`	No	Maximum run time; `0` disables the timeout.

Output

Returns the Actor run, including its ID, status, storage IDs, timestamps, options, and usage. Dates are ISO 8601 strings. The action returns immediately after Apify creates the run. Starting the same Actor twice creates two runs, so automatic retries are disabled after an uncertain provider response.