Actor builds6

Actor runs10

Actor tasks15

Actors6

Actors/Actor builds6

Actors/Actor runs11

Actors/Actor versions12

Actors/Webhook collection1

Default dataset6

Default key-value store9

Default request queue15

Last Actor run's abort1

Last Actor run's default dataset6

Last Actor run's default key-value store9

Last Actor run's default request queue15

Last Actor run's log1

Last Actor run's metamorph1

Last Actor run's reboot1

Last Actor task run's abort1

Last Actor task run's default dataset6

Last Actor task run's default key-value store9

Last Actor task run's default request queue15

Last Actor task run's log1

Last Actor task run's metamorph1

Last Actor task run's reboot1

Logs1

Schedules6

Storage/Datasets9

Storage/Key-value stores12

Storage/Request queues7

Storage/Request queues/Requests5

Storage/Request queues/Requests locks5

Store1

Tools4

Tools/Encoding2

Users2

Users/Usage3

Webhooks/Webhook dispatches2

Webhooks/Webhooks7

Actors/Actor runs

Metamorph run

[DEPRECATED] API endpoints related to run of the Actor were moved under new namespace actor-runs. Transforms an Actor run into a run of another Actor with a new input.

This is useful if you want to use another Actor to finish the work of your current Actor run, without the need to create a completely new run and waiting for its finish. For the users of your Actors, the metamorph operation is transparent, they will just see your Actor got the work done.

There is a limit on how many times you can metamorph a single run. You can check the limit in the Actor runtime limits.

Internally, the system stops the Docker container corresponding to the Actor run and starts a new container using a different Docker image. All the default storages are preserved and the new input is stored under the INPUT-METAMORPH-1 key in the same default key-value store.

For more information, see the Actor docs.

post/v2/actors/{actorId}/runs/{runId}/metamorph

Path parameters

actorIdstring required

Example:compass~google-maps-extractor

Actor ID or the username of the Actor owner and the Actor name, separated by a tilde (~).

runIdstring required

Example:3KH8gEpp4d8uQSe8T

Actor run ID.

Query parameters

targetActorIdstring required

Example:HDSasDasz78YcAPEB

ID of a target Actor that the run should be transformed into.

buildstring

Example:beta

Optional build of the target Actor.

It can be either a build tag or build number. By default, the run uses the build specified in the default run configuration for the target Actor (typically latest).

Response

Example response

