Metamorph Actor's last run

POST 
/v2/actors/:actorId/runs/last/metamorph

Transforms the last run of the specified Actor into a run of another Actor with a new input.

This endpoint is a shortcut for Metamorph Actor run on the Actor's last run.

Request

Path Parameters

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

Example: compass~google-maps-extractor

Query Parameters

status string
Filter for the run status.

Example: SUCCEEDED
origin RunOrigin

Possible values: [DEVELOPMENT, WEB, API, SCHEDULER, TEST, WEBHOOK, ACTOR, CLI, CI, STANDBY, MCP]

Filter for the run origin, i.e. the means by which the run was started.

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

Example: HDSasDasz78YcAPEB
build string
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).

Example: beta

Status 200

Response Headers

{
  "data": {
    "id": "HG7ML7M8z78YcAPEB",
    "actId": "HDSasDasz78YcAPEB",
    "userId": "7sT5jcggjjA9fNcxF",
    "actorTaskId": "KJHSKHausidyaJKHs",
    "startedAt": "2019-11-30T07:34:24.202Z",
    "finishedAt": "2019-12-12T09:30:12.202Z",
    "status": "READY",
    "statusMessage": "Actor is running",
    "isStatusMessageTerminal": false,
    "meta": {
      "origin": "DEVELOPMENT",
      "clientIp": "string",
      "userAgent": "string",
      "scheduleId": "string",
      "scheduledAt": "2024-07-29T15:51:28.071Z",
      "actorRunId": "HG7ML7M8z78YcAPEB",
      "webhookDispatchId": "asdLZtadYvn4mBZmm",
      "scheduledAct2Id": "c6KfSgoQzFhMk3etc",
      "scheduledActorTaskId": "c6KfSgoQzFhMk3etc"
    },
    "pricingInfo": {
      "apifyMarginPercentage": 0.2,
      "createdAt": "2024-07-29T15:51:28.071Z",
      "startedAt": "2024-07-29T15:51:28.071Z",
      "notifiedAboutFutureChangeAt": "2024-07-29T15:51:28.071Z",
      "notifiedAboutChangeAt": "2024-07-29T15:51:28.071Z",
      "notifiedAboutRentalToPpePriceChangeAt": "2024-07-29T15:51:28.071Z",
      "reasonForChange": "string",
      "isPriceChangeNotificationSuppressed": true,
      "forceContainsSignificantPriceChange": true,
      "pricingModel": "PAY_PER_EVENT",
      "pricingPerEvent": {
        "actorChargeEvents": {}
      },
      "minimalMaxTotalChargeUsd": 0,
      "isPPEPlatformUsagePaidByUser": false
    },
    "stats": {
      "inputBodyLen": 240,
      "migrationCount": 0,
      "rebootCount": 0,
      "restartCount": 0,
      "resurrectCount": 2,
      "memAvgBytes": 267874071.9,
      "memMaxBytes": 404713472,
      "memCurrentBytes": 0,
      "cpuAvgUsage": 33.7532101107538,
      "cpuMaxUsage": 169.650735534941,
      "cpuCurrentUsage": 0,
      "netRxBytes": 103508042,
      "netTxBytes": 4854600,
      "durationMillis": 248472,
      "runTimeSecs": 248.472,
      "metamorph": 0,
      "computeUnits": 0.13804
    },
    "chargedEventCounts": {
      "actor-start": 1,
      "page-crawled": 150,
      "data-extracted": 75
    },
    "accountedChargedEventCounts": {
      "actor-start": 1,
      "page-crawled": 150
    },
    "eventUsage": {},
    "externalChargedTotalUsd": 0.5,
    "standby": {
      "deployment": "MULTI_TENANT_PAYING_USERS"
    },
    "integrationTracking": {
      "platform": "zapier",
      "appId": "string",
      "isAiTool": false
    },
    "createdByOrganizationMemberUserId": "7sT5jcggjjA9fNcxF",
    "consoleUrl": "https://console.apify.com/view/runs/HG7ML7M8z78YcAPEB",
    "output": {
      "results": "https://api.apify.com/v2/datasets/wmKPijuyDnPZAPRMk/items"
    },
    "options": {
      "build": "latest",
      "timeoutSecs": 300,
      "memoryMbytes": 1024,
      "diskMbytes": 2048,
      "restartOnError": false,
      "maxItems": 1000,
      "maxTotalChargeUsd": 5,
      "isMaxTotalChargeUsdSetByUser": true
    },
    "buildId": "7sT5jcggjjA9fNcxF",
    "exitCode": 0,
    "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,
      "PROXY_UNBLOCKER_UNITS": 0
    },
    "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,
      "PROXY_UNBLOCKER_UNITS": 0
    },
    "metamorphs": [
      {
        "createdAt": "2019-11-30T07:39:24.202Z",
        "actorId": "nspoEjklmnsF2oosD",
        "buildId": "ME6oKecqy5kXDS4KQ",
        "inputKey": "INPUT-METAMORPH-1",
        "buildTags": [
          "latest"
        ]
      }
    ],
    "platformUsageBillingModel": "USER"
  }
}

Schema

