# geni crm tasks (/cli/crm/tasks)



CRM to-dos, optionally linked to a record. With no verb, `geni crm tasks` lists open tasks; the verb subcommands get one, create, update, resolve (done / dismiss / reopen), and delete.

## list (default) [#list-default]

```sh
geni crm tasks --mine
```

List tasks, open by default. Narrow to your own with `--mine`, or include resolved ones with `--include-closed`.

| Flag               | Notes                             |
| ------------------ | --------------------------------- |
| `--mine`           | Only tasks assigned to you.       |
| `--include-closed` | Include done and dismissed tasks. |
| `--json`           | Machine-readable output.          |

## get [#get]

```sh
geni crm tasks get tsk_01HX --field dueAt
```

Print one task's full record. `--field <path>` extracts a single dotted-path value.

| Arg / Flag       | Notes                                                 |
| ---------------- | ----------------------------------------------------- |
| `<id>`           | Task id.                                              |
| `--field <path>` | Print one dotted-path value (e.g. `status`, `dueAt`). |

## create [#create]

```sh
geni crm tasks create --json '{"title":"Follow up with Ada","dueAt":"2026-07-01","priority":"high","entity":{"type":"person","id":"per_01HX"}}'
```

Create a task. `--json` is `{ title, description?, dueAt?, priority?, ownerMembershipId?, entity?: { type, id } }`.

| Flag            | Notes                           |
| --------------- | ------------------------------- |
| `--json <body>` | Required. JSON task definition. |

## update [#update]

```sh
geni crm tasks update tsk_01HX --json '{"priority":"medium","dueAt":"2026-07-15"}'
```

Update a task. `--json` is `{ title?, description?, dueAt?, priority?, ownerMembershipId? }`.

| Arg / Flag      | Notes                            |
| --------------- | -------------------------------- |
| `<id>`          | Task id.                         |
| `--json <body>` | Required. JSON fields to change. |

## done [#done]

```sh
geni crm tasks done tsk_01HX
```

Mark a task done.

| Arg    | Notes    |
| ------ | -------- |
| `<id>` | Task id. |

## dismiss [#dismiss]

```sh
geni crm tasks dismiss tsk_01HX
```

Dismiss a task (no longer needs doing).

| Arg    | Notes    |
| ------ | -------- |
| `<id>` | Task id. |

## reopen [#reopen]

```sh
geni crm tasks reopen tsk_01HX
```

Reopen a done or dismissed task.

| Arg    | Notes    |
| ------ | -------- |
| `<id>` | Task id. |

## delete [#delete]

```sh
geni crm tasks delete tsk_01HX
```

Delete a task.

| Arg    | Notes    |
| ------ | -------- |
| `<id>` | Task id. |
