---
title: "List all conversations for an agent (formerly known as project)."
method: GET
path: "/api/v1/projects/{projectId}/conversations"
tags: ["Conversations"]
---

# List all conversations for an agent (formerly known as project).

`GET /api/v1/projects/{projectId}/conversations`

Retrieve all conversations associated with an agent based on its unique projectId. This endpoint allows you to fetch a collection of conversations related to a specific agent.

## Path parameters

- `projectId` integer, required

## Query parameters

- `page` integer
- `order` 'asc' | 'desc'
- `orderBy` 'id' | 'created_at'
- `userFilter` 'all' | 'anonymous' | 'team_member' | 'me'
- `name` string

## Response `200`

List of conversations for an agent

- object
  - `status` 'error' | 'success' — The status of the response
  - `data` object
    - `current_page` integer — The current page number
    - `data` Conversation[]
      - `created_at` string, date-time — When was this conversation created?
      - `updated_at` string, date-time — When was this conversation updated?
      - `deleted_at` string, date-time — When was this conversation deleted?
      - `id` integer — Conversation ID
      - `name` string — Conversation name
      - `project_id` string — Agent ID for this conversation
      - `created_by` string — User ID for the user who created this conversation
      - `session_id` string, uuid — Session ID for this conversation
    - `first_page_url` string — The first page url
    - `from` integer — The first item number of the current page
    - `last_page` integer — The last page number
    - `last_page_url` string — The last page url
    - `next_page_url` string — The next page url
    - `path` string — The current page url
    - `per_page` integer — The number of items per page
    - `prev_page_url` string — The previous page url
    - `to` integer — The last item number of the current page
    - `total` integer — The total number of items

## Other responses

- `400` — Bad Argument
- `401` — API Token is either missing or invalid
- `404` — Agent not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/poll-the-people/apis/customgpt-ai.md) · [All operations](https://skmtc.net/poll-the-people/apis/customgpt-ai/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/poll-the-people/customgpt-ai/revisions/b80e6dfcf78d/schema)