Skip to main content
POST
cURL

Body

application/json

Task to create

title
string
required

Descriptive title of the task

Example:

"Weekly Genre Pulse Check"

prompt
string
required

Instruction/prompt executed by the task

Example:

"Execute this weekly genre analysis workflow and email a summary to the team."

schedule
string
required

Cron expression defining when the task runs (e.g., '0 9 * * 4' for Thursdays at 9 AM)

Example:

"0 9 * * 4"

artist_account_id
string<uuid>
required

UUID of the associated artist account

Example:

"1873859c-dd37-4e9a-9bac-80d35a1b2c3d"

timezone
string
default:UTC

Optional IANA time zone (e.g. America/New_York) the cron schedule is interpreted in, DST-aware. Defaults to UTC. Applied to the Trigger.dev schedule (the source of truth); not stored separately.

Example:

"America/New_York"

account_id
string<uuid>

UUID of the account to create the task for. Only applicable when the authenticated account has access to multiple accounts via organization membership. If not provided, the task is created for the API key's own account.

Example:

"848cd58d-700f-4b38-ab4c-d9f52a1b2c3d"

Response

Task created successfully

status
enum<string>
required

Status of the request

Available options:
success,
error
tasks
object[]
required

Array of task objects

error
string

Error message (only present if status is error)