Skip to main content
POST
Create a task
In the Heliyos MCP server: heliyos_tasks_create.

Authorizations

Authorization
string
header
required

A workspace API key, sent as Authorization: Bearer heliyos_.... Create one in Heliyos under Settings → API keys. A key acts as a workspace admin in the one workspace it was created in.

Body

application/json
title
string
required

The task's title. Required, but may be an empty string.

Example:

"Send security questionnaire to Northwind Traders"

description
string

The body, as plain text or markdown. May be empty.

status
enum<string>

The stage. Defaults to backlog. Setting it does not change isFinished.

Available options:
backlog,
in_progress,
scheduled_for_later,
on_hold,
cancelled,
completed
priority
enum<string>

The priority. Defaults to medium. Any other value is rejected with a 400.

Available options:
none,
low,
medium,
high,
urgent
dueDate
string<date-time>

When the task is due, as an ISO 8601 date or date-time.

Example:

"2026-11-07T17:00:00.000Z"

isFinished
boolean

The done flag. Defaults to false. Send true together with status completed.

assignedUser
object[]

People to assign. Each id must be a member of the workspace (you can always assign yourself); name and profilePicture are stored as sent for display.

assignedAgents
object[]

Workers to assign. Each agentId is required and must be one of the workspace's workers.

relationships
object[]

Records (or tasks, notes, interactions) to link the task to. At most 200, each in this workspace.

Response

The created task as stored: its id is in id (not _id), relationships are not hydrated, and there is no currentRun yet.

meta
object
required
data
object
required