• data object required

  Represents an Actor run and its associated data.

  • id string required

    Unique identifier of the Actor run.

    
    Example: HG7ML7M8z78YcAPEB
  • actId string required

    ID of the Actor that was run.

    
    Example: HDSasDasz78YcAPEB
  • userId string required

    ID of the user who started the run.

    
    Example: 7sT5jcggjjA9fNcxF
  • actorTaskId string | null nullable

    ID of the Actor task, if the run was started from a task.

    
    Example: KJHSKHausidyaJKHs
  • startedAt string<date-time> required

    Time when the Actor run started.

    
    Example: 2019-11-30T07:34:24.202Z
  • finishedAt string,null<date-time> nullable

    Time when the Actor run finished.

    
    Example: 2019-12-12T09:30:12.202Z
  • status ActorJobStatus (string) required

    Status of an Actor job (run or build).

    Possible values: [READY, RUNNING, SUCCEEDED, FAILED, TIMING-OUT, TIMED-OUT, ABORTING, ABORTED]

  • statusMessage string | null nullable

    Detailed message about the run status.

    
    Example: Actor is running
  • isStatusMessageTerminal boolean | null nullable

    Whether the status message is terminal (final).

    
    Example: false
  • meta object required

    Metadata about the Actor run.

    • origin RunOrigin (string) required

      Possible values: [DEVELOPMENT, WEB, API, SCHEDULER, TEST, WEBHOOK, ACTOR, CLI, CI, STANDBY, MCP]

    • clientIp string | null nullable

      IP address of the client that started the run.

    • userAgent string | null nullable

      User agent of the client that started the run.

    • scheduleId string | null nullable

      ID of the schedule that triggered the run.

    • scheduledAt string,null<date-time> nullable

      Time when the run was scheduled.

    • actorRunId string

      ID of the Actor run that started this run. Present only when the run was started from another run.

      
      Example: HG7ML7M8z78YcAPEB
    • webhookDispatchId string

      ID of the webhook dispatch that started the run. Present only when the run was started by a webhook.

      
      Example: asdLZtadYvn4mBZmm
    • scheduledAct2Id string

      ID of the schedule action that started the Actor. Present only on runs of Actors started by a schedule.

      
      Example: c6KfSgoQzFhMk3etc
    • scheduledActorTaskId string

      ID of the schedule action that started the Actor task. Present only on runs of tasks started by a schedule.

      
      Example: c6KfSgoQzFhMk3etc
  • pricingInfo object

    Pricing information for the Actor.

    pricingModel
    Pricing information for the Actor.
    Possible values: [PAY_PER_EVENT, PRICE_PER_DATASET_ITEM, FLAT_PRICE_PER_MONTH, FREE]
    • PAY_PER_EVENT
      • apifyMarginPercentage number required

        Apify's share of the revenue generated under this pricing info record, as a fraction between 0 and 1. Set by the Apify platform.

        
        Example: 0.2
      • createdAt string<date-time> required

        When this pricing info record has been created

      • startedAt string<date-time> required

        Since when is this pricing info record effective for a given Actor

      • notifiedAboutFutureChangeAt string,null<date-time> nullable
      • notifiedAboutChangeAt string,null<date-time> nullable
      • notifiedAboutRentalToPpePriceChangeAt string,null<date-time> nullable
      • reasonForChange string | null nullable
      • isPriceChangeNotificationSuppressed boolean
      • forceContainsSignificantPriceChange boolean
      • pricingPerEvent object required

        • actorChargeEvents object

          • property name* ActorChargeEvent

            Definition of a single chargeable event for a pay-per-event Actor. Each event is either flat-priced (eventPriceUsd is set) or tier-priced (eventTieredPricingUsd is set); the two are mutually exclusive.

            • eventTitle string required

              Human-readable title shown to users in the billing UI.

            • eventDescription string required

              Human-readable description of what triggers this event.

            • eventPriceUsd number

              Flat price per event in USD. Present only for non-tiered events. Mutually exclusive with eventTieredPricingUsd.

            • eventTieredPricingUsd object

              Tiered price-per-event pricing for a single charge event, keyed by subscription tier (e.g. FREE, BRONZE, SILVER, GOLD, PLATINUM, DIAMOND). The actual price applied is resolved from the user's tier.

              • property name* TieredPricingPerEventEntry

                A single tier's price-per-event entry.

                • tieredEventPriceUsd number required

                  Price per event in USD for this tier.

            • isPrimaryEvent boolean

              Whether this event is the Actor's primary chargeable event.

            • isOneTimeEvent boolean | null nullable

              Whether this event can only be charged once per Actor run.

      • minimalMaxTotalChargeUsd number | null nullable
      • isPPEPlatformUsagePaidByUser boolean | null nullable

        If true, the platform usage of the run is charged to the user running the Actor, in addition to the event prices.

        
        Example: false
    • PRICE_PER_DATASET_ITEM
      • apifyMarginPercentage number required

        Apify's share of the revenue generated under this pricing info record, as a fraction between 0 and 1. Set by the Apify platform.

        
        Example: 0.2
      • createdAt string<date-time> required

        When this pricing info record has been created

      • startedAt string<date-time> required

        Since when is this pricing info record effective for a given Actor

      • notifiedAboutFutureChangeAt string,null<date-time> nullable
      • notifiedAboutChangeAt string,null<date-time> nullable
      • notifiedAboutRentalToPpePriceChangeAt string,null<date-time> nullable
      • reasonForChange string | null nullable
      • isPriceChangeNotificationSuppressed boolean
      • forceContainsSignificantPriceChange boolean
      • unitName string required

        Name of the unit that is being charged

      • pricePerUnitUsd number

        Price per unit in USD. Mutually exclusive with tieredPricing - exactly one of the two is present on a pricing record.

      • tieredPricing object

        Tiered price-per-dataset-item pricing, keyed by subscription tier (e.g. FREE, BRONZE, SILVER, GOLD, PLATINUM, DIAMOND). The actual price applied to a run is resolved from the user's tier.

        • property name* TieredPricingPerDatasetItemEntry

          A single tier's price-per-dataset-item entry.

          • tieredPricePerUnitUsd number required

            Price per unit in USD for this tier.

    • FLAT_PRICE_PER_MONTH
      • apifyMarginPercentage number required

        Apify's share of the revenue generated under this pricing info record, as a fraction between 0 and 1. Set by the Apify platform.

        
        Example: 0.2
      • createdAt string<date-time> required

        When this pricing info record has been created

      • startedAt string<date-time> required

        Since when is this pricing info record effective for a given Actor

      • notifiedAboutFutureChangeAt string,null<date-time> nullable
      • notifiedAboutChangeAt string,null<date-time> nullable
      • notifiedAboutRentalToPpePriceChangeAt string,null<date-time> nullable
      • reasonForChange string | null nullable
      • isPriceChangeNotificationSuppressed boolean
      • forceContainsSignificantPriceChange boolean
      • trialMinutes integer required

        Number of minutes a user could run the Actor for free before having to rent it. Apify no longer offers rental pricing, so you can see this field only in pricing history and in runs started before rented Actors moved to other pricing models.

      • pricePerUnitUsd number required

        Monthly flat price in USD. Apify no longer offers rental pricing, so you can see this field only in pricing history and in runs started before rented Actors moved to other pricing models.

    • FREE
      • apifyMarginPercentage number required

        Apify's share of the revenue generated under this pricing info record, as a fraction between 0 and 1. Set by the Apify platform.

        
        Example: 0.2
      • createdAt string<date-time> required

        When this pricing info record has been created

      • startedAt string<date-time> required

        Since when is this pricing info record effective for a given Actor

      • notifiedAboutFutureChangeAt string,null<date-time> nullable
      • notifiedAboutChangeAt string,null<date-time> nullable
      • notifiedAboutRentalToPpePriceChangeAt string,null<date-time> nullable
      • reasonForChange string | null nullable
      • isPriceChangeNotificationSuppressed boolean
      • forceContainsSignificantPriceChange boolean
  • stats object required

    Statistics of the Actor run.

    • inputBodyLen integer | null nullable

      Possible values: >= 0

      
      Example: 240
    • migrationCount integer

      Possible values: >= 0

      
      Example: 0
    • rebootCount integer

      Possible values: >= 0

      
      Example: 0
    • restartCount integer

      Possible values: >= 0

      
      Example: 0
    • resurrectCount integer

      Possible values: >= 0

      
      Example: 2
    • memAvgBytes number
      Example: 267874071.9
    • memMaxBytes integer

      Possible values: >= 0

      
      Example: 404713472
    • memCurrentBytes integer

      Possible values: >= 0

      
      Example: 0
    • cpuAvgUsage number
      Example: 33.7532101107538
    • cpuMaxUsage number
      Example: 169.650735534941
    • cpuCurrentUsage number
      Example: 0
    • netRxBytes integer

      Possible values: >= 0

      
      Example: 103508042
    • netTxBytes integer

      Possible values: >= 0

      
      Example: 4854600
    • durationMillis integer

      Possible values: >= 0

      
      Example: 248472
    • runTimeSecs number

      Possible values: >= 0

      
      Example: 248.472
    • metamorph integer

      Possible values: >= 0

      
      Example: 0
    • computeUnits number

      Possible values: >= 0

      
      Example: 0.13804
  • chargedEventCounts object

    A map of charged event types to their counts. The keys are event type identifiers defined by the Actor's pricing model (pay-per-event), and the values are the number of times each event was charged during this run.

    • property name* integer
  • accountedChargedEventCounts object,null

    A map of charged event types to the number of their charges that have already been accounted for billing. Present only for pay-per-event Actors.

    • property name* integer
  • eventUsage object

    Cost breakdown of the pay-per-event charges in USD, keyed by event type. Present only for pay-per-event runs, and not when the run was started by the Actor's owner.

    • property name* RunEventUsage

      Cost of a single pay-per-event event type charged during the run.

      • eventTotalUsd number required

        Total cost of all charges of this event in USD.

        
        Example: 0.15
      • eventTitle string required

        Human-readable title of the event.

        
        Example: Page crawled
  • externalChargedTotalUsd number

    Total price in USD of the pay-per-event charges made to other users. Present only on multi-tenant Standby runs.

    
    Example: 0.5
  • standby object

    Server Actor deployment of this run, null for runs not started by a Server Actor request.

    anyOf
    • RunStandby
    • null
    deployment string required
    Which pool the Server Actor run serves. SINGLE_TENANT is a private instance in the caller's account. The MULTI_TENANT_* pools run in the Actor owner's account and serve many callers; charges in them require a requestId (see the charge endpoint).
    Possible values: [SINGLE_TENANT, MULTI_TENANT_OWNER_PAID, MULTI_TENANT_FREE_USERS, MULTI_TENANT_PAYING_USERS]
    
    Example: MULTI_TENANT_PAYING_USERS
  • integrationTracking object

    Present only when the run was started by a third-party integration.

    • platform string

      Name of the integration platform.

      
      Example: zapier
    • appId string

      ID of the integration app.

    • isAiTool boolean

      Whether the resource was created by an AI tool.

      
      Example: false
  • createdByOrganizationMemberUserId string

    ID of the organization member who started the run. Present only for runs started on behalf of an organization.

    
    Example: 7sT5jcggjjA9fNcxF
  • consoleUrl string<uri>

    URL of the run in Apify Console. Returned only by the Get Actor run endpoint.

    
    Example: https://console.apify.com/view/runs/HG7ML7M8z78YcAPEB
  • output object

    Output links of the run, generated from the output schema of the Actor build. Present only if the build defines an output schema.

    • property name* string<uri>
  • options object required

    Configuration options for the Actor run.

    • build string required
      Example: latest
    • timeoutSecs integer required

      Possible values: >= 0

      
      Example: 300
    • memoryMbytes integer required

      Possible values: >= 128 and <= 32768

      
      Example: 1024
    • diskMbytes integer required

      Possible values: >= 0

      
      Example: 2048
    • restartOnError boolean | null nullable

      Whether to automatically restart the run if it fails.

      
      Example: false
    • maxItems integer | null nullable

      Possible values: >= 0

      
      Example: 1000
    • maxTotalChargeUsd number | null nullable

      Possible values: >= 0

      
      Example: 5
    • isMaxTotalChargeUsdSetByUser boolean

      Whether the user explicitly set maxTotalChargeUsd when starting the run. Not present for pay-per-result Actors.

      
      Example: true
  • buildId string required

    ID of the Actor build used for this run.

    
    Example: 7sT5jcggjjA9fNcxF
  • exitCode integer | null nullable

    Exit code of the Actor run process.

    
    Example: 0
  • generalAccess object

    General access level for the Actor run.

    anyOf
    • GeneralAccess
    • null
    GeneralAccess (string)
    Defines the general access level for the resource.
    Possible values: [ANYONE_WITH_ID_CAN_READ, ANYONE_WITH_NAME_CAN_READ, FOLLOW_USER_SETTING, RESTRICTED]
    
    Example: RESTRICTED
  • defaultKeyValueStoreId string required

    ID of the default key-value store for this run.

    
    Example: eJNzqsbPiopwJcgGQ
  • defaultDatasetId string required

    ID of the default dataset for this run.

    
    Example: wmKPijuyDnPZAPRMk
  • defaultRequestQueueId string required

    ID of the default request queue for this run.

    
    Example: FL35cSF7jrxr3BY39
  • storageIds object

    A map of aliased storage IDs associated with this run, grouped by storage type.

    • datasets object

      Aliased dataset IDs for this run.

      • default string

        ID of the default dataset for this run.

        
        Example: wmKPijuyDnPZAPRMk
      • property name* string
    • keyValueStores object

      Aliased key-value store IDs for this run.

      • default string

        ID of the default key-value store for this run.

        
        Example: eJNzqsbPiopwJcgGQ
      • property name* string
    • requestQueues object

      Aliased request queue IDs for this run.

      • default string

        ID of the default request queue for this run.

        
        Example: FL35cSF7jrxr3BY39
      • property name* string
  • buildNumber string | null nullable

    Build number of the Actor build used for this run.

    Possible values: Value must match regular expression ^([0-9]|[1-9][0-9])\.([0-9]|[1-9][0-9])(\.[1-9][0-9]{0,4})$

    
    Example: 0.0.36
  • containerUrl string<uri>

    URL of the container running the Actor.

    
    Example: https://g8kd8kbc5ge8.runs.apify.net
  • isContainerServerReady boolean | null nullable

    Whether the container's HTTP server is ready to accept requests.

    
    Example: true
  • gitBranchName string | null nullable

    Name of the git branch used for the Actor build.

    
    Example: master
  • usage object

    Resource usage statistics for the run.

    anyOf
    • RunUsage
    • null
    ACTOR_COMPUTE_UNITS number | null nullable
    Example: 3
    DATASET_READS integer | null nullable
    Example: 4
    DATASET_WRITES integer | null nullable
    Example: 4
    KEY_VALUE_STORE_READS integer | null nullable
    Example: 5
    KEY_VALUE_STORE_WRITES integer | null nullable
    Example: 3
    KEY_VALUE_STORE_LISTS integer | null nullable
    Example: 5
    REQUEST_QUEUE_READS integer | null nullable
    Example: 2
    REQUEST_QUEUE_WRITES integer | null nullable
    Example: 1
    DATA_TRANSFER_INTERNAL_GBYTES number | null nullable
    Example: 1
    DATA_TRANSFER_EXTERNAL_GBYTES number | null nullable
    Example: 3
    PROXY_RESIDENTIAL_TRANSFER_GBYTES number | null nullable
    Example: 34
    PROXY_SERPS integer | null nullable
    Example: 3
    PROXY_UNBLOCKER_UNITS number | null nullable
    Example: 0
  • usageTotalUsd number | null nullable

    Total cost in USD for this run. Represents what you actually pay. For run owners: includes platform usage (compute units) and/or event costs depending on the Actor's pricing model. For run non-owners: only available for pay-per-event Actors (event costs only). Requires authentication token to access.

    
    Example: 0.2654
  • usageUsd object

    Platform usage costs breakdown in USD. Only present if you own the run and are paying for platform usage (pay-per-usage or pay-per-event with usage costs like Standby Actors). Not available for standard pay-per-event Actors. Requires authentication token to access.

    anyOf
    • RunUsageUsd
    • null
    ACTOR_COMPUTE_UNITS number | null nullable
    Example: 0.0003
    DATASET_READS number | null nullable
    Example: 0.0001
    DATASET_WRITES number | null nullable
    Example: 0.0001
    KEY_VALUE_STORE_READS number | null nullable
    Example: 0.0001
    KEY_VALUE_STORE_WRITES number | null nullable
    Example: 0.00005
    KEY_VALUE_STORE_LISTS number | null nullable
    Example: 0.0001
    REQUEST_QUEUE_READS number | null nullable
    Example: 0.0001
    REQUEST_QUEUE_WRITES number | null nullable
    Example: 0.0001
    DATA_TRANSFER_INTERNAL_GBYTES number | null nullable
    Example: 0.001
    DATA_TRANSFER_EXTERNAL_GBYTES number | null nullable
    Example: 0.003
    PROXY_RESIDENTIAL_TRANSFER_GBYTES number | null nullable
    Example: 0.034
    PROXY_SERPS number | null nullable
    Example: 0.003
    PROXY_UNBLOCKER_UNITS number | null nullable
    Example: 0
  • metamorphs object

    List of metamorph events that occurred during the run.

    anyOf
    • object[]
    • null
    createdAt string<date-time> required
    Time when the metamorph occurred.
    
    Example: 2019-11-30T07:39:24.202Z
    actorId string required
    ID of the Actor that the run was metamorphed to.
    
    Example: nspoEjklmnsF2oosD
    buildId string required
    ID of the build used for the metamorphed Actor.
    
    Example: ME6oKecqy5kXDS4KQ
    inputKey string | null nullable
    Key of the input record in the key-value store.
    
    Example: INPUT-METAMORPH-1
    buildTags string[]
    Build tags of the build used for the metamorphed Actor.
    
    Example: ["latest"]
  • platformUsageBillingModel string

    Indicates which party covers platform usage costs for this run.

    
    Example: USER

