---
title: "List agent conversations"
method: POST
path: "/listConversations"
tags: ["Agent"]
---

# List agent conversations

`POST /listConversations`

## Request

- Base URL: `https://www.taskade.com/api/v2`
- URL: `https://www.taskade.com/api/v2/listConversations`
- Auth: OAuth 2 and HTTP bearer
  - Authorization code: `https://www.taskade.com/oauth2/authorize`
  - Token URL: `https://www.taskade.com/oauth2/token`

## Request body

- object
  - `agentId` string, required
  - `limit` number
  - `page` number

## Response `200`

Default response

- object
  - `ok` true, required
  - `items` Convo[], required
    - `id` string, required
    - `space_agent_id` string, required
    - `status` 'in_progress' | 'idle' | 'requires_review', required
    - `title` string
    - `data` object, required
      - `llm` union
        - object
          - `type` 'openai', required
          - `name` 'gpt-3.5-turbo' | 'gpt-4o' | 'gpt-4-turbo' | 'gpt-4o-mini' | 'gpt-4.1' | 'gpt-4.1-mini' | 'gpt-4.1-nano' | 'o3-mini:low' | 'o3-mini:medium' | 'o3-mini:high' | 'o4-mini:low' | 'o4-mini:medium' | 'o4-mini:high' | 'openai/gpt-4o' | 'openai/gpt-4o-mini' | 'openai/gpt-4.1' | 'openai/gpt-4.1-mini' | 'openai/gpt-4.1-nano' | 'openai/gpt-5' | 'openai/gpt-5:high' | 'openai/gpt-5-mini' | 'openai/gpt-5-mini:high' | 'openai/gpt-5-nano' | 'openai/gpt-5-nano:high' | 'openai/gpt-5.1' | 'openai/gpt-5.1:low' | 'openai/gpt-5.1:medium' | 'openai/gpt-5.1:high' | 'openai/gpt-5.1-codex' | 'openai/gpt-5.1-codex:low' | 'openai/gpt-5.1-codex:medium' | 'openai/gpt-5.1-codex:high' | 'openai/gpt-5.1-codex-max' | 'openai/gpt-5.1-codex-max:medium' | 'openai/gpt-5.1-codex-max:high' | 'openai/gpt-5.1-codex-max:xhigh' | 'openai/gpt-5.2' | 'openai/gpt-5.2:medium' | 'openai/gpt-5.2:high' | 'openai/gpt-5.2:xhigh' | 'openai/gpt-5.2-codex' | 'openai/gpt-5.2-codex:medium' | 'openai/gpt-5.2-codex:high' | 'openai/gpt-5.2-codex:xhigh' | 'openai/gpt-5.3-codex' | 'openai/gpt-5.3-codex:medium' | 'openai/gpt-5.3-codex:high' | 'openai/gpt-5.3-codex:xhigh' | 'openai/gpt-5.3-chat' | 'openai/gpt-5.4' | 'openai/gpt-5.4:medium' | 'openai/gpt-5.4:high' | 'openai/gpt-5.4:xhigh' | 'openai/gpt-5.4-pro' | 'openai/gpt-5.4-pro:medium' | 'openai/gpt-5.4-pro:high' | 'openai/gpt-5.4-pro:xhigh' | 'openai/gpt-5.4-mini' | 'openai/gpt-5.4-nano' | 'openai/gpt-5.5' | 'openai/gpt-5.5:medium' | 'openai/gpt-5.5:high' | 'openai/gpt-5.5:xhigh' | 'openai/gpt-5.5-pro' | 'openai/gpt-5.5-pro:medium' | 'openai/gpt-5.5-pro:high' | 'openai/gpt-5.5-pro:xhigh' | 'openai/gpt-5.6-luna' | 'openai/gpt-5.6-luna:high' | 'openai/gpt-5.6-sol' | 'openai/gpt-5.6-sol:high' | 'openai/gpt-5.6-terra' | 'openai/gpt-5.6-terra:high' | 'openai/gpt-6-luna' | 'openai/gpt-6-luna:low' | 'openai/gpt-6-luna:high' | 'openai/gpt-6-luna:xhigh' | 'openai/gpt-6-sol' | 'openai/gpt-6-sol:high' | 'openai/gpt-6.1-sol' | 'openai/gpt-6.1-sol:high' | 'openai/gpt-6.1-sol:xhigh' | 'openai/gpt-6.1-terra', required
        - object
          - `type` 'anthropic', required
          - `name` 'anthropic/claude-4.0-sonnet' | 'anthropic/claude-4.0-opus' | 'anthropic/claude-sonnet-4.5' | 'anthropic/claude-sonnet-4.5:thinking' | 'anthropic/claude-haiku-4.5' | 'anthropic/claude-haiku-4.5:thinking' | 'anthropic/claude-opus-4.5' | 'anthropic/claude-opus-4.5:thinking' | 'anthropic/claude-opus-4.8' | 'anthropic/claude-opus-4.8:thinking' | 'anthropic/claude-fable-5' | 'anthropic/claude-fable-5:thinking' | 'anthropic/claude-opus-4.7' | 'anthropic/claude-opus-4.7:thinking' | 'anthropic/claude-opus-4.6' | 'anthropic/claude-opus-4.6:thinking' | 'anthropic/claude-opus-5' | 'anthropic/claude-opus-5:thinking' | 'anthropic/claude-opus-5.5' | 'anthropic/claude-opus-5.5:thinking' | 'anthropic/claude-sonnet-5' | 'anthropic/claude-sonnet-5:thinking' | 'anthropic/claude-sonnet-5.5' | 'anthropic/claude-sonnet-5.5:thinking' | 'anthropic/claude-sonnet-4.6' | 'anthropic/claude-sonnet-4.6:thinking' | 'anthropic/claude-3.5-sonnet' | 'anthropic/claude-3.5-haiku' | 'anthropic/claude-3.7-sonnet', required
        - object
          - `type` 'google', required
          - `name` 'google/gemini-2.5-pro' | 'google/gemini-2.5-flash' | 'google/gemini-2.5-flash-lite' | 'google/gemini-3-pro-preview' | 'google/gemini-3-flash-preview' | 'google/gemini-3-flash' | 'google/gemini-3.1-pro-preview' | 'google/gemini-3.1-flash-lite-preview' | 'google/gemini-3.1-flash-lite' | 'google/gemini-3.5-flash' | 'google/gemini-3.6-flash' | 'google/gemini-3.7-flash' | 'google/gemma-4-31b-it' | 'google/gemma-4-26b-a4b-it', required
        - object
          - `type` 'alibaba', required
          - `name` 'alibaba/qwen3.7-plus' | 'alibaba/qwen3.6-plus' | 'alibaba/qwen3.6-27b' | 'alibaba/qwen-3.6-max-preview' | 'alibaba/qwen3.7-max', required
        - object
          - `type` 'minimax', required
          - `name` 'minimax/minimax-m3' | 'minimax/minimax-m2.7', required
        - object
          - `type` 'zai', required
          - `name` 'zai/glm-5.1' | 'zai/glm-5.2' | 'zai/glm-5.3', required
        - object
          - `type` 'moonshotai', required
          - `name` 'moonshotai/kimi-k2.6' | 'moonshotai/kimi-k2.7-code' | 'moonshotai/kimi-k3', required
        - object
          - `type` 'deepseek', required
          - `name` 'deepseek/deepseek-v4-pro' | 'deepseek/deepseek-v4-flash' | 'deepseek/deepseek-v4.1-flash' | 'deepseek/deepseek-v4.1-flash-1017' | 'deepseek/deepseek-v4-pro-0813' | 'deepseek/deepseek-v4-pro:high' | 'deepseek/deepseek-v4-pro:max' | 'deepseek/deepseek-v4-flash:max', required
        - object
          - `type` 'xai', required
          - `name` 'xai/grok-4.3' | 'xai/grok-4.5' | 'xai/grok-4.6' | 'xai/grok-build-0.1' | 'xai/grok-4.7', required
        - object
          - `type` 'xiaomi', required
          - `name` 'xiaomi/mimo-v2.5' | 'xiaomi/mimo-v2.5-pro', required
        - object
          - `type` 'nvidia', required
          - `name` 'nvidia/nemotron-3-ultra-550b-a55b' | 'nvidia/nemotron-3-super-120b-a12b', required
        - object
          - `type` 'typesafe-ai', required
          - `name` 'typesafe-ai/jev', required
      - `endedAt` number

---

[API](https://skmtc.dev/taskade/apis/taskade-public-api-v2.md) - [All operations](https://skmtc.dev/taskade/apis/taskade-public-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/taskade/apis/taskade-public-api-v2/revisions/45f0e74ec083?raw)