---
title: "List organization conversations"
method: GET
path: "/v1/organization/conversations"
tags: ["Replica"]
---

# List organization conversations

`GET /v1/organization/conversations`

## Request

- Base URL: `https://api.replicas.dev`
- URL: `https://api.replicas.dev/v1/organization/conversations`
- Auth: HTTP bearer

Exports retained conversations from every replica without waking them. Requires an organization API key. Deleted chats and conversations outside your [data retention](/admin/data-retention) window are omitted.

## Query parameters

- `cursor` string
- `limit` integer
- `workspace_id` string, uuid
- `environment_id` string, uuid

## Headers

- `X-Replicas-Api-Version` '2026-10-07'

## Response `200`

Successful response

- ListOrganizationConversationsResponse
  - `conversations` OrganizationConversation[], required
    - `chat_id` string, uuid, required
    - `workspace_id` string, uuid, required
    - `workspace_name` string, required
    - `workspace_status` 'active' | 'sleeping' | 'archived' | 'preparing' | 'error', required
    - `workspace_source` 'api' | 'dashboard' | 'slack' | 'linear' | 'github' | 'gitlab' | 'automation', required
    - `workspace_created_at` string, date-time, required
    - `workspace_user_id` string, uuid, nullable, required
    - `workspace_creator_email` string, email, nullable, required
    - `environment_id` string, uuid, nullable, required
    - `provider` 'claude' | 'codex' | 'cursor' | 'muse' | 'opencode' | 'pi' | 'null', nullable, required
    - `title` string, nullable, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `parent_chat_id` string, uuid, nullable, required
    - `senders` ChatMessageSender[], required
      - `message_id` string: Identifier of the user message associated with this sender.
      - `sender_user_id` string, required: Identifier of the user who sent the message.
      - `sender_email` string, required: Email of the user who sent the message.
      - `recorded_at` string, date-time, required: When the sender was recorded by the engine.
  - `total` integer, required: Matching conversations in non-deleted workspaces at request time. Restart the export if chats or workspaces are deleted or restored while paging.
  - `limit` integer, required
  - `next_cursor` string, nullable, required

## Other responses

- `400`: Bad request - Missing or invalid parameters
- `401`: Unauthorized - Invalid or missing API key
- `403`: Forbidden - The authenticated account cannot access this resource
- `500`: Internal server error

---

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