Start Actor build - Automate.ax

apify.startActorBuild starts a build for one Apify Actor version.

Example

automations/apify-start-actor-build.automation.ts

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

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

  apify.startActorBuild({
    actorId: "actor-id",
    versionNumber: "1.0",
    tag: "latest",
    useCache: true,
  })
})

Inputs

Field	Type	Required	Description
`actorId`	`string`	Yes	Actor ID or `username/name` reference.
`versionNumber`	`string`	Yes	Actor version to build.
`tag`	`string`	No	Tag assigned to a successful build.
`useCache`	`boolean`	No	Reuse cached Docker layers.
`betaPackages`	`boolean`	No	Use Apify beta packages.

Output

Returns the build immediately with its ID, status, build number, timestamps, options, statistics, and usage. Starting another build creates a distinct provider job, so automatic retries are disabled after an uncertain response.