List Conversations (Chat History)

This endpoint retrieves a paginated list of past conversations (chat history) for a specific workspace. It is useful for displaying a "Recent Chats" sidebar.

URL: GET https://server.feedboss.ai/api/v1/ai-conversation/list/:workspaceId

Authentication

All endpoints require authentication. You can authenticate using a Service API Key.

Service API Key

Add your Service API Key to the x-api-key header.

x-api-key: fb_live_xxxxxxxxxxxxxxxxxxxxxxxx

---

Path Parameters

Parameter	Type	Description
workspaceId	String	The unique identifier of the workspace.

Query Parameters

Parameter	Type	Default	Description
page	Number	1	The page number to retrieve.
limit	Number	20	The number of conversations per page.

Response Format

Returns a JSON object containing the list of conversations and pagination metadata.

{
  "success": true,
  "data": {
    "conversations": [
      {
        "_id": "65b...",
        "title": "Marketing discussion",
        "updatedAt": "2024-01-28T10:00:00.000Z",
        "createdAt": "2024-01-28T09:55:00.000Z",
        "status": "active",
        "metadata": { ... }
      },
      ...
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 45,
      "pages": 3
    }
  }
}

Example Request (cURL)

curl -X GET "http://localhost:5000/api/v1/ai-conversation/list/691b0d48ad2baa659bf58b4b?page=1&limit=10" \
  -H "x-api-key: fb_live_YOUR_API_KEY_HERE"