Status 400

Bad request - invalid input parameters or request body.

{
  "error": {
    "type": "invalid-input",
    "message": "Invalid input: The request body contains invalid data."
  }
}

Schema

• error object required

  • type ErrorType (string)

    Machine-processable error type identifier.

    Possible values: [3d-secure-auth-failed, access-right-already-exists, action-not-found, actor-already-rented, actor-can-not-be-rented, actor-disabled, actor-is-not-rented, actor-memory-limit-exceeded, actor-name-exists-new-owner, actor-name-not-unique, actor-not-found, actor-not-github-actor, actor-not-public, actor-permission-level-not-supported-for-agentic-payments, actor-review-already-exists, actor-run-failed, actor-standby-not-supported-for-agentic-payments, actor-task-name-not-unique, agentic-payment-info-retrieval-error, agentic-payment-information-missing, agentic-payment-insufficient-amount, agentic-payment-provider-internal-error, agentic-payment-provider-unauthorized, airtable-webhook-deprecated, already-subscribed-to-paid-actor, apify-plan-required-to-use-paid-actor, apify-signup-not-allowed, auth-method-not-supported, authorization-server-not-found, auto-issue-date-invalid, background-check-required, billing-system-error, black-friday-plan-expired, braintree-error, braintree-not-linked, braintree-operation-timed-out, braintree-unsupported-currency, build-not-found, build-outdated, cannot-add-apify-events-to-ppe-actor, cannot-add-multiple-pricing-infos, cannot-add-pricing-info-that-alters-past, cannot-add-second-future-pricing-info, cannot-build-actor-from-webhook, cannot-change-billing-interval, cannot-change-owner, cannot-charge-apify-event, cannot-charge-non-pay-per-event-actor, cannot-comment-as-other-user, cannot-copy-actor-task, cannot-create-payout, cannot-create-public-actor, cannot-create-tax-transaction, cannot-delete-critical-actor, cannot-delete-invoice, cannot-delete-paid-actor, cannot-disable-one-time-event-for-apify-start-event, cannot-disable-organization-with-enabled-members, cannot-disable-user-with-subscription, cannot-link-oauth-to-unverified-email, cannot-metamorph-to-pay-per-result-actor, cannot-modify-actor-pricing-too-frequently, cannot-modify-actor-pricing-with-immediate-effect, cannot-monetize-without-payout-billing-info, cannot-override-paid-actor-trial, cannot-permanently-delete-subscription, cannot-publish-actor, cannot-publish-actor-task, cannot-reduce-last-full-token, cannot-reimburse-more-than-original-charge, cannot-reimburse-non-rental-charge, cannot-remove-own-actor-from-recently-used, cannot-remove-payment-method, cannot-remove-pricing-info, cannot-remove-running-run, cannot-remove-user-with-public-actors, cannot-remove-user-with-subscription, cannot-remove-user-with-unpaid-invoice, cannot-rename-env-var, cannot-rent-paid-actor, cannot-review-own-actor, cannot-set-access-rights-for-owner, cannot-set-is-status-message-terminal, cannot-unpublish-critical-actor, cannot-unpublish-paid-actor, cannot-unpublish-profile, cannot-update-invoice-field, concurrent-runs-limit-exceeded, concurrent-update-detected, conference-token-not-found, content-encoding-forbidden-for-html, coupon-already-redeemed, coupon-expired, coupon-for-new-customers, coupon-for-subscribed-users, coupon-limits-are-in-conflict-with-current-limits, coupon-max-number-of-redemptions-reached, coupon-not-found, coupon-not-unique, coupons-disabled, create-github-issue-not-allowed, creator-plan-not-available, cron-expression-invalid, daily-ai-token-limit-exceeded, daily-publication-limit-exceeded, dataset-does-not-have-fields-schema, dataset-does-not-have-schema, dataset-locked, dataset-schema-invalid, dcr-not-supported, default-dataset-not-found, deleting-default-build, deleting-unfinished-build, email-already-taken, email-already-taken-removed-user, email-domain-not-allowed-for-coupon, email-invalid, email-not-allowed, email-not-valid, email-update-too-soon, elevated-permissions-needed, env-var-already-exists, exchange-rate-fetch-failed, expired-conference-token, failed-to-charge-user, final-invoice-negative, full-permission-actor-blocked-for-admin, full-permission-actor-not-approved, full-permissions-require-verified-owner, github-branch-empty, github-issue-already-exists, github-public-key-not-found, github-repository-not-found, github-signature-does-not-match-payload, github-user-not-authorized-for-issues, gmail-not-allowed, id-does-not-match, incompatible-billing-interval, incomplete-payout-billing-info, inconsistent-currencies, incorrect-pricing-modifier-prefix, input-json-invalid-characters, input-json-not-object, input-json-too-long, input-update-collision, input-validation-timed-out, insufficient-permissions, insufficient-permissions-to-change-field, insufficient-security-measures, insufficient-tax-country-evidence, integration-auth-error, internal-server-error, invalid-billing-info, invalid-billing-period-for-payout, invalid-build, invalid-client-key, invalid-collection, invalid-conference-login-password, invalid-content-type-header, invalid-credentials, invalid-git-auth-token, invalid-github-issue-url, invalid-header, invalid-id, invalid-idempotency-key, invalid-input, invalid-input-schema, invalid-invoice, invalid-invoice-type, invalid-issue-date, invalid-label-params, invalid-main-account-user-id, invalid-oauth-app, invalid-oauth-scope, invalid-one-time-invoice, invalid-parameter, invalid-payout-status, invalid-picture-url, invalid-record-key, invalid-request, invalid-resource-type, invalid-signature, invalid-subscription-plan, invalid-tax-number, invalid-tax-number-format, invalid-token, invalid-token-type, invalid-two-factor-code, invalid-two-factor-code-or-recovery-code, invalid-two-factor-recovery-code, invalid-username, invalid-value, invitation-invalid-resource-type, invitation-no-longer-valid, invoice-canceled, invoice-cannot-be-refunded-due-to-too-high-amount, invoice-incomplete, invoice-is-draft, invoice-locked, invoice-must-be-buffer, invoice-not-canceled, invoice-not-draft, invoice-not-found, invoice-outdated, invoice-paid-already, issue-already-connected-to-github, issue-not-found, issues-bad-request, issuer-not-registered, job-finished, label-already-linked, last-api-token, limit-reached, max-items-must-be-greater-than-zero, max-metamorphs-exceeded, max-total-charge-usd-below-minimum, max-total-charge-usd-must-be-greater-than-zero, mcp-connector-actor-not-allowed, method-not-allowed, migration-disabled, missing-actor-rights, missing-api-token, missing-billing-info, missing-line-items, missing-payment-date, missing-payout-billing-info, missing-proxy-password, missing-reporting-fields, missing-resource-name, missing-settings, missing-username, monthly-usage-limit-too-low, more-public-actors-require-verified-owner, more-than-one-update-not-allowed, multiple-records-found, must-be-admin, name-not-unique, next-runtime-computation-failed, no-columns-in-exported-dataset, no-payment-attempt-for-refund-found, no-payment-method-available, no-team-account-seats-available, non-temporary-email, not-enough-usage-to-run-paid-actor, not-implemented, not-supported-currencies, o-auth-service-already-connected, o-auth-service-not-connected, oauth-resource-access-failed, one-time-invoice-already-marked-paid, only-drafts-can-be-deleted, operation-canceled, operation-not-allowed, operation-timed-out, organization-cannot-own-itself, organization-role-not-found, overlapping-payout-billing-periods, own-token-required, page-not-found, param-not-one-of, parameter-required, parameters-mismatched, password-reset-email-already-sent, password-reset-token-expired, pay-as-you-go-without-monthly-interval, payment-attempt-status-message-required, payout-already-paid, payout-canceled, payout-invalid-state, payout-must-be-approved-to-be-marked-paid, payout-not-found, payout-number-already-exists, phone-number-invalid, phone-number-landline, phone-number-opted-out, phone-verification-disabled, platform-feature-disabled, price-overrides-validation-failed, pricing-model-not-supported, promotional-plan-not-available, proxy-auth-ip-not-unique, public-actor-disabled, query-timeout, quoted-price-outdated, rate-limit-exceeded, readme-required, recaptcha-invalid, recaptcha-required, record-not-found, record-not-public, record-or-token-not-found, record-too-large, redirect-uri-mismatch, reduced-plan-not-available, rental-charge-already-reimbursed, rental-not-allowed, request-aborted-prematurely, request-handled-or-locked, request-id-invalid, request-queue-duplicate-requests, request-too-large, requested-dataset-view-does-not-exist, resume-token-expired, run-failed, run-input-body-not-valid-json, run-timeout-exceeded, russia-is-evil, same-user, schedule-actor-not-found, schedule-actor-task-not-found, schedule-name-not-unique, schema-validation, schema-validation-error, schema-validation-failed, schemas-required, service-worker-registration-not-allowed, sign-up-method-not-allowed, slack-integration-not-custom, socket-closed, socket-destroyed, standby-deployment-invalid, store-schema-invalid, store-terms-not-accepted, stripe-enabled, stripe-generic-decline, stripe-not-enabled, stripe-not-enabled-for-user, tagged-build-required, tax-country-invalid, tax-number-invalid, tax-number-validation-failed, taxamo-call-failed, taxamo-request-failed, testing-error, token-not-provided, too-few-versions, too-many-actor-tasks, too-many-actors, too-many-labels-on-resource, too-many-mcp-connectors, too-many-o-auth-apps, too-many-organizations, too-many-public-actor-tasks-per-account, too-many-public-actor-tasks-per-actor, too-many-requests, too-many-schedules, too-many-ui-access-keys, too-many-user-labels, too-many-values, too-many-versions, too-many-webhooks, unexpected-route, unknown-build-tag, unknown-payment-provider, unsubscribe-token-invalid, unsupported-actor-pricing-model-for-agentic-payments, unsupported-content-encoding, unsupported-file-type-for-issue, unsupported-file-type-image-expected, unsupported-file-type-text-or-json-expected, unsupported-permission, upcoming-subscription-bill-not-up-to-date, user-already-exists, user-already-verified, user-creates-organizations-too-fast, user-disabled, user-email-is-disposable, user-email-not-set, user-email-not-verified, user-has-no-subscription, user-integration-not-found, user-is-already-invited, user-is-already-organization-member, user-is-not-member-of-organization, user-is-not-organization, user-is-organization, user-is-organization-owner, user-is-removed, user-not-found, user-not-logged-in, user-not-verified, user-or-token-not-found, user-plan-not-allowed-for-coupon, user-problem-with-card, user-record-not-found, username-already-taken, username-missing, username-not-allowed, username-removal-forbidden, username-required, verification-email-already-sent, verification-token-expired, version-already-exists, versions-size-exceeded, weak-password, x402-agentic-payment-already-finalized, x402-agentic-payment-insufficient-amount, x402-agentic-payment-malformed-token, x402-agentic-payment-settlement-failed, x402-agentic-payment-settlement-in-progress, x402-agentic-payment-settlement-stuck, x402-agentic-payment-unauthorized, x402-payment-required, zero-invoice]

  • message string

    Human-readable error message describing what went wrong.

  • data object

    Additional machine-readable details about the error. Present only for some error types.

