Get AI agent logs of all conversations

This API endpoint retrieves AI agent logs of all conversations.

Endpoint

GET /ai-framework-management/api/v1/conversations/

HTTP Method

GET

Path Parameters

None

Query Parameters

Parameter

Type

Description

filter

String

Filters the AI agent logs by the following fields:

  • id - conversation id

  • agent – agent name

  • start_time – start time

For more information on filtering, see Filtering.

limit

Number

Defines how many pages of AI agent logs to retrieve.

The maximum pages is 200. The default is 100 pages.

For more information on pagination, see Pagination.

page

Number

Defines first AI agent logs page to retrieve.

sort

String

Sorts the AI agent logs according one of the following fields.

  • agent – agent name

  • start_time – start time

For more information on sorting, see Sorting.

Request Headers

Authorization: Bearer {token}

Request Example
GET /ai-framework-management/api/v1/conversations?page=1&limit=10&filter=(start_time%3E=2025-10-20%2000:00:00,start_time%3C2025-10-20T22:00:00.000Z)&sort=-start_time HTTP/1.1

Host: livehub.audiocodes.io
Authorization: Bearer av4356prc98mqt512jki
Response Body

The response contains a short summary of AI agent logs for all conversations.

Response Example
{
  "conversations": [
    {
      "id": "5695b6ba-360f-4daf-8b42-47eb59c01767",
      "account_id": "43ac12a9-12aa-404c-9891-052faf29df4e",
      "start_time": "2025-10-23T14:51:46.653000",
      "end_time": "2025-10-23T14:53:49.853000",
      "agent": "weather-agent",
      "history_len": 5
    }
  ],
  "total_count": 1
}