Conversations
- GET
/rest/v1.0/projects/{project_id}/conversationsList conversations the caller participates in - POST
/rest/v1.0/projects/{project_id}/conversationsCreate a conversation - GET
/rest/v1.0/projects/{project_id}/conversations/{id}Show a conversation with a bounded message window - POST
/rest/v1.0/projects/{project_id}/conversations/{id}/messagesPost a message to a conversation - PATCH
/rest/v1.0/projects/{project_id}/conversations/{id}/readMark a conversation read for the caller
/rest/v1.0/projects/{project_id}/conversationsList conversations the caller participates in
Parameters
- pageintegerquery
- per_pageintegerquery
- searchstringquery
- project_idstringpathrequired
Response · 200 · ConversationListItem[]
- idintegerrequired
- project_idintegerrequired
- subjectstringrequired
- titlestringrequired
- is_groupbooleanrequired
- created_byUserStub
- participantsParticipant[]required
- participant_countintegerrequired
- message_countintegerrequired
- last_messageobjectrequired
- unread_countintegerrequired
- created_atstringrequired
- updated_atstring
/rest/v1.0/projects/{project_id}/conversationsCreate a conversation
Parameters
- project_idstringpathrequired
Response · 201 · ConversationShow
- idintegerrequired
- project_idintegerrequired
- subjectstringrequired
- titlestringrequired
- is_groupbooleanrequired
- created_byUserStub
- participantsParticipant[]required
- participant_countintegerrequired
- messagesMessage[]required
- message_countintegerrequired
- has_olderbooleanrequired
- older_cursorstringrequired
- window_countintegerrequired
- read_throughstringrequired
- unread_countintegerrequired
- created_atstringrequired
- updated_atstring
/rest/v1.0/projects/{project_id}/conversations/{id}Show a conversation with a bounded message window
Parameters
- beforestringquery
- per_pageintegerquery
- project_idstringpathrequired
- idstringpathrequired
Response · 200 · ConversationShow
- idintegerrequired
- project_idintegerrequired
- subjectstringrequired
- titlestringrequired
- is_groupbooleanrequired
- created_byUserStub
- participantsParticipant[]required
- participant_countintegerrequired
- messagesMessage[]required
- message_countintegerrequired
- has_olderbooleanrequired
- older_cursorstringrequired
- window_countintegerrequired
- read_throughstringrequired
- unread_countintegerrequired
- created_atstringrequired
- updated_atstring
/rest/v1.0/projects/{project_id}/conversations/{id}/messagesPost a message to a conversation
Parameters
- project_idstringpathrequired
- idstringpathrequired
Response · 201 · ConversationShow
- idintegerrequired
- project_idintegerrequired
- subjectstringrequired
- titlestringrequired
- is_groupbooleanrequired
- created_byUserStub
- participantsParticipant[]required
- participant_countintegerrequired
- messagesMessage[]required
- message_countintegerrequired
- has_olderbooleanrequired
- older_cursorstringrequired
- window_countintegerrequired
- read_throughstringrequired
- unread_countintegerrequired
- created_atstringrequired
- updated_atstring
/rest/v1.0/projects/{project_id}/conversations/{id}/readMark a conversation read for the caller
Parameters
- project_idstringpathrequired
- idstringpathrequired
Request body
- throughstring
- last_read_atstring (date-time)
Response · 200 · ConversationShow
- idintegerrequired
- project_idintegerrequired
- subjectstringrequired
- titlestringrequired
- is_groupbooleanrequired
- created_byUserStub
- participantsParticipant[]required
- participant_countintegerrequired
- messagesMessage[]required
- message_countintegerrequired
- has_olderbooleanrequired
- older_cursorstringrequired
- window_countintegerrequired
- read_throughstringrequired
- unread_countintegerrequired
- created_atstringrequired
- updated_atstring