Status 401

Unauthorized - authentication required or invalid token.

{
  "error": {
    "type": "invalid-token",
    "message": "Authentication token is not valid."
  }
}

Schema

• error object required

  • type ErrorType (string)

    Machine-processable error type identifier.

    Possible values: [3d-secure-auth-failed, access-right-already-exists, action-not-found, actor-already-rented, actor-can-not-be-rented, actor-disabled, actor-is-not-rented, actor-memory-limit-exceeded, actor-name-exists-new-owner, actor-name-not-unique, actor-not-found, actor-not-github-actor, actor-not-public, actor-permission-level-not-supported-for-agentic-payments, actor-review-already-exists, actor-run-failed, actor-standby-not-supported-for-agentic-payments, actor-task-name-not-unique, agentic-payment-info-retrieval-error, agentic-payment-information-missing, agentic-payment-insufficient-amount, agentic-payment-provider-internal-error, agentic-payment-provider-unauthorized, airtable-webhook-deprecated, already-subscribed-to-paid-actor, apify-plan-required-to-use-paid-actor, apify-signup-not-allowed, auth-method-not-supported, authorization-server-not-found, auto-issue-date-invalid, background-check-required, billing-system-error, black-friday-plan-expired, braintree-error, braintree-not-linked, braintree-operation-timed-out, braintree-unsupported-currency, build-not-found, build-outdated, cannot-add-apify-events-to-ppe-actor, cannot-add-multiple-pricing-infos, cannot-add-pricing-info-that-alters-past, cannot-add-second-future-pricing-info, cannot-build-actor-from-webhook, cannot-change-billing-interval, cannot-change-owner, cannot-charge-apify-event, cannot-charge-non-pay-per-event-actor, cannot-comment-as-other-user, cannot-copy-actor-task, cannot-create-payout, cannot-create-public-actor, cannot-create-tax-transaction, cannot-delete-critical-actor, cannot-delete-invoice, cannot-delete-paid-actor, cannot-disable-one-time-event-for-apify-start-event, cannot-disable-organization-with-enabled-members, cannot-disable-user-with-subscription, cannot-link-oauth-to-unverified-email, cannot-metamorph-to-pay-per-result-actor, cannot-modify-actor-pricing-too-frequently, cannot-modify-actor-pricing-with-immediate-effect, cannot-monetize-without-payout-billing-info, cannot-override-paid-actor-trial, cannot-permanently-delete-subscription, cannot-publish-actor, cannot-publish-actor-task, cannot-reduce-last-full-token, cannot-reimburse-more-than-original-charge, cannot-reimburse-non-rental-charge, cannot-remove-own-actor-from-recently-used, cannot-remove-payment-method, cannot-remove-pricing-info, cannot-remove-running-run, cannot-remove-user-with-public-actors, cannot-remove-user-with-subscription, cannot-remove-user-with-unpaid-invoice, cannot-rename-env-var, cannot-rent-paid-actor, cannot-review-own-actor, cannot-set-access-rights-for-owner, cannot-set-is-status-message-terminal, cannot-unpublish-critical-actor, cannot-unpublish-paid-actor, cannot-unpublish-profile, cannot-update-invoice-field, concurrent-runs-limit-exceeded, concurrent-update-detected, conference-token-not-found, content-encoding-forbidden-for-html, coupon-already-redeemed, coupon-expired, coupon-for-new-customers, coupon-for-subscribed-users, coupon-limits-are-in-conflict-with-current-limits, coupon-max-number-of-redemptions-reached, coupon-not-found, coupon-not-unique, coupons-disabled, create-github-issue-not-allowed, creator-plan-not-available, cron-expression-invalid, daily-ai-token-limit-exceeded, daily-publication-limit-exceeded, dataset-does-not-have-fields-schema, dataset-does-not-have-schema, dataset-locked, dataset-schema-invalid, dcr-not-supported, default-dataset-not-found, deleting-default-build, deleting-unfinished-build, email-already-taken, email-already-taken-removed-user, email-domain-not-allowed-for-coupon, email-invalid, email-not-allowed, email-not-valid, email-update-too-soon, elevated-permissions-needed, env-var-already-exists, exchange-rate-fetch-failed, expired-conference-token, failed-to-charge-user, final-invoice-negative, full-permission-actor-blocked-for-admin, full-permission-actor-not-approved, full-permissions-require-verified-owner, github-branch-empty, github-issue-already-exists, github-public-key-not-found, github-repository-not-found, github-signature-does-not-match-payload, github-user-not-authorized-for-issues, gmail-not-allowed, id-does-not-match, incompatible-billing-interval, incomplete-payout-billing-info, inconsistent-currencies, incorrect-pricing-modifier-prefix, input-json-invalid-characters, input-json-not-object, input-json-too-long, input-update-collision, input-validation-timed-out, insufficient-permissions, insufficient-permissions-to-change-field, insufficient-security-measures, insufficient-tax-country-evidence, integration-auth-error, internal-server-error, invalid-billing-info, invalid-billing-period-for-payout, invalid-build, invalid-client-key, invalid-collection, invalid-conference-login-password, invalid-content-type-header, invalid-credentials, invalid-git-auth-token, invalid-github-issue-url, invalid-header, invalid-id, invalid-idempotency-key, invalid-input, invalid-input-schema, invalid-invoice, invalid-invoice-type, invalid-issue-date, invalid-label-params, invalid-main-account-user-id, invalid-oauth-app, invalid-oauth-scope, invalid-one-time-invoice, invalid-parameter, invalid-payout-status, invalid-picture-url, invalid-record-key, invalid-request, invalid-resource-type, invalid-signature, invalid-subscription-plan, invalid-tax-number, invalid-tax-number-format, invalid-token, invalid-token-type, invalid-two-factor-code, invalid-two-factor-code-or-recovery-code, invalid-two-factor-recovery-code, invalid-username, invalid-value, invitation-invalid-resource-type, invitation-no-longer-valid, invoice-canceled, invoice-cannot-be-refunded-due-to-too-high-amount, invoice-incomplete, invoice-is-draft, invoice-locked, invoice-must-be-buffer, invoice-not-canceled, invoice-not-draft, invoice-not-found, invoice-outdated, invoice-paid-already, issue-already-connected-to-github, issue-not-found, issues-bad-request, issuer-not-registered, job-finished, label-already-linked, last-api-token, limit-reached, max-items-must-be-greater-than-zero, max-metamorphs-exceeded, max-total-charge-usd-below-minimum, max-total-charge-usd-must-be-greater-than-zero, mcp-connector-actor-not-allowed, method-not-allowed, migration-disabled, missing-actor-rights, missing-api-token, missing-billing-info, missing-line-items, missing-payment-date, missing-payout-billing-info, missing-proxy-password, missing-reporting-fields, missing-resource-name, missing-settings, missing-username, monthly-usage-limit-too-low, more-public-actors-require-verified-owner, more-than-one-update-not-allowed, multiple-records-found, must-be-admin, name-not-unique, next-runtime-computation-failed, no-columns-in-exported-dataset, no-payment-attempt-for-refund-found, no-payment-method-available, no-team-account-seats-available, non-temporary-email, not-enough-usage-to-run-paid-actor, not-implemented, not-supported-currencies, o-auth-service-already-connected, o-auth-service-not-connected, oauth-resource-access-failed, one-time-invoice-already-marked-paid, only-drafts-can-be-deleted, operation-canceled, operation-not-allowed, operation-timed-out, organization-cannot-own-itself, organization-role-not-found, overlapping-payout-billing-periods, own-token-required, page-not-found, param-not-one-of, parameter-required, parameters-mismatched, password-reset-email-already-sent, password-reset-token-expired, pay-as-you-go-without-monthly-interval, payment-attempt-status-message-required, payout-already-paid, payout-canceled, payout-invalid-state, payout-must-be-approved-to-be-marked-paid, payout-not-found, payout-number-already-exists, phone-number-invalid, phone-number-landline, phone-number-opted-out, phone-verification-disabled, platform-feature-disabled, price-overrides-validation-failed, pricing-model-not-supported, promotional-plan-not-available, proxy-auth-ip-not-unique, public-actor-disabled, query-timeout, quoted-price-outdated, rate-limit-exceeded, readme-required, recaptcha-invalid, recaptcha-required, record-not-found, record-not-public, record-or-token-not-found, record-too-large, redirect-uri-mismatch, reduced-plan-not-available, rental-charge-already-reimbursed, rental-not-allowed, request-aborted-prematurely, request-handled-or-locked, request-id-invalid, request-queue-duplicate-requests, request-too-large, requested-dataset-view-does-not-exist, resume-token-expired, run-failed, run-input-body-not-valid-json, run-timeout-exceeded, russia-is-evil, same-user, schedule-actor-not-found, schedule-actor-task-not-found, schedule-name-not-unique, schema-validation, schema-validation-error, schema-validation-failed, schemas-required, service-worker-registration-not-allowed, sign-up-method-not-allowed, slack-integration-not-custom, socket-closed, socket-destroyed, standby-deployment-invalid, store-schema-invalid, store-terms-not-accepted, stripe-enabled, stripe-generic-decline, stripe-not-enabled, stripe-not-enabled-for-user, tagged-build-required, tax-country-invalid, tax-number-invalid, tax-number-validation-failed, taxamo-call-failed, taxamo-request-failed, testing-error, token-not-provided, too-few-versions, too-many-actor-tasks, too-many-actors, too-many-labels-on-resource, too-many-mcp-connectors, too-many-o-auth-apps, too-many-organizations, too-many-public-actor-tasks-per-account, too-many-public-actor-tasks-per-actor, too-many-requests, too-many-schedules, too-many-ui-access-keys, too-many-user-labels, too-many-values, too-many-versions, too-many-webhooks, unexpected-route, unknown-build-tag, unknown-payment-provider, unsubscribe-token-invalid, unsupported-actor-pricing-model-for-agentic-payments, unsupported-content-encoding, unsupported-file-type-for-issue, unsupported-file-type-image-expected, unsupported-file-type-text-or-json-expected, unsupported-permission, upcoming-subscription-bill-not-up-to-date, user-already-exists, user-already-verified, user-creates-organizations-too-fast, user-disabled, user-email-is-disposable, user-email-not-set, user-email-not-verified, user-has-no-subscription, user-integration-not-found, user-is-already-invited, user-is-already-organization-member, user-is-not-member-of-organization, user-is-not-organization, user-is-organization, user-is-organization-owner, user-is-removed, user-not-found, user-not-logged-in, user-not-verified, user-or-token-not-found, user-plan-not-allowed-for-coupon, user-problem-with-card, user-record-not-found, username-already-taken, username-missing, username-not-allowed, username-removal-forbidden, username-required, verification-email-already-sent, verification-token-expired, version-already-exists, versions-size-exceeded, weak-password, x402-agentic-payment-already-finalized, x402-agentic-payment-insufficient-amount, x402-agentic-payment-malformed-token, x402-agentic-payment-settlement-failed, x402-agentic-payment-settlement-in-progress, x402-agentic-payment-settlement-stuck, x402-agentic-payment-unauthorized, x402-payment-required, zero-invoice]

  • message string

    Human-readable error message describing what went wrong.

  • data object

    Additional machine-readable details about the error. Present only for some error types.

