Tasks

tasks list

monoid tasks list [options]

List tasks

Options

Flag	Description	Default
`--limit <n>`	Max results	—
`--offset <n>`	Skip n results	—
`--bucket <value>`	Filter by bucket	—
`--inbox-triage <value>`	Filter by inboxTriage	—
`--project-id <value>`	Filter by projectId	—
`--category-id <value>`	Filter by categoryId	—
`--container-id <value>`	Filter by containerId	—
`--organisation-id <value>`	Filter by organisationId	—
`--assignee-id <value>`	Filter by assigneeId	—
`--routine-block-id <value>`	Filter by routineBlockId	—
`--do-date-eq <value>`	Filter by doDateEq	—
`--do-date-gte <value>`	Filter by doDateGte	—
`--do-date-lte <value>`	Filter by doDateLte	—
`--due-date-eq <value>`	Filter by dueDateEq	—
`--due-date-gte <value>`	Filter by dueDateGte	—
`--due-date-lte <value>`	Filter by dueDateLte	—
`--do-end-date-eq <value>`	Filter by doEndDateEq	—
`--do-end-date-gte <value>`	Filter by doEndDateGte	—
`--do-end-date-lte <value>`	Filter by doEndDateLte	—
`--scheduled-at-eq <value>`	Filter by scheduledAtEq	—
`--scheduled-at-gte <value>`	Filter by scheduledAtGte	—
`--scheduled-at-lte <value>`	Filter by scheduledAtLte	—

Example

monoid tasks list [options]

Example output

{
  "data": [
    {
      "_id": "task_123",
      "title": "Draft LinkedIn post",
      "bucket": "todo",
      "inboxTriage": "this_week",
      "projectId": "project_123",
      "categoryId": "category_123",
      "assigneeId": "user_abc123",
      "doDate": "2026-04-13",
      "dueDate": "2026-04-14",
      "updatedAt": 1760000000000
    }
  ]
}

tasks get

monoid tasks get [options] <id>

Get one tasks by id

Arguments

Name	Required	Description
`id`	Yes	—

Options

Flag	Description	Default
`--include-links <value>`	Include/filter by includeLinks	`false`
`--linked-provider <value>`	Include/filter by linkedProvider	unset
`--include-category <value>`	Include/filter by includeCategory	`false`
`--include-labels <value>`	Include/filter by includeLabels	`false`
`--include-related-tasks <value>`	Include/filter by includeRelatedTasks	`false`
`--include-notes <value>`	Include/filter by includeNotes	`true`

Example

monoid tasks get [options] <id>

Notes are included by default. Use --include-notes false to omit them.

Example output

{
  "data": {
    "_id": "task_123",
    "title": "Draft LinkedIn post",
    "notes": "Post draft with launch CTA and customer proof point.",
    "bucket": "todo",
    "inboxTriage": "this_week",
    "projectId": "project_123",
    "categoryId": "category_123",
    "assigneeId": "user_abc123",
    "doDate": "2026-04-13",
    "dueDate": "2026-04-14",
    "updatedAt": 1760000000000
  }
}

tasks create

monoid tasks create [options]

Create tasks

Options

Flag	Description	Default
`--body <json>`	Request body JSON (merged with flags)	—
`--title <value>`	title	—
`--notes <value>`	notes	—
`--done-at <value>`	doneAt	—
`--project-id <value>`	projectId	—
`--category-id <value>`	categoryId	—
`--bucket <value>`	bucket	—
`--inbox-triage <value>`	inboxTriage	—
`--routine-block-id <value>`	routineBlockId	—
`--assignee-id <value>`	assigneeId	—
`--is-starred <value>`	isStarred	—
`--do-date <value>`	doDate	—
`--do-end-date <value>`	doEndDate	—
`--due-date <value>`	dueDate	—
`--scheduled-at <value>`	scheduledAt	—
`--agent-integration-id <value>`	agentIntegrationId	—
`--agent-dispatch-mode <value>`	agentDispatchMode	—
`--if-not-exists`	Return existing if match found	—

Example

monoid tasks create [options]

Example output

{
  "data": {
    "_id": "task_123",
    "title": "Draft LinkedIn post",
    "notes": "Post draft with launch CTA and customer proof point.",
    "bucket": "todo",
    "inboxTriage": "this_week",
    "projectId": "project_123",
    "categoryId": "category_123",
    "assigneeId": "user_abc123",
    "doDate": "2026-04-13",
    "dueDate": "2026-04-14",
    "updatedAt": 1760000000000
  }
}

tasks update

monoid tasks update [options] <id>

Update tasks

Arguments

Name	Required	Description
`id`	Yes	—

Options

Flag	Description	Default
`--body <json>`	Request body JSON (merged with flags)	—
`--ids <ids>`	Comma-separated IDs for bulk update (max 25)	—
`--title <value>`	title	—
`--notes <value>`	notes	—
`--done-at <value>`	doneAt	—
`--project-id <value>`	projectId	—
`--category-id <value>`	categoryId	—
`--container-id <value>`	containerId	—
`--bucket <value>`	bucket	—
`--inbox-triage <value>`	inboxTriage	—
`--routine-block-id <value>`	routineBlockId	—
`--assignee-id <value>`	assigneeId	—
`--is-starred <value>`	isStarred	—
`--do-date <value>`	doDate	—
`--do-end-date <value>`	doEndDate	—
`--due-date <value>`	dueDate	—
`--scheduled-at <value>`	scheduledAt	—
`--agent-integration-id <value>`	agentIntegrationId	—
`--agent-dispatch-mode <value>`	agentDispatchMode	—
`--clear-agent-integration`	Clear agentIntegrationId (set to null)	—
`--clear-agent-dispatch-mode`	Clear agentDispatchMode (set to null)	—
`--clear-scheduled-at`	Clear scheduledAt (set to null)	—
`--clear-routine-block`	Clear routineBlockId (set to null)	—

Example

monoid tasks update [options] <id>

Example output

{
  "data": {
    "_id": "task_123",
    "title": "Draft LinkedIn post",
    "notes": "Post draft with launch CTA and customer proof point.",
    "bucket": "todo",
    "inboxTriage": "this_week",
    "projectId": "project_123",
    "categoryId": "category_123",
    "assigneeId": "user_abc123",
    "doDate": "2026-04-13",
    "dueDate": "2026-04-14",
    "updatedAt": 1760000000000
  }
}

tasks delete

monoid tasks delete [options] <id>

Delete tasks

Arguments

Name	Required	Description
`id`	Yes	—

Options

Flag	Description	Default
`--ids <ids>`	Comma-separated IDs for bulk delete (max 25)	—

Example

monoid tasks delete [options] <id>

Example output

{
  "data": null,
  "deleted": true
}

tasks labels

monoid tasks labels

Manage task labels

Example

monoid tasks labels

Example output

{
  "data": {
    "ok": true
  }
}

tasks add

monoid tasks labels add [options] <taskId>

—

Arguments

Name	Required	Description
`taskId`	Yes	—

Options

Flag	Description	Default
`--label-id <labelId>`	Label id	—

Example

monoid tasks labels add [options] <taskId>

Example output

{
  "data": {
    "ok": true
  }
}

tasks remove

monoid tasks labels remove [options] <taskId>

—

Arguments

Name	Required	Description
`taskId`	Yes	—

Options

Flag	Description	Default
`--label-id <labelId>`	Label id	—

Example

monoid tasks labels remove [options] <taskId>

Example output

{
  "data": {
    "ok": true
  }
}

See Tasks API reference for HTTP endpoint details.

App Integrations

Tasks