Get version

GET 
/v2/acts/:actorId/versions/:versionNumber

Gets a Version object that contains all the details about a specific version of an Actor.

Request

Path Parameters

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

Example: janedoe~my-actor
versionNumber string required
Actor major and minor version of the Actor.

Example: 1.0

Status 200

Response Headers

{
  "data": {
    "versionNumber": "0.0",
    "sourceType": "SOURCE_FILES",
    "envVars": "Unknown Type: array,null",
    "applyEnvVarsToBuild": false,
    "buildTag": "latest",
    "sourceFiles": [
      {
        "format": "TEXT",
        "content": "console.log('This is the main.js file');",
        "name": "src/main.js"
      },
      {
        "name": "src/utils",
        "folder": true
      }
    ],
    "gitRepoUrl": "string",
    "tarballUrl": "string",
    "gitHubGistUrl": "string"
  }
}

Schema

• data object required

  • versionNumber string required
    Example: 0.0
  • sourceType object required

    anyOf
    • VersionSourceType
    • null

    VersionSourceType (string)

    Possible values: [SOURCE_FILES, GIT_REPO, TARBALL, GITHUB_GIST]

  • envVars object[]

    • name string required
      Example: MY_ENV_VAR
    • value string required
      Example: my-value
    • isSecret boolean | null nullable
      Example: false
  • applyEnvVarsToBuild boolean | null nullable
    Example: false
  • buildTag string
    Example: latest
  • sourceFiles object[]

    anyOf
    • SourceCodeFile
    • SourceCodeFolder
    format SourceCodeFileFormat (string) required
    Possible values: [BASE64, TEXT]
    
    Example: TEXT
    content string required
    Example: console.log('This is the main.js file');
    name string required
    Example: src/main.js
  • gitRepoUrl string | null nullable

    URL of the Git repository when sourceType is GIT_REPO.

  • tarballUrl string | null nullable

    URL of the tarball when sourceType is TARBALL.

  • gitHubGistUrl string | null nullable

    URL of the GitHub Gist when sourceType is GITHUB_GIST.

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)