Status 403

Forbidden - insufficient permissions to perform this action.

{
  "error": {
    "type": "insufficient-permissions",
    "message": "You do not have permission to perform this action."
  }
}

Schema

• error object required

  • type ErrorType (string)

    Machine-processable error type identifier.

    Possible values: [3d-secure-auth-failed, access-right-already-exists, action-not-found, actor-already-rented, actor-can-not-be-rented, actor-disabled, actor-is-not-rented, actor-memory-limit-exceeded, actor-name-exists-new-owner, actor-name-not-unique, actor-not-found, actor-not-github-actor, actor-not-public, actor-permission-level-not-supported-for-agentic-payments, actor-review-already-exists, actor-run-failed, actor-standby-not-supported-for-agentic-payments, actor-task-name-not-unique, agentic-payment-info-retrieval-error, agentic-payment-information-missing, agentic-payment-insufficient-amount, agentic-payment-provider-internal-error, agentic-payment-provider-unauthorized, airtable-webhook-deprecated, already-subscribed-to-paid-actor, apify-plan-required-to-use-paid-actor, apify-signup-not-allowed, auth-method-not-supported, authorization-server-not-found, auto-issue-date-invalid, background-check-required, billing-system-error, black-friday-plan-expired, braintree-error, braintree-not-linked, braintree-operation-timed-out, braintree-unsupported-currency, build-not-found, build-outdated, cannot-add-apify-events-to-ppe-actor, cannot-add-multiple-pricing-infos, cannot-add-pricing-info-that-alters-past, cannot-add-second-future-pricing-info, cannot-build-actor-from-webhook, cannot-change-billing-interval, cannot-change-owner, cannot-charge-apify-event, cannot-charge-non-pay-per-event-actor, cannot-comment-as-other-user, cannot-copy-actor-task, cannot-create-payout, cannot-create-public-actor, cannot-create-tax-transaction, cannot-delete-critical-actor, cannot-delete-invoice, cannot-delete-paid-actor, cannot-disable-one-time-event-for-apify-start-event, cannot-disable-organization-with-enabled-members, cannot-disable-user-with-subscription, cannot-link-oauth-to-unverified-email, cannot-metamorph-to-pay-per-result-actor, cannot-modify-actor-pricing-too-frequently, cannot-modify-actor-pricing-with-immediate-effect, cannot-monetize-without-payout-billing-info, cannot-override-paid-actor-trial, cannot-permanently-delete-subscription, cannot-publish-actor, cannot-publish-actor-task, cannot-reduce-last-full-token, cannot-reimburse-more-than-original-charge, cannot-reimburse-non-rental-charge, cannot-remove-own-actor-from-recently-used, cannot-remove-payment-method, cannot-remove-pricing-info, cannot-remove-running-run, cannot-remove-user-with-public-actors, cannot-remove-user-with-subscription, cannot-remove-user-with-unpaid-invoice, cannot-rename-env-var, cannot-rent-paid-actor, cannot-review-own-actor, cannot-set-access-rights-for-owner, cannot-set-is-status-message-terminal, cannot-unpublish-critical-actor, cannot-unpublish-paid-actor, cannot-unpublish-profile, cannot-update-invoice-field, concurrent-runs-limit-exceeded, concurrent-update-detected, conference-token-not-found, content-encoding-forbidden-for-html, coupon-already-redeemed, coupon-expired, coupon-for-new-customers, coupon-for-subscribed-users, coupon-limits-are-in-conflict-with-current-limits, coupon-max-number-of-redemptions-reached, coupon-not-found, coupon-not-unique, coupons-disabled, create-github-issue-not-allowed, creator-plan-not-available, cron-expression-invalid, daily-ai-token-limit-exceeded, daily-publication-limit-exceeded, dataset-does-not-have-fields-schema, dataset-does-not-have-schema, dataset-locked, dataset-schema-invalid, dcr-not-supported, default-dataset-not-found, deleting-default-build, deleting-unfinished-build, email-already-taken, email-already-taken-removed-user, email-domain-not-allowed-for-coupon, email-invalid, email-not-allowed, email-not-valid, email-update-too-soon, elevated-permissions-needed, env-var-already-exists, exchange-rate-fetch-failed, expired-conference-token, failed-to-charge-user, final-invoice-negative, full-permission-actor-blocked-for-admin, full-permission-actor-not-approved, full-permissions-require-verified-owner, github-branch-empty, github-issue-already-exists, github-public-key-not-found, github-repository-not-found, github-signature-does-not-match-payload, github-user-not-authorized-for-issues, gmail-not-allowed, id-does-not-match, incompatible-billing-interval, incomplete-payout-billing-info, inconsistent-currencies, incorrect-pricing-modifier-prefix, input-json-invalid-characters, input-json-not-object, input-json-too-long, input-update-collision, input-validation-timed-out, insufficient-permissions, insufficient-permissions-to-change-field, insufficient-security-measures, insufficient-tax-country-evidence, integration-auth-error, internal-server-error, invalid-billing-info, invalid-billing-period-for-payout, invalid-build, invalid-client-key, invalid-collection, invalid-conference-login-password, invalid-content-type-header, invalid-credentials, invalid-git-auth-token, invalid-github-issue-url, invalid-header, invalid-id, invalid-idempotency-key, invalid-input, invalid-input-schema, invalid-invoice, invalid-invoice-type, invalid-issue-date, invalid-label-params, invalid-main-account-user-id, invalid-oauth-app, invalid-oauth-scope, invalid-one-time-invoice, invalid-parameter, invalid-payout-status, invalid-picture-url, invalid-record-key, invalid-request, invalid-resource-type, invalid-signature, invalid-subscription-plan, invalid-tax-number, invalid-tax-number-format, invalid-token, invalid-token-type, invalid-two-factor-code, invalid-two-factor-code-or-recovery-code, invalid-two-factor-recovery-code, invalid-username, invalid-value, invitation-invalid-resource-type, invitation-no-longer-valid, invoice-canceled, invoice-cannot-be-refunded-due-to-too-high-amount, invoice-incomplete, invoice-is-draft, invoice-locked, invoice-must-be-buffer, invoice-not-canceled, invoice-not-draft, invoice-not-found, invoice-outdated, invoice-paid-already, issue-already-connected-to-github, issue-not-found, issues-bad-request, issuer-not-registered, job-finished, label-already-linked, last-api-token, limit-reached, max-items-must-be-greater-than-zero, max-metamorphs-exceeded, max-total-charge-usd-below-minimum, max-total-charge-usd-must-be-greater-than-zero, mcp-connector-actor-not-allowed, method-not-allowed, migration-disabled, missing-actor-rights, missing-api-token, missing-billing-info, missing-line-items, missing-payment-date, missing-payout-billing-info, missing-proxy-password, missing-reporting-fields, missing-resource-name, missing-settings, missing-username, monthly-usage-limit-too-low, more-public-actors-require-verified-owner, more-than-one-update-not-allowed, multiple-records-found, must-be-admin, name-not-unique, next-runtime-computation-failed, no-columns-in-exported-dataset, no-payment-attempt-for-refund-found, no-payment-method-available, no-team-account-seats-available, non-temporary-email, not-enough-usage-to-run-paid-actor, not-implemented, not-supported-currencies, o-auth-service-already-connected, o-auth-service-not-connected, oauth-resource-access-failed, one-time-invoice-already-marked-paid, only-drafts-can-be-deleted, operation-canceled, operation-not-allowed, operation-timed-out, organization-cannot-own-itself, organization-role-not-found, overlapping-payout-billing-periods, own-token-required, page-not-found, param-not-one-of, parameter-required, parameters-mismatched, password-reset-email-already-sent, password-reset-token-expired, pay-as-you-go-without-monthly-interval, payment-attempt-status-message-required, payout-already-paid, payout-canceled, payout-invalid-state, payout-must-be-approved-to-be-marked-paid, payout-not-found, payout-number-already-exists, phone-number-invalid, phone-number-landline, phone-number-opted-out, phone-verification-disabled, platform-feature-disabled, price-overrides-validation-failed, pricing-model-not-supported, promotional-plan-not-available, proxy-auth-ip-not-unique, public-actor-disabled, query-timeout, quoted-price-outdated, rate-limit-exceeded, readme-required, recaptcha-invalid, recaptcha-required, record-not-found, record-not-public, record-or-token-not-found, record-too-large, redirect-uri-mismatch, reduced-plan-not-available, rental-charge-already-reimbursed, rental-not-allowed, request-aborted-prematurely, request-handled-or-locked, request-id-invalid, request-queue-duplicate-requests, request-too-large, requested-dataset-view-does-not-exist, resume-token-expired, run-failed, run-input-body-not-valid-json, run-timeout-exceeded, russia-is-evil, same-user, schedule-actor-not-found, schedule-actor-task-not-found, schedule-name-not-unique, schema-validation, schema-validation-error, schema-validation-failed, schemas-required, service-worker-registration-not-allowed, sign-up-method-not-allowed, slack-integration-not-custom, socket-closed, socket-destroyed, standby-deployment-invalid, store-schema-invalid, store-terms-not-accepted, stripe-enabled, stripe-generic-decline, stripe-not-enabled, stripe-not-enabled-for-user, tagged-build-required, tax-country-invalid, tax-number-invalid, tax-number-validation-failed, taxamo-call-failed, taxamo-request-failed, testing-error, token-not-provided, too-few-versions, too-many-actor-tasks, too-many-actors, too-many-labels-on-resource, too-many-mcp-connectors, too-many-o-auth-apps, too-many-organizations, too-many-public-actor-tasks-per-account, too-many-public-actor-tasks-per-actor, too-many-requests, too-many-schedules, too-many-ui-access-keys, too-many-user-labels, too-many-values, too-many-versions, too-many-webhooks, unexpected-route, unknown-build-tag, unknown-payment-provider, unsubscribe-token-invalid, unsupported-actor-pricing-model-for-agentic-payments, unsupported-content-encoding, unsupported-file-type-for-issue, unsupported-file-type-image-expected, unsupported-file-type-text-or-json-expected, unsupported-permission, upcoming-subscription-bill-not-up-to-date, user-already-exists, user-already-verified, user-creates-organizations-too-fast, user-disabled, user-email-is-disposable, user-email-not-set, user-email-not-verified, user-has-no-subscription, user-integration-not-found, user-is-already-invited, user-is-already-organization-member, user-is-not-member-of-organization, user-is-not-organization, user-is-organization, user-is-organization-owner, user-is-removed, user-not-found, user-not-logged-in, user-not-verified, user-or-token-not-found, user-plan-not-allowed-for-coupon, user-problem-with-card, user-record-not-found, username-already-taken, username-missing, username-not-allowed, username-removal-forbidden, username-required, verification-email-already-sent, verification-token-expired, version-already-exists, versions-size-exceeded, weak-password, x402-agentic-payment-already-finalized, x402-agentic-payment-insufficient-amount, x402-agentic-payment-malformed-token, x402-agentic-payment-settlement-failed, x402-agentic-payment-settlement-in-progress, x402-agentic-payment-settlement-stuck, x402-agentic-payment-unauthorized, x402-payment-required, zero-invoice]

  • message string

    Human-readable error message describing what went wrong.

  • data object

    Additional machine-readable details about the error. Present only for some error types.

