List Conversations

GET /agents/{agentId}/conversations

Path Parameters

---

agentId string Required

The agent id

---

Query Parameters

---

limit integer

A limit on the number of conversations to be returned. Limit can range between 1 and 50, and the default is 20.

cursor string (optional)

A cursor for pagination. Use the nextCursor value from the previous response to fetch the next page of results.

userIdentifier string (optional)

Filter conversations by user identifier. Returns only conversations created with this userIdentifier.
For example: ?userIdentifier=user_123

userContext[<key>] string | number (optional)

An optional filter to return only conversations matching the given context key and value. The key is user-defined and should match a key in the userContext object provided when the conversation was created.
For example: ?userContext[organisationId]=1 will match conversations where userContext.organisationId === 1.

---

Request

Node.js

import Inconvo from "@inconvoai/node";

const inconvo = new Inconvo({
  apiKey: process.env.INCONVO_API_KEY
});

// Filter by userIdentifier
const conversations = await inconvo.agents.conversations.list(
  "agt_123",
  {
    limit: 2,
    userIdentifier: "user_123"
  }
);

console.log(conversations);

Response

{
  "items": [
    {
      "id": "convo_898eb50b-dbe8-4496-9189-1800c0b38e23",
      "title": "Revenue analysis for Q4",
      "createdAt": "2025-07-18T08:05:17.188Z",
      "userIdentifier": "user_123",
      "userContext": { "organisationId": 1 }
    },
    {
      "id": "convo_0166818f-2e58-40a6-b610-49dc14f908d3",
      "title": "Customer segmentation query",
      "createdAt": "2025-07-10T14:45:11.364Z",
      "userIdentifier": "user_123",
      "userContext": { "organisationId": 1 }
    }
  ],
  "nextCursor": "convo_0166818f-2e58-40a6-b610-49dc14f908d3"
}

curl -X GET \
  "https://app.inconvo.ai/api/v1/agents/agt_123/conversations?limit=2&userIdentifier=user_123" \
  -H "Authorization: Bearer $INCONVO_API_KEY"

Response

{
  "items": [
    {
      "id": "convo_898eb50b-dbe8-4496-9189-1800c0b38e23",
      "title": "Revenue analysis for Q4",
      "createdAt": "2025-07-18T08:05:17.188Z",
      "userIdentifier": "user_123",
      "userContext": { "organisationId": 1 }
    },
    {
      "id": "convo_0166818f-2e58-40a6-b610-49dc14f908d3",
      "title": "Customer segmentation query",
      "createdAt": "2025-07-10T14:45:11.364Z",
      "userIdentifier": "user_123",
      "userContext": { "organisationId": 1 }
    }
  ],
  "nextCursor": "convo_0166818f-2e58-40a6-b610-49dc14f908d3"
}