Skip to main content
GET
List conversations for a single agent (paginated)

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

departmentId
string

Optional department filter. ADMIN/SUPERADMIN may pass any departmentId; DEPARTMENT_HEAD is implicitly scoped to their own department and any other value is ignored.

userId
string
required

Target agent's user id. Must be a valid ObjectId in the caller's organization (and department, for DEPARTMENT_HEAD).

type
enum<string>
default:assignee
Available options:
assignee,
owner
page
integer
default:1

1-based page number.

Required range: x >= 1
limit
integer
default:20

Page size. Clamped to [1, 100].

Required range: 1 <= x <= 100

Response

Agent conversations returned

success
enum<boolean>
required
Available options:
true
data
object
required