Status 404

Not found - the requested resource does not exist.

{
  "error": {
    "type": "record-not-found",
    "message": "The requested resource was not found."
  }
}

Schema

• error object required

  • type ErrorType (string)

    Machine-processable error type identifier.

    Possible values: [3d-secure-auth-failed, access-right-already-exists, action-not-found, actor-already-rented, actor-can-not-be-rented, actor-disabled, actor-is-not-rented, actor-memory-limit-exceeded, actor-name-exists-new-owner, actor-name-not-unique, actor-not-found, actor-not-github-actor, actor-not-public, actor-permission-level-not-supported-for-agentic-payments, actor-review-already-exists, actor-run-failed, actor-standby-not-supported-for-agentic-payments, actor-task-name-not-unique, agentic-payment-info-retrieval-error, agentic-payment-information-missing, agentic-payment-insufficient-amount, agentic-payment-provider-internal-error, agentic-payment-provider-unauthorized, airtable-webhook-deprecated, already-subscribed-to-paid-actor, apify-plan-required-to-use-paid-actor, apify-signup-not-allowed, auth-method-not-supported, authorization-server-not-found, auto-issue-date-invalid, background-check-required, billing-system-error, black-friday-plan-expired, braintree-error, braintree-not-linked, braintree-operation-timed-out, braintree-unsupported-currency, build-not-found, build-outdated, cannot-add-apify-events-to-ppe-actor, cannot-add-multiple-pricing-infos, cannot-add-pricing-info-that-alters-past, cannot-add-second-future-pricing-info, cannot-build-actor-from-webhook, cannot-change-billing-interval, cannot-change-owner, cannot-charge-apify-event, cannot-charge-non-pay-per-event-actor, cannot-comment-as-other-user, cannot-copy-actor-task, cannot-create-payout, cannot-create-public-actor, cannot-create-tax-transaction, cannot-delete-critical-actor, cannot-delete-invoice, cannot-delete-paid-actor, cannot-disable-one-time-event-for-apify-start-event, cannot-disable-organization-with-enabled-members, cannot-disable-user-with-subscription, cannot-link-oauth-to-unverified-email, cannot-metamorph-to-pay-per-result-actor, cannot-modify-actor-pricing-too-frequently, cannot-modify-actor-pricing-with-immediate-effect, cannot-monetize-without-payout-billing-info, cannot-override-paid-actor-trial, cannot-permanently-delete-subscription, cannot-publish-actor, cannot-publish-actor-task, cannot-reduce-last-full-token, cannot-reimburse-more-than-original-charge, cannot-reimburse-non-rental-charge, cannot-remove-own-actor-from-recently-used, cannot-remove-payment-method, cannot-remove-pricing-info, cannot-remove-running-run, cannot-remove-user-with-public-actors, cannot-remove-user-with-subscription, cannot-remove-user-with-unpaid-invoice, cannot-rename-env-var, cannot-rent-paid-actor, cannot-review-own-actor, cannot-set-access-rights-for-owner, cannot-set-is-status-message-terminal, cannot-unpublish-critical-actor, cannot-unpublish-paid-actor, cannot-unpublish-profile, cannot-update-invoice-field, concurrent-runs-limit-exceeded, concurrent-update-detected, conference-token-not-found, content-encoding-forbidden-for-html, coupon-already-redeemed, coupon-expired, coupon-for-new-customers, coupon-for-subscribed-users, coupon-limits-are-in-conflict-with-current-limits, coupon-max-number-of-redemptions-reached, coupon-not-found, coupon-not-unique, coupons-disabled, create-github-issue-not-allowed, creator-plan-not-available, cron-expression-invalid, daily-ai-token-limit-exceeded, daily-publication-limit-exceeded, dataset-does-not-have-fields-schema, dataset-does-not-have-schema, dataset-locked, dataset-schema-invalid, dcr-not-supported, default-dataset-not-found, deleting-default-build, deleting-unfinished-build, email-already-taken, email-already-taken-removed-user, email-domain-not-allowed-for-coupon, email-invalid, email-not-allowed, email-not-valid, email-update-too-soon, elevated-permissions-needed, env-var-already-exists, exchange-rate-fetch-failed, expired-conference-token, failed-to-charge-user, final-invoice-negative, full-permission-actor-blocked-for-admin, full-permission-actor-not-approved, full-permissions-require-verified-owner, github-branch-empty, github-issue-already-exists, github-public-key-not-found, github-repository-not-found, github-signature-does-not-match-payload, github-user-not-authorized-for-issues, gmail-not-allowed, id-does-not-match, incompatible-billing-interval, incomplete-payout-billing-info, inconsistent-currencies, incorrect-pricing-modifier-prefix, input-json-invalid-characters, input-json-not-object, input-json-too-long, input-update-collision, input-validation-timed-out, insufficient-permissions, insufficient-permissions-to-change-field, insufficient-security-measures, insufficient-tax-country-evidence, integration-auth-error, internal-server-error, invalid-billing-info, invalid-billing-period-for-payout, invalid-build, invalid-client-key, invalid-collection, invalid-conference-login-password, invalid-content-type-header, invalid-credentials, invalid-git-auth-token, invalid-github-issue-url, invalid-header, invalid-id, invalid-idempotency-key, invalid-input, invalid-input-schema, invalid-invoice, invalid-invoice-type, invalid-issue-date, invalid-label-params, invalid-main-account-user-id, invalid-oauth-app, invalid-oauth-scope, invalid-one-time-invoice, invalid-parameter, invalid-payout-status, invalid-picture-url, invalid-record-key, invalid-request, invalid-resource-type, invalid-signature, invalid-subscription-plan, invalid-tax-number, invalid-tax-number-format, invalid-token, invalid-token-type, invalid-two-factor-code, invalid-two-factor-code-or-recovery-code, invalid-two-factor-recovery-code, invalid-username, invalid-value, invitation-invalid-resource-type, invitation-no-longer-valid, invoice-canceled, invoice-cannot-be-refunded-due-to-too-high-amount, invoice-incomplete, invoice-is-draft, invoice-locked, invoice-must-be-buffer, invoice-not-canceled, invoice-not-draft, invoice-not-found, invoice-outdated, invoice-paid-already, issue-already-connected-to-github, issue-not-found, issues-bad-request, issuer-not-registered, job-finished, label-already-linked, last-api-token, limit-reached, max-items-must-be-greater-than-zero, max-metamorphs-exceeded, max-total-charge-usd-below-minimum, max-total-charge-usd-must-be-greater-than-zero, mcp-connector-actor-not-allowed, method-not-allowed, migration-disabled, missing-actor-rights, missing-api-token, missing-billing-info, missing-line-items, missing-payment-date, missing-payout-billing-info, missing-proxy-password, missing-reporting-fields, missing-resource-name, missing-settings, missing-username, monthly-usage-limit-too-low, more-public-actors-require-verified-owner, more-than-one-update-not-allowed, multiple-records-found, must-be-admin, name-not-unique, next-runtime-computation-failed, no-columns-in-exported-dataset, no-payment-attempt-for-refund-found, no-payment-method-available, no-team-account-seats-available, non-temporary-email, not-enough-usage-to-run-paid-actor, not-implemented, not-supported-currencies, o-auth-service-already-connected, o-auth-service-not-connected, oauth-resource-access-failed, one-time-invoice-already-marked-paid, only-drafts-can-be-deleted, operation-canceled, operation-not-allowed, operation-timed-out, organization-cannot-own-itself, organization-role-not-found, overlapping-payout-billing-periods, own-token-required, page-not-found, param-not-one-of, parameter-required, parameters-mismatched, password-reset-email-already-sent, password-reset-token-expired, pay-as-you-go-without-monthly-interval, payment-attempt-status-message-required, payout-already-paid, payout-canceled, payout-invalid-state, payout-must-be-approved-to-be-marked-paid, payout-not-found, payout-number-already-exists, phone-number-invalid, phone-number-landline, phone-number-opted-out, phone-verification-disabled, platform-feature-disabled, price-overrides-validation-failed, pricing-model-not-supported, promotional-plan-not-available, proxy-auth-ip-not-unique, public-actor-disabled, query-timeout, quoted-price-outdated, rate-limit-exceeded, readme-required, recaptcha-invalid, recaptcha-required, record-not-found, record-not-public, record-or-token-not-found, record-too-large, redirect-uri-mismatch, reduced-plan-not-available, rental-charge-already-reimbursed, rental-not-allowed, request-aborted-prematurely, request-handled-or-locked, request-id-invalid, request-queue-duplicate-requests, request-too-large, requested-dataset-view-does-not-exist, resume-token-expired, run-failed, run-input-body-not-valid-json, run-timeout-exceeded, russia-is-evil, same-user, schedule-actor-not-found, schedule-actor-task-not-found, schedule-name-not-unique, schema-validation, schema-validation-error, schema-validation-failed, schemas-required, service-worker-registration-not-allowed, sign-up-method-not-allowed, slack-integration-not-custom, socket-closed, socket-destroyed, standby-deployment-invalid, store-schema-invalid, store-terms-not-accepted, stripe-enabled, stripe-generic-decline, stripe-not-enabled, stripe-not-enabled-for-user, tagged-build-required, tax-country-invalid, tax-number-invalid, tax-number-validation-failed, taxamo-call-failed, taxamo-request-failed, testing-error, token-not-provided, too-few-versions, too-many-actor-tasks, too-many-actors, too-many-labels-on-resource, too-many-mcp-connectors, too-many-o-auth-apps, too-many-organizations, too-many-public-actor-tasks-per-account, too-many-public-actor-tasks-per-actor, too-many-requests, too-many-schedules, too-many-ui-access-keys, too-many-user-labels, too-many-values, too-many-versions, too-many-webhooks, unexpected-route, unknown-build-tag, unknown-payment-provider, unsubscribe-token-invalid, unsupported-actor-pricing-model-for-agentic-payments, unsupported-content-encoding, unsupported-file-type-for-issue, unsupported-file-type-image-expected, unsupported-file-type-text-or-json-expected, unsupported-permission, upcoming-subscription-bill-not-up-to-date, user-already-exists, user-already-verified, user-creates-organizations-too-fast, user-disabled, user-email-is-disposable, user-email-not-set, user-email-not-verified, user-has-no-subscription, user-integration-not-found, user-is-already-invited, user-is-already-organization-member, user-is-not-member-of-organization, user-is-not-organization, user-is-organization, user-is-organization-owner, user-is-removed, user-not-found, user-not-logged-in, user-not-verified, user-or-token-not-found, user-plan-not-allowed-for-coupon, user-problem-with-card, user-record-not-found, username-already-taken, username-missing, username-not-allowed, username-removal-forbidden, username-required, verification-email-already-sent, verification-token-expired, version-already-exists, versions-size-exceeded, weak-password, x402-agentic-payment-already-finalized, x402-agentic-payment-insufficient-amount, x402-agentic-payment-malformed-token, x402-agentic-payment-settlement-failed, x402-agentic-payment-settlement-in-progress, x402-agentic-payment-settlement-stuck, x402-agentic-payment-unauthorized, x402-payment-required, zero-invoice]

  • message string

    Human-readable error message describing what went wrong.

  • data object

    Additional machine-readable details about the error. Present only for some error types.

