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

# List Conversations

> List conversations in your workspace with filtering and pagination

## List Conversations

Retrieve a paginated list of conversations in your workspace with optional filtering and search capabilities.

### Headers

<ParamField header="Authorization" type="string">
  Bearer token for authentication
</ParamField>

<ParamField header="X-API-Key" type="string">
  API key for authentication (alternative to Authorization header)
</ParamField>

<ParamField header="X-Workspace-Id" type="string">
  Optional. Derived from API Key, but can be specified if you have access to multiple workspaces
</ParamField>

### Query Parameters

<ParamField query="skip" type="integer" default="0">
  Number of conversations to skip for pagination
</ParamField>

<ParamField query="limit" type="integer" default="100">
  Maximum number of conversations to return (1-1000)
</ParamField>

<ParamField query="status" type="string">
  Filter by conversation status (active, ended, archived)
</ParamField>

<ParamField query="search" type="string">
  Search conversations by title
</ParamField>

<ParamField query="user_id" type="string">
  Filter conversations by user ID
</ParamField>

<ParamField query="collection_id" type="string">
  Filter conversations by associated collection ID
</ParamField>

### Response

<ResponseField name="data" type="array">
  Array of conversation objects

  <Expandable title="conversation object">
    <ResponseField name="id" type="string">
      Unique conversation identifier
    </ResponseField>

    <ResponseField name="title" type="string">
      Conversation title
    </ResponseField>

    <ResponseField name="summary" type="string">
      Auto-generated conversation summary
    </ResponseField>

    <ResponseField name="status" type="string">
      Conversation status (active, ended, archived)
    </ResponseField>

    <ResponseField name="is_public" type="boolean">
      Whether the conversation is public
    </ResponseField>

    <ResponseField name="collections" type="array">
      Array of associated collection IDs
    </ResponseField>

    <ResponseField name="meta_data" type="object">
      Additional conversation metadata
    </ResponseField>

    <ResponseField name="ended_at" type="string">
      Timestamp when conversation was ended (if applicable)
    </ResponseField>

    <ResponseField name="owner_id" type="string">
      ID of the conversation owner
    </ResponseField>

    <ResponseField name="workspace_id" type="string">
      ID of the workspace
    </ResponseField>

    <ResponseField name="created_by" type="string">
      ID of the user who created the conversation
    </ResponseField>

    <ResponseField name="created_at" type="string">
      Timestamp when conversation was created
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      Timestamp when conversation was last updated
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="total_count" type="integer">
  Total number of conversations matching the filters
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.mielto.com/api/v1/conversations?skip=0&limit=20&status=active" \
    -H "X-API-Key: YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.mielto.com/api/v1/conversations",
      headers={"X-API-Key": "YOUR_API_KEY"},
      params={
          "skip": 0,
          "limit": 20,
          "status": "active"
      }
  )

  conversations = response.json()
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch("https://api.mielto.com/api/v1/conversations?skip=0&limit=20&status=active", {
    headers: {
      "X-API-Key": "YOUR_API_KEY"
    }
  });

  const conversations = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "data": [
      {
        "id": "conv_123456789",
        "title": "Product Strategy Discussion",
        "summary": "Discussion about Q2 product strategy and key market considerations",
        "status": "active",
        "is_public": false,
        "collections": ["col_123456789"],
        "meta_data": {
          "category": "planning",
          "priority": "high"
        },
        "settings": {
          "auto_summarize": true,
          "context_window": 4000
        },
        "ended_at": null,
        "owner_id": "usr_123456789",
        "workspace_id": "wsp_123456789",
        "created_by": "usr_123456789",
        "created_at": "2024-01-16T10:00:00Z",
        "updated_at": "2024-01-16T12:30:00Z"
      },
      {
        "id": "conv_987654321",
        "title": "Customer Feedback Analysis",
        "summary": "Analysis of recent customer feedback and improvement suggestions",
        "status": "active",
        "is_public": false,
        "collections": ["col_987654321"],
        "meta_data": {
          "category": "feedback",
          "priority": "medium"
        },
        "settings": {
          "auto_summarize": true,
          "context_window": 3000
        },
        "ended_at": null,
        "owner_id": "usr_987654321",
        "workspace_id": "wsp_123456789",
        "created_by": "usr_987654321",
        "created_at": "2024-01-15T14:20:00Z",
        "updated_at": "2024-01-16T09:15:00Z"
      }
    ],
    "total_count": 25
  }
  ```
</ResponseExample>

<Note>
  Use pagination parameters `skip` and `limit` to efficiently navigate through large numbers of conversations. The `search` parameter performs fuzzy matching on conversation titles.
</Note>