Get default build

GET /v2/acts/:actorId/builds/default

Get the default build for an Actor.

Use the optional waitForFinish parameter to synchronously wait for the build to finish. This avoids the need for periodic polling when waiting for the build to complete.

This endpoint does not require an authentication token. Instead, calls are authenticated using the Actor's unique ID. However, if you access the endpoint without a token, certain attributes (e.g., 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

Query Parameters

waitForFinish double

The maximum number of seconds the server waits for the build to finish. If the build finishes within this time, the returned build object will have a terminal status (e.g. SUCCEEDED), otherwise it will have a transitional status (e.g. RUNNING).

By default it is 0, the maximum value is 60.

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)