Skip to main content
POST
Create task

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
name
string
required
objective
string
required
execution_type
enum<string>
required
Available options:
single,
scheduled
urls
string<uri>[]
output_schema
object
schedule
string

Cron expression. Required when execution_type is scheduled.

Example:

"0 6 * * 1"

platform_url
string
keywords
string
tags
string[]
proxy_locations
string[]
template_id
string<uuid>
template_slug
string
script_id
string
script_version
string
owner_required
boolean
default:false

Route every execution of this task to a worker node owned by the same user. Titan skips shared IP, subnet, and domain rate-limit controls for owner-pinned executions.

action_type
enum<string>
Available options:
search,
crawl,
scrape,
api_call
input_source
enum<string>
Available options:
static_urls,
previous_step,
task_url_inventory
limits
object
payload
any
secret_payload
any
retry_policy
object
execution_plan
object

Response

Created

success
boolean
data
any