---
title: "Changes to Update Actor version"
method: PUT
path: "/v2/actors/{actorId}/versions/{versionNumber}"
---

# Changes to Update Actor version

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

> Every recorded change to this operation, newest first.
> 25 revisions in range; 1 not diffed.

## Timeline

Changed in 7 of 25 revisions.

- **2026-10-27** `ec76185eb934`: 8 info
- **2026-10-27** `e52dd2239cee`: 4 info
- **2026-10-20** `16b486b0397a`: 72 warning
- **2026-10-20** `20256bd88fdb`: 8 breaking, 4 info
- **2026-08-28** `0a98d6a098a4`: 8 warning
- **2026-07-31** `5ceb2cdfe616`: 1 info
- **2026-07-26** `b94a8abdfff1`: 8 warning

## Changes

- **2026-10-27** `ec76185eb934`: 8 info
  - added the optional property `error/data` to the response with the `400` status
  - added the optional property `error/data` to the response with the `401` status
  - added the optional property `error/data` to the response with the `403` status
  - added the optional property `error/data` to the response with the `404` status
  - added the optional property `error/data` to the response with the `405` status
  - added the optional property `error/data` to the response with the `413` status
  - added the optional property `error/data` to the response with the `415` status
  - added the optional property `error/data` to the response with the `429` status
- **2026-10-27** `e52dd2239cee`: 4 info
  - added the optional property `data/bitbucketWebhookId` to the response with the `200` status
  - added the optional property `data/envVars/anyOf[subschema #1]/items/valueHash` to the response with the `200` status
  - added the optional property `data/githubWebhookId` to the response with the `200` status
  - added the optional property `data/gitlabWebhookId` to the response with the `200` status
- **2026-10-20** `16b486b0397a`: 72 warning
  - added the new `full-permissions-require-verified-owner` enum value to the `error/type` response property for the response status `400`
  - added the new `full-permissions-require-verified-owner` enum value to the `error/type` response property for the response status `401`
  - added the new `full-permissions-require-verified-owner` enum value to the `error/type` response property for the response status `403`
  - added the new `full-permissions-require-verified-owner` enum value to the `error/type` response property for the response status `404`
  - added the new `full-permissions-require-verified-owner` enum value to the `error/type` response property for the response status `405`
  - added the new `full-permissions-require-verified-owner` enum value to the `error/type` response property for the response status `413`
  - added the new `full-permissions-require-verified-owner` enum value to the `error/type` response property for the response status `415`
  - added the new `full-permissions-require-verified-owner` enum value to the `error/type` response property for the response status `429`
  - added the new `input-validation-timed-out` enum value to the `error/type` response property for the response status `400`
  - added the new `input-validation-timed-out` enum value to the `error/type` response property for the response status `401`
  - added the new `input-validation-timed-out` enum value to the `error/type` response property for the response status `403`
  - added the new `input-validation-timed-out` enum value to the `error/type` response property for the response status `404`
  - added the new `input-validation-timed-out` enum value to the `error/type` response property for the response status `405`
  - added the new `input-validation-timed-out` enum value to the `error/type` response property for the response status `413`
  - added the new `input-validation-timed-out` enum value to the `error/type` response property for the response status `415`
  - added the new `input-validation-timed-out` enum value to the `error/type` response property for the response status `429`
  - added the new `mcp-connector-actor-not-allowed` enum value to the `error/type` response property for the response status `400`
  - added the new `mcp-connector-actor-not-allowed` enum value to the `error/type` response property for the response status `401`
  - added the new `mcp-connector-actor-not-allowed` enum value to the `error/type` response property for the response status `403`
  - added the new `mcp-connector-actor-not-allowed` enum value to the `error/type` response property for the response status `404`
  - added the new `mcp-connector-actor-not-allowed` enum value to the `error/type` response property for the response status `405`
  - added the new `mcp-connector-actor-not-allowed` enum value to the `error/type` response property for the response status `413`
  - added the new `mcp-connector-actor-not-allowed` enum value to the `error/type` response property for the response status `415`
  - added the new `mcp-connector-actor-not-allowed` enum value to the `error/type` response property for the response status `429`
  - added the new `more-public-actors-require-verified-owner` enum value to the `error/type` response property for the response status `400`
  - added the new `more-public-actors-require-verified-owner` enum value to the `error/type` response property for the response status `401`
  - added the new `more-public-actors-require-verified-owner` enum value to the `error/type` response property for the response status `403`
  - added the new `more-public-actors-require-verified-owner` enum value to the `error/type` response property for the response status `404`
  - added the new `more-public-actors-require-verified-owner` enum value to the `error/type` response property for the response status `405`
  - added the new `more-public-actors-require-verified-owner` enum value to the `error/type` response property for the response status `413`
  - added the new `more-public-actors-require-verified-owner` enum value to the `error/type` response property for the response status `415`
  - added the new `more-public-actors-require-verified-owner` enum value to the `error/type` response property for the response status `429`
  - added the new `readme-required` enum value to the `error/type` response property for the response status `400`
  - added the new `readme-required` enum value to the `error/type` response property for the response status `401`
  - added the new `readme-required` enum value to the `error/type` response property for the response status `403`
  - added the new `readme-required` enum value to the `error/type` response property for the response status `404`
  - added the new `readme-required` enum value to the `error/type` response property for the response status `405`
  - added the new `readme-required` enum value to the `error/type` response property for the response status `413`
  - added the new `readme-required` enum value to the `error/type` response property for the response status `415`
  - added the new `readme-required` enum value to the `error/type` response property for the response status `429`
  - …32 more
