Apify icon

Apify

Apify API
Join our community

Actions36

Overview

This node integrates with the Apify platform to perform a 'Metamorph run' operation on an Actor. It allows users to specify an Actor by ID or URL, provide a specific run ID of that Actor, and transform that run into a different target Actor with optional build configuration. This is useful for automating workflows where you want to reuse or transform the output of one Actor run into another Actor's context, such as chaining data processing tasks or adapting results for different purposes.

Use Case Examples

  1. Transforming a data scraping Actor run into a data cleaning Actor run automatically.
  2. Running a specific version (build) of a target Actor based on the output of a previous Actor run.

Properties

Name Meaning
Actor ID The ID or a tilde-separated owner's username and Actor name to identify the source Actor whose run will be transformed.
Run ID The specific run ID of the Actor to be transformed.
Target Actor Id The ID of the target Actor that the run should be transformed into.
Build Optional build tag or number of the target Actor to use for the transformation. Defaults to the target Actor's default run configuration (usually 'latest').
Use Custom Body Flag to indicate whether to use a custom request body for the transformation run.

Output

JSON

  • runId - The ID of the newly created transformed run.
  • status - The status of the transformed run.
  • details - Additional details or metadata about the transformed run.

Dependencies

  • Apify API key credential for authentication

Troubleshooting

  • Ensure the Actor ID and Run ID are valid and correctly formatted; invalid IDs will cause errors.
  • Verify that the target Actor ID exists and is accessible with the provided API credentials.
  • If using a custom body, ensure the body format matches the expected API schema to avoid request failures.
  • Common error messages may include authentication errors if the API key is invalid or missing, or 404 errors if the specified Actor or run does not exist.

Links

Discussion