Actions36
- Actors Actions
- Actor tasks Actions
- Datasets Actions
Overview
This node allows users to create an actor in the Apify platform by specifying various properties such as name, description, title, visibility (public or not), SEO details, error handling preferences, versions with environment variables and source files, categories, and default run options. It supports both structured input fields and a custom JSON body for advanced use cases. This node is useful for automating the deployment and management of actors in Apify, enabling integration of actor creation into workflows.
Use Case Examples
- Creating a new actor with a specific name, description, and version details including environment variables and source files.
- Setting up an actor with SEO metadata and categories for better organization and discoverability.
- Using a custom JSON body to define complex actor configurations not covered by the standard input fields.
Properties
| Name | Meaning |
|---|---|
| Name | The name of the actor to be created. |
| Description | A description of the actor. |
| Title | The title of the actor. |
| Is Public | Boolean flag indicating if the actor is public. |
| Seo Title | SEO title for the actor. |
| Seo Description | SEO description for the actor. |
| Restart On Error | Boolean flag to indicate if the actor should restart on error. |
| Versions | A collection of version objects for the actor, each containing version number, source type, environment variables, build options, and source files. |
| Categories | A collection of categories to classify the actor. |
| Default Run Options | Default options for running the actor. |
| Use Custom Body | Flag to indicate whether to use a custom JSON body for the request instead of the structured fields. |
| Custom Body | Custom JSON body to send in the request, allowing full control over the actor creation payload. |
Output
JSON
id- Unique identifier of the created actor.name- Name of the created actor.description- Description of the created actor.title- Title of the created actor.isPublic- Indicates if the actor is public.seoTitle- SEO title of the actor.seoDescription- SEO description of the actor.restartOnError- Indicates if the actor restarts on error.versions- Array of version objects associated with the actor.categories- Array of categories assigned to the actor.defaultRunOptions- Default run options for the actor.
Dependencies
- Apify API key credential
Troubleshooting
- Ensure the Apify API credential is correctly configured and has the necessary permissions to create actors.
- If using the custom body option, validate the JSON structure to avoid malformed request errors.
- Check for required fields like 'name' and 'versions' to prevent validation errors from the API.
Links
- Apify Actors Documentation - Official documentation for managing actors on the Apify platform.
