---
title: "Chat with next-gen assistant"
slug: "chat-with-next-gen-assistant"
updated: 2026-02-11T02:27:31Z
published: 2026-02-11T02:27:31Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.unleash.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Chat with next-gen assistant

Post/chats/v2

Chat with next-gen assistant

SecurityAPI Key: BearerHeader parameter nameAuthorization

Enter the token with the `Bearer: ` prefix, e.g. "Bearer abcde12345".

Header parametersunleash-account

Email address of the user to impersonate. This header allows the caller to perform actions on behalf of the specified user.

Body parameters<select class='api-response-data' aria-label='Media type'><option value='af0bbee2-e4e6-4b85-821e-8b5fd70fec7b'>application/json</option>
<option value='c9f645bb-bb7b-498c-a0a3-04e88bafa9cd'>text/json</option>
<option value='9869199d-4c85-471e-bb76-f509434cee32'>application/*+json</option>
</select>Expand Allobject  messages Array of object (ChatMessageRequest)   RequiredMin items1object  textstring   | null  
rolestring    Valid values[
  "User",
  "System",
  "Assistant"
]

assistantIdstring   | null  
threadIdstring   | null  

Expand Allobject  messages Array of object (ChatMessageRequest)   RequiredMin items1object  textstring   | null  
rolestring    Valid values[
  "User",
  "System",
  "Assistant"
]

assistantIdstring   | null  
threadIdstring   | null  

Expand Allobject  messages Array of object (ChatMessageRequest)   RequiredMin items1object  textstring   | null  
rolestring    Valid values[
  "User",
  "System",
  "Assistant"
]

assistantIdstring   | null  
threadIdstring   | null  

Responses200

Success

<select class='api-response-data' aria-label='Media type'><option value='41bf924d-23d2-4ebf-9219-3c66f88c290a'>text/event-stream</option>
<option value='31f1adb8-0c9f-428b-89c4-33df095dacef'>application/json</option>
</select>Expand Allobject  textstring   | null  
toolCalls Array of object (ToolCall)  | null  object  idstring    
namestring    
typestring    
callIdstring    
argumentsstring    

referenceobject (ReferenceChatv2)  referenceIds Array of string  | null  string    
positioninteger    

sourcesobject (Sources)  sourcesIds Array of string  | null  string    

toolobject (Tool)  toolCallStatusobject (ToolCallStatus)  toolCallIdstring    
statusstring    Valid values[
  "Start",
  "End",
  "Failed"
]

toolStepobject (ToolStep)  stepDescriptionstring    
toolIdstring    

responseobject (ToolResponse)  namestring    
toolIdstring    
resourcesobject (ToolResources)  enterpriseobject (EnterpriseToolResources)  results Array of object (Resource)  | null  object  idstring   | null  
appIdstring   | null  
typestring   | null  
externalIdstring   | null  
namestring   | null  
dataobject | null  property*

titlestring   | null  
subtitlestring   | null  
urlstring   | null  

webSearchobject (WebSearchToolResources)  sources Array of object (WebSource)  | null  object  idstring    
urlstring    
iconstring    
titlestring    
siteNamestring    
descriptionstring    

customobject (CustomToolResources)  property*

requestIdstring   | null  

Expand Allobject  textstring   | null  
toolCalls Array of object (ToolCall)  | null  object  idstring    
namestring    
typestring    
callIdstring    
argumentsstring    

referenceobject (ReferenceChatv2)  referenceIds Array of string  | null  string    
positioninteger    

sourcesobject (Sources)  sourcesIds Array of string  | null  string    

toolobject (Tool)  toolCallStatusobject (ToolCallStatus)  toolCallIdstring    
statusstring    Valid values[
  "Start",
  "End",
  "Failed"
]

toolStepobject (ToolStep)  stepDescriptionstring    
toolIdstring    

responseobject (ToolResponse)  namestring    
toolIdstring    
resourcesobject (ToolResources)  enterpriseobject (EnterpriseToolResources)  results Array of object (Resource)  | null  object  idstring   | null  
appIdstring   | null  
typestring   | null  
externalIdstring   | null  
namestring   | null  
dataobject | null  property*

titlestring   | null  
subtitlestring   | null  
urlstring   | null  

webSearchobject (WebSearchToolResources)  sources Array of object (WebSource)  | null  object  idstring    
urlstring    
iconstring    
titlestring    
siteNamestring    
descriptionstring    

customobject (CustomToolResources)  property*

requestIdstring   | null  

400

Bad Request

<select class='api-response-data' aria-label='Media type'><option value='498e8035-3172-477f-9358-cf9d5a3b1914'>text/plain</option>
<option value='4ecc7695-656e-42b7-8d4e-3074d5f12b09'>application/json</option>
<option value='671b264e-35af-44e2-93d6-5e7cce443c2d'>text/json</option>
</select>Expand Allobject  typestring   | null  
titlestring   | null  
statusinteger  (int32)   | null  
detailstring   | null  
instancestring   | null  
errorsobject | null  property* Array of string   additionalPropertiesstring    

property*

Expand Allobject  typestring   | null  
titlestring   | null  
statusinteger  (int32)   | null  
detailstring   | null  
instancestring   | null  
errorsobject | null  property* Array of string   additionalPropertiesstring    

property*

Expand Allobject  typestring   | null  
titlestring   | null  
statusinteger  (int32)   | null  
detailstring   | null  
instancestring   | null  
errorsobject | null  property* Array of string   additionalPropertiesstring    

property*