---
title: "List tasks"
method: GET
path: "/tasks"
tags: ["Tasks"]
---

# List tasks

`GET /tasks`

## Request

- Base URL: `https://app.italic.com/api/v2`
- URL: `https://app.italic.com/api/v2/tasks`
- Auth: HTTP bearer

Required permission: agent:chat or actions:review. What waits in Tasks in the apps, newest first: runs with drafts to approve or discard, and workflow questions. With agent:chat, chat runs; with actions:review, workflow runs.

## Response `200`

Success. Writes without read permission return an ID and revision only.

- RunList
  - `runs` Run[], required
    - `id` string, required
    - `source` 'chat' | 'recording', required: `recording`: a workflow run a recording started.
    - `recordingId` string
    - `status` 'running' | 'awaiting_approval' | 'completed' | 'failed' | 'cancelled', required
    - `reply` string: Italic's answer, in Markdown.
    - `error` string
    - `prompt` string: Chat runs: what was asked.
    - `workflows` object[]
      - `id` string, required
      - `name` string, required
    - `actions` RunAction[], required
      - `id` string, required
      - `tool` string, required: What the draft does: send_email, create_event, create_reminder, trash_email, send_webhook, create_notion_page, send_slack_message, save_to_drive, mcp_call and others.
      - `status` 'proposed' | 'approved' | 'executing' | 'succeeded' | 'failed' | 'rejected' | 'uncertain', required: `proposed`: waiting for approval. `approved`: an iPhone adds it (reminders). `uncertain`: it may or may not have happened.
      - `executor` 'cloud' | 'device', required
      - `args` object, required: The draft's fields, as the apps' card shows them.
      - `result` object
      - `link` string: Opens what a finished action made, such as the sent email.
      - `workflowId` string
    - `questions` Question[], required
      - `id` string, required
      - `prompt` string, required
      - `about` string
      - `kind` 'recipient' | 'account' | 'text', required
      - `choices` object[], required
        - `label` string, required
        - `detail` string
    - `createdAt` integer, required
    - `updatedAt` integer, required

## Other responses

- `default`: Request failed. Errors include a stable code and a readable message.

---

[API](https://skmtc.dev/italic/apis/italic-api.md) - [All operations](https://skmtc.dev/italic/apis/italic-api/llms.txt) - [OpenAPI document](https://skmtc.dev/italic/apis/italic-api/revisions/2fbe2cf16fe3?raw)