API ReferenceMY Tasks

Create a new task

Creates a new task owned by the authenticated user.

The task will be assigned to the specified agent. If no agent_id is provided, the task will be assigned to the ‘Executive Assistant’ agent (if one exists in your organization).

All tasks start with a status of ‘new’ and can include custom metadata for additional context.

Authentication

X-API-Keystring
Enter your API key for programmatic access
OR
AuthorizationBearer

Enter your JWT token (without the ‘Bearer ’ prefix)

Request

Task params
taskobjectRequired
Request to create a task

Response

Task Created
creator_idstringformat: "uuid"

ID of the creator (user or agent) who created this task. This is a polymorphic field that can reference either a user UUID or an agent UUID.

descriptionstring
Brief description of the task
idstringformat: "uuid"
Unique task identifier
statusenum
Current status of the task
inserted_atstring or nullformat: "date-time"
Timestamp when the task was created
metadataobject or null

Additional task metadata (custom key-value pairs)

summarystring or null
Longer summary with additional details
updated_atstring or nullformat: "date-time"
Timestamp when the task was last updated

Errors