> ## Documentation Index
> Fetch the complete documentation index at: https://docs.automate.ax/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# Get Actor build

> Gets the current state of one Apify Actor build.

`apify.getActorBuild` gets the current state of one Apify Actor build.

## Example

```ts automations/apify-get-actor-build.automation.ts theme={null}
import { automation, onHttpRequest } from "automate.ax"
import { apify } from "automate.ax/apify"

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

  apify.getActorBuild({ buildId: "build-id" })
})
```

## Inputs

`buildId` is the Actor build ID.

## Output

Returns the Actor build with status, Actor ID, build number, timestamps, options, statistics, and usage.

This read is safe to retry. The action fails when the build does not exist or the token cannot read it.