- **2026-10-20** `20256bd88fdb`: 8 breaking, 4 info
  - removed `#/components/schemas/VersionSourceType, subschema #2` from the `sourceType` request property `anyOf` list
  - request property `sourceType` was restricted to a list of enum values
  - the request property `gitHubGistUrl` became not nullable
  - the request property `gitRepoUrl` became not nullable
  - the request property `tarballUrl` became not nullable
  - the request property `versionNumber` became not nullable
  - request property `envVars` list-of-types was narrowed by removing types `null` from media type `application/json`
  - the `sourceType` request property type changed from no type to `string`
  - added the new `GITHUB_GIST` enum value to the request property `sourceType`
  - added the new `GIT_REPO` enum value to the request property `sourceType`
  - added the new `SOURCE_FILES` enum value to the request property `sourceType`
  - added the new `TARBALL` enum value to the request property `sourceType`
- **2026-08-28** `0a98d6a098a4`: 8 warning
  - added the new `cannot-publish-actor-task` enum value to the `error/type` response property for the response status `400`
  - added the new `cannot-publish-actor-task` enum value to the `error/type` response property for the response status `401`
  - added the new `cannot-publish-actor-task` enum value to the `error/type` response property for the response status `403`
  - added the new `cannot-publish-actor-task` enum value to the `error/type` response property for the response status `404`
  - added the new `cannot-publish-actor-task` enum value to the `error/type` response property for the response status `405`
  - added the new `cannot-publish-actor-task` enum value to the `error/type` response property for the response status `413`
  - added the new `cannot-publish-actor-task` enum value to the `error/type` response property for the response status `415`
  - added the new `cannot-publish-actor-task` enum value to the `error/type` response property for the response status `429`
- **2026-07-31** `5ceb2cdfe616`: 1 info
  - api operation id `act_version_put` removed and replaced with `actor_version_put`
- **2026-07-26** `b94a8abdfff1`: 8 warning
  - added the new `cannot-monetize-without-payout-billing-info` enum value to the `error/type` response property for the response status `400`
  - added the new `cannot-monetize-without-payout-billing-info` enum value to the `error/type` response property for the response status `401`
  - added the new `cannot-monetize-without-payout-billing-info` enum value to the `error/type` response property for the response status `403`
  - added the new `cannot-monetize-without-payout-billing-info` enum value to the `error/type` response property for the response status `404`
  - added the new `cannot-monetize-without-payout-billing-info` enum value to the `error/type` response property for the response status `405`
  - added the new `cannot-monetize-without-payout-billing-info` enum value to the `error/type` response property for the response status `413`
  - added the new `cannot-monetize-without-payout-billing-info` enum value to the `error/type` response property for the response status `415`
  - added the new `cannot-monetize-without-payout-billing-info` enum value to the `error/type` response property for the response status `429`

---

[Operation](https://skmtc.dev/apify/apis/apify-api/docs/v2/actors/:actorId/versions/:versionNumber/put.md) - [API](https://skmtc.dev/apify/apis/apify-api.md) - [Page](https://skmtc.dev/apify/apis/apify-api/changes/v2/actors/:actorId/versions/:versionNumber/put)