# Tasks

Source: https://docs.elnora.ai/docs/cli/tasks
Last modified: 2026-09-08T22:34:42-06:00

> Drive the Elnora agent — create tasks and exchange messages.

Drive the Elnora agent — create tasks and exchange messages.

## elnora tasks archive

Archive (delete) a task

*Destructive*

```bash
elnora tasks archive [required options] [options]
```

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `taskId` | uuid | yes | Task ID to archive |

## elnora tasks attachmentContent

Get the content of a task attachment

*Read-only*

```bash
elnora tasks attachmentContent [required options] [options]
```

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `attachmentId` | uuid | yes | Attachment ID |
| `taskId` | uuid | yes | Task ID |

## elnora tasks attachments

List the files attached to a task

*Read-only*

```bash
elnora tasks attachments [required options] [options]
```

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `taskId` | uuid | yes | Task ID |

## elnora tasks create

Create a new task in a project. If a message is provided it is queued, but the AI response is NOT returned — the agent processes asynchronously. Poll elnora_tasks_messages every 5-10s until the last message has role 'assistant' with metadata.status 'completed'. Timeout after 5 min.

```bash
elnora tasks create [options]
```

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `message` | string | no | Initial message |
| `project` | uuid | no | Project ID (optional; defaults to your workspace) |
| `stream` | boolean | no | Stream agent response in real-time (SSE) Default: `false`. |
| `title` | string | no | Task title |
| `wait` | boolean | no | Wait for agent response (polling) Default: `false`. |

## elnora tasks get

Get details of a specific task

*Read-only*

```bash
elnora tasks get [required options] [options]
```

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `taskId` | uuid | yes | Task ID |

## elnora tasks list

List tasks, optionally filtered by lifecycle status. (The legacy `project` filter is deprecated and no longer supported.)

*Read-only*

```bash
elnora tasks list [options]
```

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `page` | integer | no | Page number Default: `1`. |
| `pageSize` | integer | no | Results per page Default: `25`. |
| `project` | uuid | no | [DEPRECATED] Legacy project filter; projects were removed and this option is a no-op. |
| `status` | enum | no | Lifecycle filter: active (default), archived, or all One of: `active`, `archived`, `all`. |

## elnora tasks messages

List messages for a task

*Read-only*

```bash
elnora tasks messages [required options] [options]
```

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `cursor` | string | no | Pagination cursor |
| `limit` | integer | no | Results per page Default: `50`. |
| `taskId` | uuid | yes | Task ID |

## elnora tasks send

Send a message to a task. Returns the created user message immediately — the agent processes asynchronously. To get the AI response, poll elnora_tasks_messages until the last message has role 'assistant' with metadata.status 'completed'. Poll every 5-10s, timeout after 5 min.

```bash
elnora tasks send [required options] [options]
```

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `fileRefs` | string | no | Comma-separated file reference UUIDs |
| `message` | string | yes | Message content |
| `stream` | boolean | no | Stream agent response in real-time (SSE) Default: `false`. |
| `taskId` | uuid | yes | Task ID |
| `wait` | boolean | no | Wait for agent response (polling) Default: `false`. |

## elnora tasks unarchive

Unarchive a task so it reappears in the default task list

*Idempotent*

```bash
elnora tasks unarchive [required options] [options]
```

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `taskId` | uuid | yes | Task ID to unarchive |

## elnora tasks update

Update an existing task

*Idempotent*

```bash
elnora tasks update [required options] [options]
```

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `status` | string | no | New task status |
| `taskId` | uuid | yes | Task ID |
| `title` | string | no | New task title |