Skip to main content
POST
Generate a Task

Authorizations

anchor-api-key
string
header
required

API key passed in the header

Body

application/json
taskName
string
required

Name of the task

taskPrompt
string
required

Natural-language description of what the task should do, used for AI generation. Make it as detailed as possible with all the logic and steps needed to complete the task.

async
boolean
default:true

Whether to generate the task asynchronously

description
string

Description of the task

application_id
string<uuid>

Optional application (connection) ID to associate with the task

identity_id
string

Optional identity ID to use during task generation

input_schema
object[]

Input parameters the task accepts

output_schema
object[]

Output fields the task produces

output_file_only
boolean
default:false

Whether task runs should return only the bundled session downloads file

human_intervention
boolean
default:false

Allow human intervention during task execution

browser_session_id
string

Existing finished browser session id to generate the workflow from

task_browser_default_configuration
object

Optional default browser/session configuration when running this task

Response

Task generation started

id
string
required

The ID of the created task (use with generation-status and run endpoints)

status
enum<string>
required

Whether the task is still generating, ready to run, or failed

Available options:
generating
taskId
string

The ID of the task being generated

taskVersionId
string

The ID of the task version being generated

projectId
string

The ID of the underlying generation project