--- title: "Chat with assistant" slug: "chat-with-assistant" updated: 2025-04-28T20:01:59Z published: 2025-04-28T20:01:59Z canonical: "help.unleash.so/chat-with-assistant" --- > ## 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 assistant Post/chats Chat with any assistant SecurityAPI KeyHeader 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 parametersExpand Allobject messages Array of object (ChatMessageRequest) RequiredMin items1object textstring | null rolestring Valid values[ "User", "System", "Assistant" ] assistantIdstring | null enterpriseSearchobject (ChatEnterpriseSearchRequest) filtersobject (SearchFilters) resourceId Array of string | null string isStarredboolean | null hasAttachmentsboolean | null rsvp Array of string | null string appId Array of string | null string type Array of string | null string label Array of string | null string anyLabel Array of string | null string sentTo Array of string | null string sentFrom Array of string | null string createdBy Array of string | null string modifiedBy Array of string | null string reporter Array of string | null string assignedTo Array of string | null string reviewer Array of string | null string fromTimestring | null untilTimestring | null createBeforeTimestring | null createAfterTimestring | null modifiedBeforeTimestring | null modifiedAfterTimestring | null dueBeforeTimestring | null dueAfterTimestring | null class Array of string | null string sharedBy Array of string | null string sharedWith Array of string | null string linkId Array of string | null string eventTimeFrameStartstring | null eventTimeFrameEndstring | null status Array of string | null string cycle Array of string | null string extension Array of string | null string jobTitle Array of string | null string location Array of string | null string department Array of string | null string managedBy Array of string | null string isManagerboolean | null participants Array of string | null string topic Array of string | null string hasLinksboolean | null mentioned Array of string | null string pathPrefix Array of string | null string path Array of string | null string fileTypeGroup Array of string | null string relatedContacts Array of string | null string recentActivityForstring | null workingOnstring | null property* streamboolean threadIdstring | null Expand Allobject messages Array of object (ChatMessageRequest) RequiredMin items1object textstring | null rolestring Valid values[ "User", "System", "Assistant" ] assistantIdstring | null enterpriseSearchobject (ChatEnterpriseSearchRequest) filtersobject (SearchFilters) resourceId Array of string | null string isStarredboolean | null hasAttachmentsboolean | null rsvp Array of string | null string appId Array of string | null string type Array of string | null string label Array of string | null string anyLabel Array of string | null string sentTo Array of string | null string sentFrom Array of string | null string createdBy Array of string | null string modifiedBy Array of string | null string reporter Array of string | null string assignedTo Array of string | null string reviewer Array of string | null string fromTimestring | null untilTimestring | null createBeforeTimestring | null createAfterTimestring | null modifiedBeforeTimestring | null modifiedAfterTimestring | null dueBeforeTimestring | null dueAfterTimestring | null class Array of string | null string sharedBy Array of string | null string sharedWith Array of string | null string linkId Array of string | null string eventTimeFrameStartstring | null eventTimeFrameEndstring | null status Array of string | null string cycle Array of string | null string extension Array of string | null string jobTitle Array of string | null string location Array of string | null string department Array of string | null string managedBy Array of string | null string isManagerboolean | null participants Array of string | null string topic Array of string | null string hasLinksboolean | null mentioned Array of string | null string pathPrefix Array of string | null string path Array of string | null string fileTypeGroup Array of string | null string relatedContacts Array of string | null string recentActivityForstring | null workingOnstring | null property* streamboolean threadIdstring | null Expand Allobject messages Array of object (ChatMessageRequest) RequiredMin items1object textstring | null rolestring Valid values[ "User", "System", "Assistant" ] assistantIdstring | null enterpriseSearchobject (ChatEnterpriseSearchRequest) filtersobject (SearchFilters) resourceId Array of string | null string isStarredboolean | null hasAttachmentsboolean | null rsvp Array of string | null string appId Array of string | null string type Array of string | null string label Array of string | null string anyLabel Array of string | null string sentTo Array of string | null string sentFrom Array of string | null string createdBy Array of string | null string modifiedBy Array of string | null string reporter Array of string | null string assignedTo Array of string | null string reviewer Array of string | null string fromTimestring | null untilTimestring | null createBeforeTimestring | null createAfterTimestring | null modifiedBeforeTimestring | null modifiedAfterTimestring | null dueBeforeTimestring | null dueAfterTimestring | null class Array of string | null string sharedBy Array of string | null string sharedWith Array of string | null string linkId Array of string | null string eventTimeFrameStartstring | null eventTimeFrameEndstring | null status Array of string | null string cycle Array of string | null string extension Array of string | null string jobTitle Array of string | null string location Array of string | null string department Array of string | null string managedBy Array of string | null string isManagerboolean | null participants Array of string | null string topic Array of string | null string hasLinksboolean | null mentioned Array of string | null string pathPrefix Array of string | null string path Array of string | null string fileTypeGroup Array of string | null string relatedContacts Array of string | null string recentActivityForstring | null workingOnstring | null property* streamboolean threadIdstring | null Responses200 Success Expand Allobject typestring Valid values[ "Request", "Resources", "Message", "References", "Progress", "Full" ] requestIdstring | null messageobject (ChatMessageResponse) rolestring Valid values[ "User", "System", "Assistant" ] parts Array of object (IChatMessagePart) | null object typestring Valid values[ "Text", "InlineReference" ] resources 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 references Array of object (Reference) | null object resourceIdstring | null threadIdstring | null Expand Allobject typestring Valid values[ "Request", "Resources", "Message", "References", "Progress", "Full" ] requestIdstring | null messageobject (ChatMessageResponse) rolestring Valid values[ "User", "System", "Assistant" ] parts Array of object (IChatMessagePart) | null object typestring Valid values[ "Text", "InlineReference" ] resources 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 references Array of object (Reference) | null object resourceIdstring | null threadIdstring | null Expand Allobject typestring Valid values[ "Request", "Resources", "Message", "References", "Progress", "Full" ] requestIdstring | null messageobject (ChatMessageResponse) rolestring Valid values[ "User", "System", "Assistant" ] parts Array of object (IChatMessagePart) | null object typestring Valid values[ "Text", "InlineReference" ] resources 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 references Array of object (Reference) | null object resourceIdstring | null threadIdstring | null 400 Bad Request 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*