Status 405

Method not allowed.

{
  "error": {
    "type": "method-not-allowed",
    "message": "This API end-point can only be accessed using the following HTTP methods: OPTIONS,GET"
  }
}

Schema

• error object required

  • type ErrorType (string)

    Machine-processable error type identifier.

    Possible values: [3d-secure-auth-failed, access-right-already-exists, action-not-found, actor-already-rented, actor-can-not-be-rented, actor-disabled, actor-is-not-rented, actor-memory-limit-exceeded, actor-name-exists-new-owner, actor-name-not-unique, actor-not-found, actor-not-github-actor, actor-not-public, actor-permission-level-not-supported-for-agentic-payments, actor-review-already-exists, actor-run-failed, actor-standby-not-supported-for-agentic-payments, actor-task-name-not-unique, agentic-payment-info-retrieval-error, agentic-payment-information-missing, agentic-payment-insufficient-amount, agentic-payment-provider-internal-error, agentic-payment-provider-unauthorized, airtable-webhook-deprecated, already-subscribed-to-paid-actor, apify-plan-required-to-use-paid-actor, apify-signup-not-allowed, auth-method-not-supported, authorization-server-not-found, auto-issue-date-invalid, background-check-required, billing-system-error, black-friday-plan-expired, braintree-error, braintree-not-linked, braintree-operation-timed-out, braintree-unsupported-currency, build-not-found, build-outdated, cannot-add-apify-events-to-ppe-actor, cannot-add-multiple-pricing-infos, cannot-add-pricing-info-that-alters-past, cannot-add-second-future-pricing-info, cannot-build-actor-from-webhook, cannot-change-billing-interval, cannot-change-owner, cannot-charge-apify-event, cannot-charge-non-pay-per-event-actor, cannot-comment-as-other-user, cannot-copy-actor-task, cannot-create-payout, cannot-create-public-actor, cannot-create-tax-transaction, cannot-delete-critical-actor, cannot-delete-invoice, cannot-delete-paid-actor, cannot-disable-one-time-event-for-apify-start-event, cannot-disable-organization-with-enabled-members, cannot-disable-user-with-subscription, cannot-link-oauth-to-unverified-email, cannot-metamorph-to-pay-per-result-actor, cannot-modify-actor-pricing-too-frequently, cannot-modify-actor-pricing-with-immediate-effect, cannot-monetize-without-payout-billing-info, cannot-override-paid-actor-trial, cannot-permanently-delete-subscription, cannot-publish-actor, cannot-publish-actor-task, cannot-reduce-last-full-token, cannot-reimburse-more-than-original-charge, cannot-reimburse-non-rental-charge, cannot-remove-own-actor-from-recently-used, cannot-remove-payment-method, cannot-remove-pricing-info, cannot-remove-running-run, cannot-remove-user-with-public-actors, cannot-remove-user-with-subscription, cannot-remove-user-with-unpaid-invoice, cannot-rename-env-var, cannot-rent-paid-actor, cannot-review-own-actor, cannot-set-access-rights-for-owner, cannot-set-is-status-message-terminal, cannot-unpublish-critical-actor, cannot-unpublish-paid-actor, cannot-unpublish-profile, cannot-update-invoice-field, concurrent-runs-limit-exceeded, concurrent-update-detected, conference-token-not-found, content-encoding-forbidden-for-html, coupon-already-redeemed, coupon-expired, coupon-for-new-customers, coupon-for-subscribed-users, coupon-limits-are-in-conflict-with-current-limits, coupon-max-number-of-redemptions-reached, coupon-not-found, coupon-not-unique, coupons-disabled, create-github-issue-not-allowed, creator-plan-not-available, cron-expression-invalid, daily-ai-token-limit-exceeded, daily-publication-limit-exceeded, dataset-does-not-have-fields-schema, dataset-does-not-have-schema, dataset-locked, dataset-schema-invalid, dcr-not-supported, default-dataset-not-found, deleting-default-build, deleting-unfinished-build, email-already-taken, email-already-taken-removed-user, email-domain-not-allowed-for-coupon, email-invalid, email-not-allowed, email-not-valid, email-update-too-soon, elevated-permissions-needed, env-var-already-exists, exchange-rate-fetch-failed, expired-conference-token, failed-to-charge-user, final-invoice-negative, full-permission-actor-blocked-for-admin, full-permission-actor-not-approved, full-permissions-require-verified-owner, github-branch-empty, github-issue-already-exists, github-public-key-not-found, github-repository-not-found, github-signature-does-not-match-payload, github-user-not-authorized-for-issues, gmail-not-allowed, id-does-not-match, incompatible-billing-interval, incomplete-payout-billing-info, inconsistent-currencies, incorrect-pricing-modifier-prefix, input-json-invalid-characters, input-json-not-object, input-json-too-long, input-update-collision, input-validation-timed-out, insufficient-permissions, insufficient-permissions-to-change-field, insufficient-security-measures, insufficient-tax-country-evidence, integration-auth-error, internal-server-error, invalid-billing-info, invalid-billing-period-for-payout, invalid-build, invalid-client-key, invalid-collection, invalid-conference-login-password, invalid-content-type-header, invalid-credentials, invalid-git-auth-token, invalid-github-issue-url, invalid-header, invalid-id, invalid-idempotency-key, invalid-input, invalid-input-schema, invalid-invoice, invalid-invoice-type, invalid-issue-date, invalid-label-params, invalid-main-account-user-id, invalid-oauth-app, invalid-oauth-scope, invalid-one-time-invoice, invalid-parameter, invalid-payout-status, invalid-picture-url, invalid-record-key, invalid-request, invalid-resource-type, invalid-signature, invalid-subscription-plan, invalid-tax-number, invalid-tax-number-format, invalid-token, invalid-token-type, invalid-two-factor-code, invalid-two-factor-code-or-recovery-code, invalid-two-factor-recovery-code, invalid-username, invalid-value, invitation-invalid-resource-type, invitation-no-longer-valid, invoice-canceled, invoice-cannot-be-refunded-due-to-too-high-amount, invoice-incomplete, invoice-is-draft, invoice-locked, invoice-must-be-buffer, invoice-not-canceled, invoice-not-draft, invoice-not-found, invoice-outdated, invoice-paid-already, issue-already-connected-to-github, issue-not-found, issues-bad-request, issuer-not-registered, job-finished, label-already-linked, last-api-token, limit-reached, max-items-must-be-greater-than-zero, max-metamorphs-exceeded, max-total-charge-usd-below-minimum, max-total-charge-usd-must-be-greater-than-zero, mcp-connector-actor-not-allowed, method-not-allowed, migration-disabled, missing-actor-rights, missing-api-token, missing-billing-info, missing-line-items, missing-payment-date, missing-payout-billing-info, missing-proxy-password, missing-reporting-fields, missing-resource-name, missing-settings, missing-username, monthly-usage-limit-too-low, more-public-actors-require-verified-owner, more-than-one-update-not-allowed, multiple-records-found, must-be-admin, name-not-unique, next-runtime-computation-failed, no-columns-in-exported-dataset, no-payment-attempt-for-refund-found, no-payment-method-available, no-team-account-seats-available, non-temporary-email, not-enough-usage-to-run-paid-actor, not-implemented, not-supported-currencies, o-auth-service-already-connected, o-auth-service-not-connected, oauth-resource-access-failed, one-time-invoice-already-marked-paid, only-drafts-can-be-deleted, operation-canceled, operation-not-allowed, operation-timed-out, organization-cannot-own-itself, organization-role-not-found, overlapping-payout-billing-periods, own-token-required, page-not-found, param-not-one-of, parameter-required, parameters-mismatched, password-reset-email-already-sent, password-reset-token-expired, pay-as-you-go-without-monthly-interval, payment-attempt-status-message-required, payout-already-paid, payout-canceled, payout-invalid-state, payout-must-be-approved-to-be-marked-paid, payout-not-found, payout-number-already-exists, phone-number-invalid, phone-number-landline, phone-number-opted-out, phone-verification-disabled, platform-feature-disabled, price-overrides-validation-failed, pricing-model-not-supported, promotional-plan-not-available, proxy-auth-ip-not-unique, public-actor-disabled, query-timeout, quoted-price-outdated, rate-limit-exceeded, readme-required, recaptcha-invalid, recaptcha-required, record-not-found, record-not-public, record-or-token-not-found, record-too-large, redirect-uri-mismatch, reduced-plan-not-available, rental-charge-already-reimbursed, rental-not-allowed, request-aborted-prematurely, request-handled-or-locked, request-id-invalid, request-queue-duplicate-requests, request-too-large, requested-dataset-view-does-not-exist, resume-token-expired, run-failed, run-input-body-not-valid-json, run-timeout-exceeded, russia-is-evil, same-user, schedule-actor-not-found, schedule-actor-task-not-found, schedule-name-not-unique, schema-validation, schema-validation-error, schema-validation-failed, schemas-required, service-worker-registration-not-allowed, sign-up-method-not-allowed, slack-integration-not-custom, socket-closed, socket-destroyed, standby-deployment-invalid, store-schema-invalid, store-terms-not-accepted, stripe-enabled, stripe-generic-decline, stripe-not-enabled, stripe-not-enabled-for-user, tagged-build-required, tax-country-invalid, tax-number-invalid, tax-number-validation-failed, taxamo-call-failed, taxamo-request-failed, testing-error, token-not-provided, too-few-versions, too-many-actor-tasks, too-many-actors, too-many-labels-on-resource, too-many-mcp-connectors, too-many-o-auth-apps, too-many-organizations, too-many-public-actor-tasks-per-account, too-many-public-actor-tasks-per-actor, too-many-requests, too-many-schedules, too-many-ui-access-keys, too-many-user-labels, too-many-values, too-many-versions, too-many-webhooks, unexpected-route, unknown-build-tag, unknown-payment-provider, unsubscribe-token-invalid, unsupported-actor-pricing-model-for-agentic-payments, unsupported-content-encoding, unsupported-file-type-for-issue, unsupported-file-type-image-expected, unsupported-file-type-text-or-json-expected, unsupported-permission, upcoming-subscription-bill-not-up-to-date, user-already-exists, user-already-verified, user-creates-organizations-too-fast, user-disabled, user-email-is-disposable, user-email-not-set, user-email-not-verified, user-has-no-subscription, user-integration-not-found, user-is-already-invited, user-is-already-organization-member, user-is-not-member-of-organization, user-is-not-organization, user-is-organization, user-is-organization-owner, user-is-removed, user-not-found, user-not-logged-in, user-not-verified, user-or-token-not-found, user-plan-not-allowed-for-coupon, user-problem-with-card, user-record-not-found, username-already-taken, username-missing, username-not-allowed, username-removal-forbidden, username-required, verification-email-already-sent, verification-token-expired, version-already-exists, versions-size-exceeded, weak-password, x402-agentic-payment-already-finalized, x402-agentic-payment-insufficient-amount, x402-agentic-payment-malformed-token, x402-agentic-payment-settlement-failed, x402-agentic-payment-settlement-in-progress, x402-agentic-payment-settlement-stuck, x402-agentic-payment-unauthorized, x402-payment-required, zero-invoice]

  • message string

    Human-readable error message describing what went wrong.

  • data object

    Additional machine-readable details about the error. Present only for some error types.

