Skip to main content
GET
/
agent
/
{agent_id}
/
conversations
List Knowledge Agent Conversations
curl --request GET \
  --url https://api-lr.agent.ai/v1/agent/{agent_id}/conversations \
  --header 'Authorization: Bearer <token>'
{
  "status": 200,
  "agent_id": "deepseek-r1",
  "conversations": [
    {
      "run_id": "e3b0c44298fc1c149afb",
      "title": "How to set up integrations",
      "created_at": "2026-03-15T10:30:00",
      "updated_at": "2026-03-15T10:35:00"
    },
    {
      "run_id": "a1b2c3d4e5f67890abcd",
      "title": "DeepSeek model capabilities",
      "created_at": "2026-03-14T09:00:00",
      "updated_at": "2026-03-14T09:22:00"
    }
  ],
  "total": 42,
  "limit": 20,
  "offset": 0
}

Authorizations

​
Authorization
string
header
required

Bearer token from your account (https://agent.ai/user/integrations#api)

Path Parameters

​
agent_id
string
required

The agent ID or human-readable slug.

Query Parameters

​
limit
integer
default:20

Maximum number of conversations to return.

Required range: 1 <= x <= 100
​
offset
integer
default:0

Number of conversations to skip for pagination.

Required range: x >= 0
​
search
string

Filter conversations by title (case-insensitive substring match).

Response

Conversations listed successfully

​
status
integer
Example:

200

​
agent_id
string

The agent ID or slug.

​
conversations
object[]
​
total
integer

Total number of conversations matching the query.

​
limit
integer
​
offset
integer