Tasks
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
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
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
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.
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
elnora tasks get [required options] [options]| Parameter | Type | Required | Description |
|---|---|---|---|
taskId | uuid | yes | Task ID |
elnora tasks list
List tasks, optionally filtered by project or lifecycle status
Read-only
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 | Project ID to filter by |
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
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.
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
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
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 |