Status 429

Too many requests - rate limit exceeded.

{
  "error": {
    "type": "rate-limit-exceeded",
    "message": "You have exceeded the rate limit. Please try again later."
  }
}

Schema

• error object required

  • type ErrorType (string)

    Machine-processable error type identifier.

    Possible values: [3d-secure-auth-failed, access-right-already-exists, action-not-found, actor-already-rented, actor-can-not-be-rented, actor-disabled, actor-is-not-rented, actor-memory-limit-exceeded, actor-name-exists-new-owner, actor-name-not-unique, actor-not-found, actor-not-github-actor, actor-not-public, actor-permission-level-not-supported-for-agentic-payments, actor-review-already-exists, actor-run-failed, actor-standby-not-supported-for-agentic-payments, actor-task-name-not-unique, agentic-payment-info-retrieval-error, agentic-payment-information-missing, agentic-payment-insufficient-amount, agentic-payment-provider-internal-error, agentic-payment-provider-unauthorized, airtable-webhook-deprecated, already-subscribed-to-paid-actor, apify-plan-required-to-use-paid-actor, apify-signup-not-allowed, auth-method-not-supported, authorization-server-not-found, auto-issue-date-invalid, background-check-required, billing-system-error, black-friday-plan-expired, braintree-error, braintree-not-linked, braintree-operation-timed-out, braintree-unsupported-currency, build-not-found, build-outdated, cannot-add-apify-events-to-ppe-actor, cannot-add-multiple-pricing-infos, cannot-add-pricing-info-that-alters-past, cannot-add-second-future-pricing-info, cannot-build-actor-from-webhook, cannot-change-billing-interval, cannot-change-owner, cannot-charge-apify-event, cannot-charge-non-pay-per-event-actor, cannot-comment-as-other-user, cannot-copy-actor-task, cannot-create-payout, cannot-create-public-actor, cannot-create-tax-transaction, cannot-delete-critical-actor, cannot-delete-invoice, cannot-delete-paid-actor, cannot-disable-one-time-event-for-apify-start-event, cannot-disable-organization-with-enabled-members, cannot-disable-user-with-subscription, cannot-link-oauth-to-unverified-email, cannot-metamorph-to-pay-per-result-actor, cannot-modify-actor-pricing-too-frequently, cannot-modify-actor-pricing-with-immediate-effect, cannot-monetize-without-payout-billing-info, cannot-override-paid-actor-trial, cannot-permanently-delete-subscription, cannot-publish-actor, cannot-publish-actor-task, cannot-reduce-last-full-token, cannot-reimburse-more-than-original-charge, cannot-reimburse-non-rental-charge, cannot-remove-own-actor-from-recently-used, cannot-remove-payment-method, cannot-remove-pricing-info, cannot-remove-running-run, cannot-remove-user-with-public-actors, cannot-remove-user-with-subscription, cannot-remove-user-with-unpaid-invoice, cannot-rename-env-var, cannot-rent-paid-actor, cannot-review-own-actor, cannot-set-access-rights-for-owner, cannot-set-is-status-message-terminal, cannot-unpublish-critical-actor, cannot-unpublish-paid-actor, cannot-unpublish-profile, cannot-update-invoice-field, concurrent-runs-limit-exceeded, concurrent-update-detected, conference-token-not-found, content-encoding-forbidden-for-html, coupon-already-redeemed, coupon-expired, coupon-for-new-customers, coupon-for-subscribed-users, coupon-limits-are-in-conflict-with-current-limits, coupon-max-number-of-redemptions-reached, coupon-not-found, coupon-not-unique, coupons-disabled, create-github-issue-not-allowed, creator-plan-not-available, cron-expression-invalid, daily-ai-token-limit-exceeded, daily-publication-limit-exceeded, dataset-does-not-have-fields-schema, dataset-does-not-have-schema, dataset-locked, dataset-schema-invalid, dcr-not-supported, default-dataset-not-found, deleting-default-build, deleting-unfinished-build, email-already-taken, email-already-taken-removed-user, email-domain-not-allowed-for-coupon, email-invalid, email-not-allowed, email-not-valid, email-update-too-soon, elevated-permissions-needed, env-var-already-exists, exchange-rate-fetch-failed, expired-conference-token, failed-to-charge-user, final-invoice-negative, full-permission-actor-blocked-for-admin, full-permission-actor-not-approved, full-permissions-require-verified-owner, github-branch-empty, github-issue-already-exists, github-public-key-not-found, github-repository-not-found, github-signature-does-not-match-payload, github-user-not-authorized-for-issues, gmail-not-allowed, id-does-not-match, incompatible-billing-interval, incomplete-payout-billing-info, inconsistent-currencies, incorrect-pricing-modifier-prefix, input-json-invalid-characters, input-json-not-object, input-json-too-long, input-update-collision, input-validation-timed-out, insufficient-permissions, insufficient-permissions-to-change-field, insufficient-security-measures, insufficient-tax-country-evidence, integration-auth-error, internal-server-error, invalid-billing-info, invalid-billing-period-for-payout, invalid-build, invalid-client-key, invalid-collection, invalid-conference-login-password, invalid-content-type-header, invalid-credentials, invalid-git-auth-token, invalid-github-issue-url, invalid-header, invalid-id, invalid-idempotency-key, invalid-input, invalid-input-schema, invalid-invoice, invalid-invoice-type, invalid-issue-date, invalid-label-params, invalid-main-account-user-id, invalid-oauth-app, invalid-oauth-scope, invalid-one-time-invoice, invalid-parameter, invalid-payout-status, invalid-picture-url, invalid-record-key, invalid-request, invalid-resource-type, invalid-signature, invalid-subscription-plan, invalid-tax-number, invalid-tax-number-format, invalid-token, invalid-token-type, invalid-two-factor-code, invalid-two-factor-code-or-recovery-code, invalid-two-factor-recovery-code, invalid-username, invalid-value, invitation-invalid-resource-type, invitation-no-longer-valid, invoice-canceled, invoice-cannot-be-refunded-due-to-too-high-amount, invoice-incomplete, invoice-is-draft, invoice-locked, invoice-must-be-buffer, invoice-not-canceled, invoice-not-draft, invoice-not-found, invoice-outdated, invoice-paid-already, issue-already-connected-to-github, issue-not-found, issues-bad-request, issuer-not-registered, job-finished, label-already-linked, last-api-token, limit-reached, max-items-must-be-greater-than-zero, max-metamorphs-exceeded, max-total-charge-usd-below-minimum, max-total-charge-usd-must-be-greater-than-zero, mcp-connector-actor-not-allowed, method-not-allowed, migration-disabled, missing-actor-rights, missing-api-token, missing-billing-info, missing-line-items, missing-payment-date, missing-payout-billing-info, missing-proxy-password, missing-reporting-fields, missing-resource-name, missing-settings, missing-username, monthly-usage-limit-too-low, more-public-actors-require-verified-owner, more-than-one-update-not-allowed, multiple-records-found, must-be-admin, name-not-unique, next-runtime-computation-failed, no-columns-in-exported-dataset, no-payment-attempt-for-refund-found, no-payment-method-available, no-team-account-seats-available, non-temporary-email, not-enough-usage-to-run-paid-actor, not-implemented, not-supported-currencies, o-auth-service-already-connected, o-auth-service-not-connected, oauth-resource-access-failed, one-time-invoice-already-marked-paid, only-drafts-can-be-deleted, operation-canceled, operation-not-allowed, operation-timed-out, organization-cannot-own-itself, organization-role-not-found, overlapping-payout-billing-periods, own-token-required, page-not-found, param-not-one-of, parameter-required, parameters-mismatched, password-reset-email-already-sent, password-reset-token-expired, pay-as-you-go-without-monthly-interval, payment-attempt-status-message-required, payout-already-paid, payout-canceled, payout-invalid-state, payout-must-be-approved-to-be-marked-paid, payout-not-found, payout-number-already-exists, phone-number-invalid, phone-number-landline, phone-number-opted-out, phone-verification-disabled, platform-feature-disabled, price-overrides-validation-failed, pricing-model-not-supported, promotional-plan-not-available, proxy-auth-ip-not-unique, public-actor-disabled, query-timeout, quoted-price-outdated, rate-limit-exceeded, readme-required, recaptcha-invalid, recaptcha-required, record-not-found, record-not-public, record-or-token-not-found, record-too-large, redirect-uri-mismatch, reduced-plan-not-available, rental-charge-already-reimbursed, rental-not-allowed, request-aborted-prematurely, request-handled-or-locked, request-id-invalid, request-queue-duplicate-requests, request-too-large, requested-dataset-view-does-not-exist, resume-token-expired, run-failed, run-input-body-not-valid-json, run-timeout-exceeded, russia-is-evil, same-user, schedule-actor-not-found, schedule-actor-task-not-found, schedule-name-not-unique, schema-validation, schema-validation-error, schema-validation-failed, schemas-required, service-worker-registration-not-allowed, sign-up-method-not-allowed, slack-integration-not-custom, socket-closed, socket-destroyed, standby-deployment-invalid, store-schema-invalid, store-terms-not-accepted, stripe-enabled, stripe-generic-decline, stripe-not-enabled, stripe-not-enabled-for-user, tagged-build-required, tax-country-invalid, tax-number-invalid, tax-number-validation-failed, taxamo-call-failed, taxamo-request-failed, testing-error, token-not-provided, too-few-versions, too-many-actor-tasks, too-many-actors, too-many-labels-on-resource, too-many-mcp-connectors, too-many-o-auth-apps, too-many-organizations, too-many-public-actor-tasks-per-account, too-many-public-actor-tasks-per-actor, too-many-requests, too-many-schedules, too-many-ui-access-keys, too-many-user-labels, too-many-values, too-many-versions, too-many-webhooks, unexpected-route, unknown-build-tag, unknown-payment-provider, unsubscribe-token-invalid, unsupported-actor-pricing-model-for-agentic-payments, unsupported-content-encoding, unsupported-file-type-for-issue, unsupported-file-type-image-expected, unsupported-file-type-text-or-json-expected, unsupported-permission, upcoming-subscription-bill-not-up-to-date, user-already-exists, user-already-verified, user-creates-organizations-too-fast, user-disabled, user-email-is-disposable, user-email-not-set, user-email-not-verified, user-has-no-subscription, user-integration-not-found, user-is-already-invited, user-is-already-organization-member, user-is-not-member-of-organization, user-is-not-organization, user-is-organization, user-is-organization-owner, user-is-removed, user-not-found, user-not-logged-in, user-not-verified, user-or-token-not-found, user-plan-not-allowed-for-coupon, user-problem-with-card, user-record-not-found, username-already-taken, username-missing, username-not-allowed, username-removal-forbidden, username-required, verification-email-already-sent, verification-token-expired, version-already-exists, versions-size-exceeded, weak-password, x402-agentic-payment-already-finalized, x402-agentic-payment-insufficient-amount, x402-agentic-payment-malformed-token, x402-agentic-payment-settlement-failed, x402-agentic-payment-settlement-in-progress, x402-agentic-payment-settlement-stuck, x402-agentic-payment-unauthorized, x402-payment-required, zero-invoice]

  • message string

    Human-readable error message describing what went wrong.

  • data object

    Additional machine-readable details about the error. Present only for some error types.