---
title: "Changes to Create Actor"
method: POST
path: "/v2/actors"
---

# Changes to Create Actor

`POST /v2/actors`

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

## Timeline

Changed in 11 of 25 revisions.

- **2026-11-04** `68d2d102e6a2`: 1 breaking, 3 warning, 3 info
- **2026-10-27** `ec76185eb934`: 7 info
- **2026-10-27** `e52dd2239cee`: 19 info
- **2026-10-20** `e4eb4002a964`: 1 info
- **2026-10-20** `16b486b0397a`: 3 breaking, 63 warning, 1 info
- **2026-10-20** `20256bd88fdb`: 3 breaking, 1 info
- **2026-08-28** `0a98d6a098a4`: 8 warning
- **2026-08-24** `97ae08d8e69c`: 1 warning
- **2026-08-04** `01a71794279b`: 3 warning, 1 info
- **2026-07-31** `5ceb2cdfe616`: 1 info
- **2026-07-26** `b94a8abdfff1`: 1 breaking, 7 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 `201`
  - added the new `SINGLE_TENANT` enum value to the `data/actorStandby/anyOf[subschema #1: ActorStandby]/tenancy` response property for the response status `201`
  - added the new `undefined` enum value to the `data/actorStandby/anyOf[subschema #1: ActorStandby]/tenancy` response property for the response status `201`
  - 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`: 7 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 `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`: 19 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/isMaxTotalChargeUsdSetByUser`
  - added the new optional request property `defaultRunOptions/maxTotalChargeUsd`
  - added the optional property `data/actorStandby/anyOf[subschema #1: ActorStandby]/isConsoleAuthEnabled` to the response with the `201` status
  - added the optional property `data/actorStandby/anyOf[subschema #1: ActorStandby]/isTokenlessEnabled` to the response with the `201` status
  - added the optional property `data/actorStandby/anyOf[subschema #1: ActorStandby]/tenancy` to the response with the `201` status
  - added the optional property `data/defaultRunOptions/isMaxTotalChargeUsdSetByUser` to the response with the `201` status
  - added the optional property `data/defaultRunOptions/maxTotalChargeUsd` to the response with the `201` status
  - added the optional property `data/pricingInfos/items/oneOf[subschema #1: PayPerEventActorPricingInfo]/allOf[subschema #1: CommonActorPricingInfo]/notifiedAboutRentalToPpePriceChangeAt` to the response with the `201` status
  - added the optional property `data/pricingInfos/items/oneOf[subschema #1: PayPerEventActorPricingInfo]/allOf[subschema #2]/isPPEPlatformUsagePaidByUser` to the response with the `201` status
  - added the optional property `data/pricingInfos/items/oneOf[subschema #2: PricePerDatasetItemActorPricingInfo]/allOf[subschema #1: CommonActorPricingInfo]/notifiedAboutRentalToPpePriceChangeAt` to the response with the `201` status
  - added the optional property `data/pricingInfos/items/oneOf[subschema #3: FlatPricePerMonthActorPricingInfo]/allOf[subschema #1: CommonActorPricingInfo]/notifiedAboutRentalToPpePriceChangeAt` to the response with the `201` status
  - added the optional property `data/pricingInfos/items/oneOf[subschema #4: FreeActorPricingInfo]/allOf[subschema #1: CommonActorPricingInfo]/notifiedAboutRentalToPpePriceChangeAt` to the response with the `201` status
  - added the optional property `data/versions/items/bitbucketWebhookId` to the response with the `201` status
  - added the optional property `data/versions/items/envVars/anyOf[subschema #1]/items/valueHash` to the response with the `201` status
  - added the optional property `data/versions/items/githubWebhookId` to the response with the `201` status
  - added the optional property `data/versions/items/gitlabWebhookId` to the response with the `201` status
- **2026-10-20** `e4eb4002a964`: 1 info
  - response property `data/pricingInfos/items/oneOf[subschema #3: FlatPricePerMonthActorPricingInfo]/` deprecated
- **2026-10-20** `16b486b0397a`: 3 breaking, 63 warning, 1 info
  - the response property `data/defaultRunOptions/restartOnError` became nullable for the status `201`
  - the response property `data/pricingInfos/items/oneOf[subschema #1: PayPerEventActorPricingInfo]/allOf[subschema #2]/pricingPerEvent/actorChargeEvents/additionalProperties/isOneTimeEvent` became nullable for the status `201`
  - the response property `data/restartOnError` became nullable for the status `201`
  - 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 `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 `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 `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 `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 `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`
  - added the new `schemas-required` enum value to the `error/type` response property for the response status `400`
  - added the new `schemas-required` enum value to the `error/type` response property for the response status `401`
  - …27 more
- **2026-10-20** `20256bd88fdb`: 3 breaking, 1 info
  - the request property `isPublic` became not nullable
  - request property `versions` list-of-types was narrowed by removing types `null` from media type `application/json`
  - the `versions` request property's minItems was increased to `1`
  - added the new optional request property `actorPermissionLevel`
- **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 `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 `201`
- **2026-08-24** `97ae08d8e69c`: 1 warning
  - removed the request property `pricingInfos`
- **2026-08-04** `01a71794279b`: 3 warning, 1 info
  - added the new `NONE` enum value to the `data/notice` response property for the response status `201`
  - added the new `RESIDENTIAL_PROXY_REQUIRED` enum value to the `data/notice` response property for the response status `201`
  - added the new `UNDER_MAINTENANCE` enum value to the `data/notice` response property for the response status `201`
  - the `isSourceCodeHidden` response's property default value `true` was added for the status `201`
- **2026-07-31** `5ceb2cdfe616`: 1 info
  - api operation id `acts_post` removed and replaced with `actors_post`
- **2026-07-26** `b94a8abdfff1`: 1 breaking, 7 warning
  - the response property `data/taggedBuilds/anyOf[subschema #1: TaggedBuilds]/additionalProperties/anyOf[subschema #1: TaggedBuildInfo]/buildNumber` became nullable for the status `201`
  - 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 `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/post.md) - [API](https://skmtc.dev/apify/apis/apify-api.md) - [Page](https://skmtc.dev/apify/apis/apify-api/changes/v2/actors/post)
