---
title: "Task List"
method: GET
path: "/api/v1/tasks"
tags: ["tasks"]
---

# Task List

`GET /api/v1/tasks`

## Request

- The document declares no server URL.
- Auth: none declared

Accepted requests, newest first; ``session_id`` / ``status`` narrow it.

Drain a session before exiting by polling with ``status=queued`` and
``status=processing`` until both ``total`` are 0. ``page_size`` is capped
at 100.

## Query parameters

- `session_id` string, nullable
- `status` string, nullable
- `page` integer
- `page_size` integer
- `app_id` string
- `project_id` string

## Response `200`

Successful Response

- SuccessEnvelopeTaskPage
  - `request_id` string, required
  - `data` TaskPage, required: ``GET /tasks`` -- one page of :class:`TaskItem`, newest first.
    - `total` integer, required
    - `page` integer, required
    - `page_size` integer, required
    - `items` TaskItem[], required
      - `id` string, required
      - `status` 'queued' | 'processing' | 'success' | 'failed', required
      - `task_type` 'memory_add' | 'memory_flush', required
      - `error` string, nullable
      - `error_code` string, nullable
      - `created_at` string, date-time, required
      - `finished_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-20** `6beb324a48dd`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/evermind-ai/apis/everos/changes/api/v1/tasks/get.md)

---

[API](https://skmtc.dev/evermind-ai/apis/everos.md) - [All operations](https://skmtc.dev/evermind-ai/apis/everos/llms.txt) - [OpenAPI document](https://skmtc.dev/evermind-ai/apis/everos/revisions/8f6c6973c7e6?raw)