Get chat_group | Hume API
Fetches a ChatGroup by ID, including a paginated list of Chats associated with the ChatGroup.
Authentication
X-Hume-Api-Key string
API Key authentication via header
Path parameters
- id
string Required format: "uuid"
Identifier for a Chat Group. Formatted as a UUID.
Query parameters
status
string Optional
Chat status to apply to the chat. String from the ChatStatus enum.page_size
integer Optional
Specifies the maximum number of results to include per page, enabling pagination. The value must be between 1 and 100, inclusive.
For example, ifpage_sizeis set to 10, each page will include up to 10 items. Defaults to 10.page_number
integer Optional Defaults to0``
Specifies the page number to retrieve, enabling pagination.
This parameter uses zero-based indexing. For example, settingpage_numberto 0 retrieves the first page of results (items 0-9 ifpage_sizeis 10), settingpage_numberto 1 retrieves the second page (items 10-19), and so on. Defaults to 0, which retrieves the first page.ascending_order
boolean Optional
Specifies the sorting order of the results based on their creation date. Set to true for ascending order (chronological, with the oldest records first) and false for descending order (reverse-chronological, with the newest records first). Defaults to true.
Response
Success
- chats_page
list of objectsList of Chats and their metadata returned for the specifiedpage_numberandpage_size.
Show 8 properties
first_start_timestamp
long
Time at which the first Chat in this Chat Group was created. Measured in seconds since the Unix epoch.id
string
Identifier for the Chat Group. Any Chat resumed from this Chat Group will have the samechat_group_id. Formatted as a UUID.most_recent_start_timestamp
long
Time at which the most recent Chat in this Chat Group was created. Measured in seconds since the Unix epoch.num_chats
integer
The total number of Chats associated with this Chat Group.page_number
integer
The page number of the returned list.
This value corresponds to thepage_numberparameter specified in the request. Pagination uses zero-based indexing.page_size
integer
The maximum number of items returned per page.
This value corresponds to thepage_sizeparameter specified in the request.pagination_direction
enum
Allowed values: ASC, DESCtotal_pages
integer
The total number of pages in the collection.active
boolean
Ask AI