Get build

GET /v2/acts/:actorId/builds/:buildId

deprecated

API endpoints related to build of the Actor were moved under new namespace actor-builds. Gets an object that contains all the details about a specific build of an Actor.

By passing the optional waitForFinish parameter the API endpoint will synchronously wait for the build to finish. This is useful to avoid periodic polling when waiting for an Actor build to finish.

This endpoint does not require the authentication token. Instead, calls are authenticated using a hard-to-guess ID of the build. However, if you access the endpoint without the token, certain attributes, such as usageUsd and usageTotalUsd, will be hidden.

Request

Path Parameters

actorId string required

Actor ID or a tilde-separated owner's username and Actor name.

Example: janedoe~my-actor

buildId string required

ID of the build you want to get, found in the build's Info tab.

Example: soSkq9ekdmfOslopH

Query Parameters

waitForFinish double

The maximum number of seconds the server waits for the build to finish. By default it is 0, the maximum value is 60. If the build finishes in time then the returned build object will have a terminal status (e.g. SUCCEEDED), otherwise it will have a transitional status (e.g. RUNNING).

Example: 60

Status 200

Response Headers

{
  "data": {
    "id": "HG7ML7M8z78YcAPEB",
    "actId": "janedoe~my-actor",
    "userId": "klmdEpoiojmdEMlk3",
    "startedAt": "2019-11-30T07:34:24.202Z",
    "finishedAt": "2019-12-12T09:30:12.202Z",
    "status": "SUCCEEDED",
    "meta": {
      "origin": "WEB",
      "clientIp": "172.234.12.34",
      "userAgent": "Mozilla/5.0 (iPad)"
    },
    "stats": {
      "durationMillis": 1000,
      "runTimeSecs": 45.718,
      "computeUnits": 0.012699444444444444
    },
    "options": {
      "useCache": false,
      "betaPackages": false,
      "memoryMbytes": 1024,
      "diskMbytes": 2048
    },
    "usage": {
      "ACTOR_COMPUTE_UNITS": 0.08
    },
    "usageTotalUsd": 0.02,
    "usageUsd": {
      "ACTOR_COMPUTE_UNITS": 0.02
    },
    "inputSchema": "{\\n  \\\"title\\\": \\\"Schema for ... }",
    "readme": "# Magic Actor\\nThis Actor is magic.",
    "buildNumber": "0.1.1"
  }
}

Schema

data object required
- id string required
  Example: HG7ML7M8z78YcAPEB
- actId string required
  Example: janedoe~my-actor
- userId string required
  Example: klmdEpoiojmdEMlk3
- startedAt string<date-time> required
  Example: 2019-11-30T07:34:24.202Z
- finishedAt string,null<date-time> nullable
  Example: 2019-12-12T09:30:12.202Z
- status ActorJobStatus (string) required
  Status of an Actor job (run or build).
  Possible values: [READY, RUNNING, SUCCEEDED, FAILED, TIMING-OUT, TIMED-OUT, ABORTING, ABORTED]
- meta object required
  origin RunOrigin (string) required
  Possible values: [DEVELOPMENT, WEB, API, SCHEDULER, TEST, WEBHOOK, ACTOR, CLI, STANDBY]
  clientIp string
  IP address of the client that started the build.
  
  Example: 172.234.12.34
  userAgent string
  User agent of the client that started the build.
  
  Example: Mozilla/5.0 (iPad)
- stats object
  anyOf
  BuildStats
  null
  durationMillis integer
  Example: 1000
  runTimeSecs number
  Example: 45.718
  computeUnits number required
  Example: 0.0126994444444444
- options object
  anyOf
  BuildOptions
  null
  useCache boolean | null nullable
  Example: false
  betaPackages boolean | null nullable
  Example: false
  memoryMbytes integer | null nullable
  Example: 1024
  diskMbytes integer | null nullable
  Example: 2048
- usage object
  anyOf
  BuildUsage
  null
  ACTOR_COMPUTE_UNITS number | null nullable
  Example: 0.08
- usageTotalUsd number | null nullable
  Example: 0.02
- usageUsd object
  anyOf
  BuildUsage
  null
  ACTOR_COMPUTE_UNITS number | null nullable
  Example: 0.08
- inputSchema string | null nullable deprecated
  Example: {\n "title": "Schema for ... }
- readme string | null nullable deprecated
  Example: # Magic Actor\nThis Actor is magic.
- buildNumber string required
  Example: 0.1.1
- actorDefinition object
  anyOf
  ActorDefinition
  null
  actorSpecification integer
  The Actor specification version that this Actor follows. This property must be set to 1.
  Possible values: [1]
  name string
  The name of the Actor.
  version string
  The version of the Actor, specified in the format [Number].[Number], e.g., 0.1, 1.0.
  Possible values: Value must match regular expression ^[0-9]+\.[0-9]+$
  buildTag string
  The tag name to be applied to a successful build of the Actor. Defaults to 'latest' if not specified.
  environmentVariables object
  A map of environment variables to be used during local development and deployment.
  property name* string
  dockerfile string
  The path to the Dockerfile used for building the Actor on the platform.
  dockerContextDir string
  The path to the directory used as the Docker context when building the Actor.
  readme string
  The path to the README file for the Actor.
  input object
  The input schema object, the full specification can be found in Apify docs
  changelog string
  The path to the CHANGELOG file displayed in the Actor's information tab.
  storages object
  dataset object
  Defines the schema of items in your dataset, the full specification can be found in Apify docs
  defaultMemoryMbytes object
  Specifies the default amount of memory in megabytes to be used when the Actor is started. Can be an integer or a dynamic memory expression.
  oneOf
  string
  integer
  string
  Examples:
  Example 1
  Example 2
  Example 3
  
  Example: get(input
  minMemoryMbytes integer
  Specifies the minimum amount of memory in megabytes required by the Actor.
  Possible values: >= 256
  maxMemoryMbytes integer
  Specifies the maximum amount of memory in megabytes required by the Actor.
  Possible values: >= 256
  usesStandbyMode boolean
  Specifies whether Standby mode is enabled for the Actor.

Status 400

Bad request - invalid input parameters or request body.

{
  "error": {
    "type": "invalid-input",
    "message": "Invalid input: The request body contains invalid data."
  }
}

Schema

error object required
- type string required
  Example: run-failed
- message string required
  Example: Actor run did not succeed (run ID: 55uatRrZib4xbZs, status: FAILED)