Tasks
CLI commands for 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 (backlog | next_week |
--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 (YYYY-MM-DD) | — |
--do-date-gte <value> | Filter by doDateGte (YYYY-MM-DD) | — |
--do-date-lte <value> | Filter by doDateLte (YYYY-MM-DD) | — |
--due-date-eq <value> | Filter by dueDateEq (YYYY-MM-DD) | — |
--due-date-gte <value> | Filter by dueDateGte (YYYY-MM-DD) | — |
--due-date-lte <value> | Filter by dueDateLte (YYYY-MM-DD) | — |
--do-end-date-eq <value> | Filter by doEndDateEq (YYYY-MM-DD) | — |
--do-end-date-gte <value> | Filter by doEndDateGte (YYYY-MM-DD) | — |
--do-end-date-lte <value> | Filter by doEndDateLte (YYYY-MM-DD) | — |
--scheduled-at-eq <value> | Filter by scheduledAtEq (epoch ms or ISO datetime) | — |
--scheduled-at-gte <value> | Filter by scheduledAtGte (epoch ms or ISO datetime) | — |
--scheduled-at-lte <value> | Filter by scheduledAtLte (epoch ms or ISO datetime) | — |
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 task by id
Arguments
| Name | Required | Description |
|---|---|---|
id | Yes | — |
Options
| Flag | Description | Default |
|---|---|---|
--include-links <value> | Set includeLinks (true | false) |
--linked-provider <value> | Set linkedProvider | unset |
--include-category <value> | Set includeCategory (true | false) |
--include-labels <value> | Set includeLabels (true | false) |
--include-related-tasks <value> | Set includeRelatedTasks (true | false) |
--include-notes <value> | Set includeNotes (true | false) |
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 task
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 | — |
--container-id <value> | containerId | — |
--bucket <value> | Bucket (backlog | next_week |
--routine-block-id <value> | routineBlockId | — |
--assignee-id <value> | assigneeId | — |
--is-starred <value> | isStarred (true | false) |
--do-date <value> | doDate (YYYY-MM-DD) | — |
--do-end-date <value> | doEndDate (YYYY-MM-DD) | — |
--due-date <value> | dueDate (YYYY-MM-DD) | — |
--scheduled-at <value> | scheduledAt (epoch ms or ISO datetime) | — |
--agent-integration-id <value> | agentIntegrationId | — |
--agent-dispatch-mode <value> | agentDispatchMode | — |
--parent-task-id <value> | parentTaskId | — |
--child-task-ids <value> | childTaskIds (comma-separated IDs) | — |
--blocking-task-ids <value> | blockingTaskIds (comma-separated IDs) | — |
--blocked-by-task-ids <value> | blockedByTaskIds (comma-separated IDs) | — |
--related-task-ids <value> | relatedTaskIds (comma-separated IDs) | — |
--label-id <value> | Label id to add (repeatable) (default: []) | — |
--label <name> | Label name to resolve or create and add (repeatable) (default: []) | — |
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 task
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 (backlog | next_week |
--inbox-triage <value> | inboxTriage | — |
--routine-block-id <value> | routineBlockId | — |
--assignee-id <value> | assigneeId | — |
--is-starred <value> | isStarred (true | false) |
--do-date <value> | doDate (YYYY-MM-DD) | — |
--do-end-date <value> | doEndDate (YYYY-MM-DD) | — |
--due-date <value> | dueDate (YYYY-MM-DD) | — |
--scheduled-at <value> | scheduledAt (epoch ms or ISO datetime) | — |
--agent-integration-id <value> | agentIntegrationId | — |
--agent-dispatch-mode <value> | agentDispatchMode | — |
--parent-task-id <value> | parentTaskId | — |
--child-task-ids <value> | childTaskIds (comma-separated IDs) | — |
--blocking-task-ids <value> | blockingTaskIds (comma-separated IDs) | — |
--blocked-by-task-ids <value> | blockedByTaskIds (comma-separated IDs) | — |
--related-task-ids <value> | relatedTaskIds (comma-separated IDs) | — |
--label-id <value> | Label id to add (repeatable) (default: []) | — |
--label <name> | Label name to resolve or create and add (repeatable) (default: []) | — |
--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 task
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 labelsExample 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
}
}tasks move
monoid tasks move [options] <id>
Move or schedule a task with one command
Arguments
| Name | Required | Description |
|---|---|---|
id | Yes | — |
Options
| Flag | Description | Default |
|---|---|---|
--do-date <YYYY-MM-DD> | Set task doDate | — |
--routine-block-id <id> | Set dated routine block id | — |
--assignee-id <id> | Set assignee id | — |
--bucket <bucket> | Set bucket | — |
Example
monoid tasks move [options] <id>Example output
{
"data": {
"ok": true
}
}tasks upsert
monoid tasks upsert [options]
Create a task unless an exact title match already exists in scope
Options
| Flag | Description | Default |
|---|---|---|
--title <title> | Task title | — |
--notes <notes> | Task notes | — |
--project-id <id> | Project id | — |
--container-id <id> | Container id | — |
--category-id <id> | Category id | — |
--label-id <id> | Label id to add (repeatable) (default: []) | — |
--label <name> | Label name to resolve or create and add (repeatable) (default: []) | — |
--assignee-id <id> | Assignee id | — |
--do-date <YYYY-MM-DD> | Task doDate | — |
--routine-block-id <id> | Dated routine block id | — |
--bucket <bucket> | Task bucket (default: "todo") | — |
Example
monoid tasks upsert [options]Example output
{
"data": {
"ok": true
}
}Related API
See Tasks API reference for HTTP endpoint details.
© 2025 MONOid
All rights reserved.
All rights reserved.