Actor Tasks

Actor Tasks help you prepare the configuration of an actor to perform a specific job (think of it as giving your actor a screenplay). Tasks enable you to create multiple configurations for a single Actor and then run the selected configuration directly from the Apify platform, scheduler or API.

Tasks can also be set up for actors made by someone else. Just search the library to find an actor you want to use, try it out, and if you like it, you can create a task from it with a single click of a button.

Creating a task

Important: When a new task is created, it is named "Untitled" by default - don't forget to rename it once you are happy with its configuration.

Create a Task for your actor

Go to the Actor section in the app and open the actor for which you want to create a task. Now you should see a console with the option to run the actor or create a task.

When you click the "Create Task" button, a new task will be created with the input and options copied from the tabs below.

Create a Task for a public actor

Tasks can also be set up for actors made by someone else. Just search the library to find an actor you want to use, try it out, and if you like it, you can create a task from it with a single click of a button - the same as for your actor.

Configuring the task

Once you create the task, you can configure its name and set up options and input for the actor. If you leave the options configuration empty, or partially empty, when you run the task, the missing options configuration will be prefilled with values from the actor's configuration.

Options configuration

A Task's input configuration works like an actor's, you can either set up raw input with a configured content type, or, if the actor has a defined input schema, a visual input UI will be visible.

Raw input UI

Visual input UI

Running the task

When you are happy with the configuration of your Task. You can run it directly from the UI with a click of a button. After you start it, you will be directed to the run page. Tasks can also be started using the API or scheduler.