List conversation segments with pagination

Returns a paginated list of the conversation segments visible to your account.
Segments are ordered by ID descending (most recently created first).

Visibility

A conversation segment is visible when one of these is true:

  • it is public (is_private = false) and your account can access all conversations, or
  • your account is a master, or
  • your account created the segment, or
  • the segment is shared with your account (your account id is in shared_account_ids).

Pagination

This endpoint uses cursor-based pagination:

  • per_page: Number of segments per page (default: 20, max: 100)
  • cursor: The segment_id from the last item of the previous page

Listing the conversations of a segment

To fetch the conversations belonging to a segment, call the conversations list endpoint with the segment_id
filter: GET /conversations?segment_id={segment_id}.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
integer
1 to 100
Defaults to 20

Number of segments per page (default: 20, max: 100)

integer

Cursor from the previous page's response. Omit for the first page.

Responses

401

Authentication credentials are missing or invalid

403

Permission denied

422

Validation error in query parameters

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json