> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryreplicas.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Organization Conversations

> Returns persisted conversations across every non-deleted workspace in the organization without waking workspaces. Requires an organization API key or an organization-admin session. Deleted chats, conversations not retained under the organization's data-retention settings, and older workspaces whose engine predates transcript persistence are omitted. Chat and workspace deletion take effect immediately; restart an in-progress export after chats or workspaces are deleted or restored to obtain a consistent total.



## OpenAPI

````yaml /openapi.json get /v1/organization/conversations
openapi: 3.1.0
info:
  title: Replica API
  version: 2.0.0
  description: >-
    The Replica API allows you to programmatically manage cloud workspaces for
    AI agents. Use this API to manage environments (the org-scoped primitive
    workspaces are created from — including variables, files, skills, MCPs, warm
    hooks, start hooks, and warm pools), create and manage replicas, send
    messages, manage chats, stream events, read connected repositories and
    repository sets, and configure automations.
servers:
  - url: https://api.tryreplicas.com
    description: Production API
security:
  - apiKey: []
tags:
  - name: Environments
    description: >-
      Manage environments — the primitive that workspaces are created from.
      Variables, files, skills, MCPs, warm-hooks, and warm-pools are all scoped
      to an environment. Every organization has a singleton Global environment
      whose values apply to every workspace. Personal environments are scoped to
      the authenticated user and can be standalone or source-backed by a team
      environment.
  - name: Repository
    description: >-
      Read repositories and repository sets connected to your organization.
      Repositories are the underlying GitHub-connection layer; bind them to an
      environment to use them in workspaces.
  - name: Replica
    description: Manage replicas (workspaces) for AI agents
  - name: Terminal
    description: Manage interactive terminal sessions in active workspaces
  - name: Preview
    description: Manage public preview URLs for workspace ports
  - name: Profile
    description: Read and update the authenticated user's profile
  - name: Credentials
    description: >-
      Manage coding-agent credentials for an organization or the authenticated
      user
  - name: Google Search Console
    description: >-
      Read Search Console properties, performance, sitemaps, and URL inspection
      results through a connected Google account
  - name: Slack
    description: Connect Slack identities and route threads to Replicas workspaces
  - name: Linear
    description: Connect Linear identities to Replicas accounts
  - name: Automation
    description: >-
      Create and manage automations that trigger replicas on a schedule or in
      response to events
  - name: Downloads
    description: Download Replicas applications
  - name: Analytics
    description: >-
      Read aggregated activity and usage metrics for your organization: compute
      minutes, workspaces created by source, and pull request throughput over a
      time range.
  - name: Presence
    description: >-
      Read and report ephemeral member presence: who is online, where they are
      (environment or workspace), and whether they are typing. Presence is
      backed by short-lived keys rather than the database and broadcast to other
      members over the events stream.
paths:
  /v1/organization/conversations:
    get:
      tags:
        - Replica
      summary: List Organization Conversations
      description: >-
        Returns persisted conversations across every non-deleted workspace in
        the organization without waking workspaces. Requires an organization API
        key or an organization-admin session. Deleted chats, conversations not
        retained under the organization's data-retention settings, and older
        workspaces whose engine predates transcript persistence are omitted.
        Chat and workspace deletion take effect immediately; restart an
        in-progress export after chats or workspaces are deleted or restored to
        obtain a consistent total.
      operationId: listOrganizationConversations
      parameters:
        - name: cursor
          in: query
          description: >-
            Opaque cursor from `next_cursor`. It preserves the initial workspace
            and environment filters and stable artifact creation order. Filters
            may be omitted on later requests but cannot be changed. Chat and
            workspace deletion and restoration remain live and require
            restarting the export for a consistent total.
          required: false
          schema:
            type: string
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            default: 25
            minimum: 1
            maximum: 100
        - name: workspace_id
          in: query
          description: Return conversations from one workspace.
          required: false
          schema:
            type: string
            format: uuid
        - name: environment_id
          in: query
          description: Return conversations from workspaces created with one environment.
          required: false
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListOrganizationConversationsResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    ListOrganizationConversationsResponse:
      type: object
      properties:
        conversations:
          type: array
          items:
            $ref: '#/components/schemas/OrganizationConversation'
        total:
          type: integer
          description: >-
            Matching conversations in non-deleted workspaces at request time.
            Restart the export if chats or workspaces are deleted or restored
            while paging.
        limit:
          type: integer
        next_cursor:
          type:
            - string
            - 'null'
      required:
        - conversations
        - total
        - limit
        - next_cursor
    OrganizationConversation:
      type: object
      description: >-
        A retained chat and its workspace context. Fetch its transcript with
        `GET /v1/replica/{id}/history?chat_id={chat_id}`.
      properties:
        chat_id:
          type: string
          format: uuid
        workspace_id:
          type: string
          format: uuid
        workspace_name:
          type: string
        workspace_status:
          type: string
          enum:
            - active
            - sleeping
            - archived
            - preparing
            - error
        workspace_source:
          type: string
          enum:
            - api
            - dashboard
            - slack
            - linear
            - github
            - gitlab
            - automation
            - mothership
        workspace_created_at:
          type: string
          format: date-time
        workspace_user_id:
          type:
            - string
            - 'null'
          format: uuid
        workspace_creator_email:
          type:
            - string
            - 'null'
          format: email
        environment_id:
          type:
            - string
            - 'null'
          format: uuid
        provider:
          type:
            - string
            - 'null'
          enum:
            - claude
            - codex
            - cursor
            - opencode
            - pi
            - null
        title:
          type:
            - string
            - 'null'
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
        parent_chat_id:
          type:
            - string
            - 'null'
          format: uuid
        senders:
          type: array
          items:
            $ref: '#/components/schemas/ChatMessageSender'
      required:
        - chat_id
        - workspace_id
        - workspace_name
        - workspace_status
        - workspace_source
        - workspace_created_at
        - workspace_user_id
        - workspace_creator_email
        - environment_id
        - provider
        - title
        - created_at
        - updated_at
        - parent_chat_id
        - senders
    Error:
      type: object
      properties:
        error:
          type: string
          description: Error message
        details:
          type:
            - string
            - 'null'
          description: Additional error details
      required:
        - error
    ChatMessageSender:
      type: object
      description: >-
        Records who sent a user message in a chat. Server-recorded from the
        authenticated user at send time.
      properties:
        senderUserId:
          type: string
          description: Identifier of the user who sent the message.
        senderEmail:
          type: string
          description: Email of the user who sent the message.
        recordedAt:
          type: string
          format: date-time
          description: When the sender was recorded by the engine.
      required:
        - senderUserId
        - senderEmail
        - recordedAt
  responses:
    BadRequest:
      description: Bad request - Missing or invalid parameters
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: Unauthorized - Invalid or missing API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: Forbidden - The authenticated account cannot access this resource
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    InternalServerError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: >-
        API key authentication. Obtain your API key from the Replicas dashboard
        under Organization → Settings → API Keys.

````