Update version
PUT/v2/acts/:actorId/versions/:versionNumber
Updates Actor version using values specified by a Version object passed as JSON in the POST payload.
If the object does not define a specific property, its value will not be updated.
The request needs to specify the Content-Type: application/json HTTP
header!
When providing your API authentication token, we recommend using the
request's Authorization header, rather than the URL. (More
info).
The response is the Version object as returned by the Get version endpoint.
Request
Path Parameters
Actor ID or a tilde-separated owner's username and Actor name.
Example:janedoe~my-actorActor major and minor version of the Actor.
Example:1.0Bodyrequired
- versionNumber string | null nullableExample:
0.0 sourceType object
- anyOf
- VersionSourceType
- null
- VersionSourceType (string)
Possible values: [
SOURCE_FILES,GIT_REPO,TARBALL,GITHUB_GIST]
envVars object[]
- name string requiredExample:
MY_ENV_VAR - value string requiredExample:
my-value - isSecret boolean | null nullableExample:
false
- name string requiredExample:
- applyEnvVarsToBuild boolean | null nullableExample:
false - buildTag string | null nullableExample:
latest sourceFiles object[]
- anyOf
- SourceCodeFile
- SourceCodeFolder
- format SourceCodeFileFormat (string) required
Possible values: [
Example:BASE64,TEXT]TEXT - content string requiredExample:
console.log('This is the main.js file'); - name string requiredExample:
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 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 requiredExample:
0.0 sourceType object required
- anyOf
- VersionSourceType
- null
- VersionSourceType (string)
Possible values: [
SOURCE_FILES,GIT_REPO,TARBALL,GITHUB_GIST]
envVars object[]
- name string requiredExample:
MY_ENV_VAR - value string requiredExample:
my-value - isSecret boolean | null nullableExample:
false
- name string requiredExample:
- applyEnvVarsToBuild boolean | null nullableExample:
false - buildTag stringExample:
latest sourceFiles object[]
- anyOf
- SourceCodeFile
- SourceCodeFolder
- format SourceCodeFileFormat (string) required
Possible values: [
Example:BASE64,TEXT]TEXT - content string requiredExample:
console.log('This is the main.js file'); - name string requiredExample:
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.
- versionNumber string requiredExample:
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 requiredExample:
run-failed - message string requiredExample:
Actor run did not succeed (run ID: 55uatRrZib4xbZs, status: FAILED)
- type string requiredExample: