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

# Changes to Update Actor

`PUT /v2/actors/{actorId}`

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

## Timeline

Changed in 10 of 25 revisions.

- **2026-11-04** `68d2d102e6a2`: 1 breaking, 3 warning, 3 info
- **2026-10-27** `ec76185eb934`: 8 info
- **2026-10-27** `e52dd2239cee`: 24 info
- **2026-10-20** `e4eb4002a964`: 2 info
- **2026-10-20** `16b486b0397a`: 3 breaking, 72 warning, 2 info
- **2026-10-20** `20256bd88fdb`: 14 breaking, 6 info
- **2026-08-28** `0a98d6a098a4`: 9 warning
- **2026-08-04** `01a71794279b`: 3 warning, 1 info
- **2026-07-31** `5ceb2cdfe616`: 1 info
- **2026-07-26** `b94a8abdfff1`: 1 breaking, 8 warning

## Changes

- **2026-11-04** `68d2d102e6a2`: 1 breaking, 3 warning, 3 info
  - request property `actorStandby/anyOf[subschema #1: ActorStandby]/tenancy` was restricted to a list of enum values
  - added the new `MULTI_TENANT` enum value to the `data/actorStandby/anyOf[subschema #1: ActorStandby]/tenancy` response property for the response status `200`
  - added the new `SINGLE_TENANT` enum value to the `data/actorStandby/anyOf[subschema #1: ActorStandby]/tenancy` response property for the response status `200`
  - added the new `undefined` enum value to the `data/actorStandby/anyOf[subschema #1: ActorStandby]/tenancy` response property for the response status `200`
  - added the new `MULTI_TENANT` enum value to the request property `actorStandby/anyOf[subschema #1: ActorStandby]/tenancy`
  - added the new `SINGLE_TENANT` enum value to the request property `actorStandby/anyOf[subschema #1: ActorStandby]/tenancy`
  - added the new `undefined` enum value to the request property `actorStandby/anyOf[subschema #1: ActorStandby]/tenancy`
- **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`: 24 info
  - added the new optional request property `actorStandby/anyOf[subschema #1: ActorStandby]/isConsoleAuthEnabled`
  - added the new optional request property `actorStandby/anyOf[subschema #1: ActorStandby]/isTokenlessEnabled`
  - added the new optional request property `actorStandby/anyOf[subschema #1: ActorStandby]/tenancy`
  - added the new optional request property `defaultRunOptions/anyOf[subschema #1: DefaultRunOptions]/isMaxTotalChargeUsdSetByUser`
  - added the new optional request property `defaultRunOptions/anyOf[subschema #1: DefaultRunOptions]/maxTotalChargeUsd`
  - added the new optional request property `pricingInfos/items/oneOf[subschema #1: PayPerEventActorPricingInfo]/allOf[subschema #1: CommonActorPricingInfo]/notifiedAboutRentalToPpePriceChangeAt`
  - added the new optional request property `pricingInfos/items/oneOf[subschema #1: PayPerEventActorPricingInfo]/allOf[subschema #2]/isPPEPlatformUsagePaidByUser`
  - added the new optional request property `pricingInfos/items/oneOf[subschema #2: PricePerDatasetItemActorPricingInfo]/allOf[subschema #1: CommonActorPricingInfo]/notifiedAboutRentalToPpePriceChangeAt`
  - added the new optional request property `pricingInfos/items/oneOf[subschema #3: FlatPricePerMonthActorPricingInfo]/allOf[subschema #1: CommonActorPricingInfo]/notifiedAboutRentalToPpePriceChangeAt`
  - added the new optional request property `pricingInfos/items/oneOf[subschema #4: FreeActorPricingInfo]/allOf[subschema #1: CommonActorPricingInfo]/notifiedAboutRentalToPpePriceChangeAt`
  - added the optional property `data/actorStandby/anyOf[subschema #1: ActorStandby]/isConsoleAuthEnabled` to the response with the `200` status
  - added the optional property `data/actorStandby/anyOf[subschema #1: ActorStandby]/isTokenlessEnabled` to the response with the `200` status
  - added the optional property `data/actorStandby/anyOf[subschema #1: ActorStandby]/tenancy` to the response with the `200` status
  - added the optional property `data/defaultRunOptions/isMaxTotalChargeUsdSetByUser` to the response with the `200` status
  - added the optional property `data/defaultRunOptions/maxTotalChargeUsd` to the response with the `200` status
  - added the optional property `data/pricingInfos/items/oneOf[subschema #1: PayPerEventActorPricingInfo]/allOf[subschema #1: CommonActorPricingInfo]/notifiedAboutRentalToPpePriceChangeAt` to the response with the `200` status
  - added the optional property `data/pricingInfos/items/oneOf[subschema #1: PayPerEventActorPricingInfo]/allOf[subschema #2]/isPPEPlatformUsagePaidByUser` to the response with the `200` status
  - added the optional property `data/pricingInfos/items/oneOf[subschema #2: PricePerDatasetItemActorPricingInfo]/allOf[subschema #1: CommonActorPricingInfo]/notifiedAboutRentalToPpePriceChangeAt` to the response with the `200` status
  - added the optional property `data/pricingInfos/items/oneOf[subschema #3: FlatPricePerMonthActorPricingInfo]/allOf[subschema #1: CommonActorPricingInfo]/notifiedAboutRentalToPpePriceChangeAt` to the response with the `200` status
  - added the optional property `data/pricingInfos/items/oneOf[subschema #4: FreeActorPricingInfo]/allOf[subschema #1: CommonActorPricingInfo]/notifiedAboutRentalToPpePriceChangeAt` to the response with the `200` status
  - added the optional property `data/versions/items/bitbucketWebhookId` to the response with the `200` status
  - added the optional property `data/versions/items/envVars/anyOf[subschema #1]/items/valueHash` to the response with the `200` status
  - added the optional property `data/versions/items/githubWebhookId` to the response with the `200` status
  - added the optional property `data/versions/items/gitlabWebhookId` to the response with the `200` status
- **2026-10-20** `e4eb4002a964`: 2 info
  - request property `pricingInfos/items/oneOf[subschema #3: FlatPricePerMonthActorPricingInfo]/` deprecated
  - response property `data/pricingInfos/items/oneOf[subschema #3: FlatPricePerMonthActorPricingInfo]/` deprecated
- **2026-10-20** `16b486b0397a`: 3 breaking, 72 warning, 2 info
  - the response property `data/defaultRunOptions/restartOnError` became nullable for the status `200`
  - the response property `data/pricingInfos/items/oneOf[subschema #1: PayPerEventActorPricingInfo]/allOf[subschema #2]/pricingPerEvent/actorChargeEvents/additionalProperties/isOneTimeEvent` became nullable for the status `200`
  - the response property `data/restartOnError` became nullable for the status `200`
  - 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`
  - …37 more
- **2026-10-20** `20256bd88fdb`: 14 breaking, 6 info
  - removed `#/components/schemas/ActorPermissionLevel, subschema #2` from the `actorPermissionLevel` request property `anyOf` list
  - removed `#/components/schemas/VersionSourceType, subschema #2` from the `versions/items/sourceType` request property `anyOf` list
  - request property `actorPermissionLevel` was restricted to a list of enum values
  - request property `versions/items/sourceType` was restricted to a list of enum values
  - the request property `versions/items/gitHubGistUrl` became not nullable
  - the request property `versions/items/gitRepoUrl` became not nullable
  - the request property `versions/items/tarballUrl` became not nullable
  - the request property `versions/items/versionNumber` became not nullable
  - the request property `versions/items/sourceType` became required
  - the request property `versions/items/versionNumber` became required
  - request property `versions/items/envVars` list-of-types was narrowed by removing types `null` from media type `application/json`
  - the `versions` request property's minItems was increased to `1`
  - the `actorPermissionLevel` request property type changed from no type to `string`
  - the `versions/items/sourceType` request property type changed from no type to `string`
  - added the new `FULL_PERMISSIONS` enum value to the request property `actorPermissionLevel`
  - added the new `GITHUB_GIST` enum value to the request property `versions/items/sourceType`
  - added the new `GIT_REPO` enum value to the request property `versions/items/sourceType`
  - added the new `LIMITED_PERMISSIONS` enum value to the request property `actorPermissionLevel`
  - added the new `SOURCE_FILES` enum value to the request property `versions/items/sourceType`
  - added the new `TARBALL` enum value to the request property `versions/items/sourceType`
- **2026-08-28** `0a98d6a098a4`: 9 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`
  - added the new `undefined` enum value to the `data/notice` response property for the response status `200`
- **2026-08-04** `01a71794279b`: 3 warning, 1 info
  - added the new `NONE` enum value to the `data/notice` response property for the response status `200`
  - added the new `RESIDENTIAL_PROXY_REQUIRED` enum value to the `data/notice` response property for the response status `200`
  - added the new `UNDER_MAINTENANCE` enum value to the `data/notice` response property for the response status `200`
  - the `isSourceCodeHidden` response's property default value `true` was added for the status `200`
- **2026-07-31** `5ceb2cdfe616`: 1 info
  - api operation id `act_put` removed and replaced with `actor_put`
- **2026-07-26** `b94a8abdfff1`: 1 breaking, 8 warning
  - the response property `data/taggedBuilds/anyOf[subschema #1: TaggedBuilds]/additionalProperties/anyOf[subschema #1: TaggedBuildInfo]/buildNumber` became nullable for the status `200`
  - 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/put.md) - [API](https://skmtc.dev/apify/apis/apify-api.md) - [Page](https://skmtc.dev/apify/apis/apify-api/changes/v2/actors/:actorId/put)