{
  "data": {
    "id": "HG7ML7M8z78YcAPEB",
    "actId": "HDSasDasz78YcAPEB",
    "userId": "7sT5jcggjjA9fNcxF",
    "actorTaskId": "KJHSKHausidyaJKHs",
    "startedAt": "2019-11-30T07:34:24.202Z",
    "finishedAt": "2019-12-12T09:30:12.202Z",
    "statusMessage": "Actor is running",
    "pricingInfo": {
      "apifyMarginPercentage": 0.2
    },
    "stats": {
      "inputBodyLen": 240,
      "resurrectCount": 2,
      "memAvgBytes": 267874071.9,
      "memMaxBytes": 404713472,
      "cpuAvgUsage": 33.7532101107538,
      "cpuMaxUsage": 169.650735534941,
      "netRxBytes": 103508042,
      "netTxBytes": 4854600,
      "durationMillis": 248472,
      "runTimeSecs": 248.472,
      "computeUnits": 0.13804
    },
    "chargedEventCounts": {
      "actor-start": 1,
      "page-crawled": 150,
      "data-extracted": 75
    },
    "options": {
      "build": "latest",
      "timeoutSecs": 300,
      "memoryMbytes": 1024,
      "diskMbytes": 2048,
      "maxItems": 1000,
      "maxTotalChargeUsd": 5
    },
    "buildId": "7sT5jcggjjA9fNcxF",
    "generalAccess": "RESTRICTED",
    "defaultKeyValueStoreId": "eJNzqsbPiopwJcgGQ",
    "defaultDatasetId": "wmKPijuyDnPZAPRMk",
    "defaultRequestQueueId": "FL35cSF7jrxr3BY39",
    "storageIds": {
      "datasets": {
        "default": "wmKPijuyDnPZAPRMk"
      },
      "keyValueStores": {
        "default": "eJNzqsbPiopwJcgGQ"
      },
      "requestQueues": {
        "default": "FL35cSF7jrxr3BY39"
      }
    },
    "buildNumber": "0.0.36",
    "containerUrl": "https://g8kd8kbc5ge8.runs.apify.net",
    "isContainerServerReady": true,
    "gitBranchName": "master",
    "usage": {
      "ACTOR_COMPUTE_UNITS": 3,
      "DATASET_READS": 4,
      "DATASET_WRITES": 4,
      "KEY_VALUE_STORE_READS": 5,
      "KEY_VALUE_STORE_WRITES": 3,
      "KEY_VALUE_STORE_LISTS": 5,
      "REQUEST_QUEUE_READS": 2,
      "REQUEST_QUEUE_WRITES": 1,
      "DATA_TRANSFER_INTERNAL_GBYTES": 1,
      "DATA_TRANSFER_EXTERNAL_GBYTES": 3,
      "PROXY_RESIDENTIAL_TRANSFER_GBYTES": 34,
      "PROXY_SERPS": 3
    },
    "usageTotalUsd": 0.2654,
    "usageUsd": {
      "ACTOR_COMPUTE_UNITS": 0.0003,
      "DATASET_READS": 0.0001,
      "DATASET_WRITES": 0.0001,
      "KEY_VALUE_STORE_READS": 0.0001,
      "KEY_VALUE_STORE_WRITES": 0.00005,
      "KEY_VALUE_STORE_LISTS": 0.0001,
      "REQUEST_QUEUE_READS": 0.0001,
      "REQUEST_QUEUE_WRITES": 0.0001,
      "DATA_TRANSFER_INTERNAL_GBYTES": 0.001,
      "DATA_TRANSFER_EXTERNAL_GBYTES": 0.003,
      "PROXY_RESIDENTIAL_TRANSFER_GBYTES": 0.034,
      "PROXY_SERPS": 0.003
    },
    "metamorphs": [
      {
        "createdAt": "2019-11-30T07:39:24.202Z",
        "actorId": "nspoEjklmnsF2oosD",
        "buildId": "ME6oKecqy5kXDS4KQ",
        "inputKey": "INPUT-METAMORPH-1"
      }
    ],
    "platformUsageBillingModel": "USER"
  }
}

Changes

Changed in 3 of the 7 revisions of this API.121

Aug 28, 20260a98d6a098a46See the full diff
- ●
  added the new cannot-publish-actor-task enum value to the error/type response property for the response status 400
  response-property-enum-value-added
- ●
  added the new cannot-publish-actor-task enum value to the error/type response property for the response status 401
  response-property-enum-value-added
- ●
  added the new cannot-publish-actor-task enum value to the error/type response property for the response status 403
  response-property-enum-value-added
- ●
  added the new cannot-publish-actor-task enum value to the error/type response property for the response status 404
  response-property-enum-value-added
- ●
  added the new cannot-publish-actor-task enum value to the error/type response property for the response status 405
  response-property-enum-value-added
- ●
  added the new cannot-publish-actor-task enum value to the error/type response property for the response status 429
  response-property-enum-value-added
Jul 31, 20265ceb2cdfe6161See the full diff
- ○
  api operation id act_run_metamorph_post removed and replaced with actors_run_metamorph_post
  api-operation-id-removed
Jul 26, 2026b94a8abdfff16See the full diff
- ●
  added the new cannot-monetize-without-payout-billing-info enum value to the error/type response property for the response status 400
  response-property-enum-value-added
- ●
  added the new cannot-monetize-without-payout-billing-info enum value to the error/type response property for the response status 401
  response-property-enum-value-added
- ●
  added the new cannot-monetize-without-payout-billing-info enum value to the error/type response property for the response status 403
  response-property-enum-value-added
- ●
  added the new cannot-monetize-without-payout-billing-info enum value to the error/type response property for the response status 404
  response-property-enum-value-added
- ●
  added the new cannot-monetize-without-payout-billing-info enum value to the error/type response property for the response status 405
  response-property-enum-value-added
- ●
  added the new cannot-monetize-without-payout-billing-info enum value to the error/type response property for the response status 429
  response-property-enum-value-added

Full history