---
title: "Update version (POST)"
method: POST
path: "/v2/actors/{actorId}/versions/{versionNumber}"
tags: ["Actors/Actor versions"]
---

# Update version (POST)

`POST /v2/actors/{actorId}/versions/{versionNumber}`

Updates Actor version using values specified by a [Version object](#/reference/actors/version-object) passed as JSON in the POST payload.
This endpoint is an alias for the [`PUT` update version](#tag/ActorsVersion-object/operation/act_version_put) method and behaves identically.

## Path parameters

- `actorId` string, required
- `versionNumber` string, required

## Request body

- CreateOrUpdateVersionRequest
  - `versionNumber` string, nullable — The version number of the Actor. Two numbers separated by a dot, that represent the `MAJOR.MINOR` part of the semantic versioning.
  - `sourceType` 'SOURCE_FILES' | 'GIT_REPO' | 'TARBALL' | 'GITHUB_GIST' | 'SOURCE_CODE'
  - `envVars` EnvVar[], nullable — Environment variables for the version.
    - `name` string, required — The name of the environment variable.
    - `value` string — The value of the environment variable. If `isSecret` is `true`, this value isn't returned by the API.
    - `isSecret` boolean, nullable — Whether the environment variable is encrypted. Secret values aren't returned by the API.
  - `applyEnvVarsToBuild` boolean, nullable — Whether to inject the environment variables at build time.
  - `buildTag` string, nullable — The tag name to apply to a successful build of this version. Can be `null` when the version has no build tag.
  - `sourceFiles` union[]
    - union
      - SourceCodeFile — Represents a single file in the Actor's source code.
        - `format` 'BASE64' | 'TEXT'
        - `content` string — The contents of the file. Interpreted based on the value of `format`.
        - `name` string, required — The path of the file relative to the Actor's root directory.
      - SourceCodeFolder — Represents a folder in the Actor's source code structure. Distinguished from SourceCodeFile by the presence of the `folder` property set to `true`.
        - `name` string, required — The path of the folder relative to the Actor's root directory.
        - `folder` boolean, required — Whether it's a folder. Distinguishes folders from files.
  - `gitRepoUrl` string, nullable — URL of the Git repository to clone the source code from. Applies when the `sourceType` is `GIT_REPO`.
  - `tarballUrl` string, nullable — URL of the tarball to download the source code from. Applies when the `sourceType` is `TARBALL`.
  - `gitHubGistUrl` string, nullable — URL of the GitHub Gist to clone the source code from. Applies when the `sourceType` is `GITHUB_GIST`.

## Response `200`

- VersionResponse
  - `data` Version, required
    - `versionNumber` string, required — The version number of the Actor. Two numbers separated by a dot, that represent the `MAJOR.MINOR` part of the semantic versioning.
    - `sourceType` 'SOURCE_FILES' | 'GIT_REPO' | 'TARBALL' | 'GITHUB_GIST' | 'SOURCE_CODE', required
    - `envVars` EnvVar[], nullable — Environment variables for the version.
      - `name` string, required — The name of the environment variable.
      - `value` string — The value of the environment variable. If `isSecret` is `true`, this value isn't returned by the API.
      - `isSecret` boolean, nullable — Whether the environment variable is encrypted. Secret values aren't returned by the API.
    - `applyEnvVarsToBuild` boolean, nullable — Whether to inject the environment variables at build time.
    - `buildTag` string, nullable — The tag name to apply to a successful build of this version. Can be `null` when the version has no build tag.
    - `sourceFiles` union[]
      - union
        - SourceCodeFile — Represents a single file in the Actor's source code.
          - `format` 'BASE64' | 'TEXT'
          - `content` string — The contents of the file. Interpreted based on the value of `format`.
          - `name` string, required — The path of the file relative to the Actor's root directory.
        - SourceCodeFolder — Represents a folder in the Actor's source code structure. Distinguished from SourceCodeFile by the presence of the `folder` property set to `true`.
          - `name` string, required — The path of the folder relative to the Actor's root directory.
          - `folder` boolean, required — Whether it's a folder. Distinguishes folders from files.
    - `gitRepoUrl` string, nullable — URL of the Git repository to clone the source code from. Applies when the `sourceType` is `GIT_REPO`.
    - `tarballUrl` string, nullable — URL to download the source code from as a tarball or ZIP file. Applies when the `sourceType` is `TARBALL`.
    - `gitHubGistUrl` string, nullable — URL of the GitHub Gist to clone the source code from. Applies when the `sourceType` is `GITHUB_GIST`.

## Other responses

- `400` — Bad request - invalid input parameters or request body.
- `401` — Unauthorized - authentication required or invalid token.
- `403` — Forbidden - insufficient permissions to perform this action.
- `404` — Not found - the requested resource does not exist.
- `405` — Method not allowed.
- `413` — Payload too large - the request body exceeds the size limit.
- `415` — Unsupported media type - the Content-Encoding of the request is not supported.
- `429` — Too many requests - rate limit exceeded.

---

[API](https://skmtc.net/apify/apis/apify-api.md) · [All operations](https://skmtc.net/apify/apis/apify-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/apify/apify-api/versions/01a71794279b/schema)