LeadMagnet/leadchat
1
0
Fork 0
Code Issues Pull Requests Actions 3 Packages Projects Releases Wiki Activity

docs: Update conversation toggle API with snooze & pending (#12406)

Browse Source 
## Changes 

- Update conversation toggle API with documentation of additional
statuses and options which are supported - snoozed , snooze_until &
pending

fixes: https://github.com/chatwoot/chatwoot/issues/12137
This commit is contained in:
Sojan Jose
2025-09-10 17:33:24 +05:30
committed by GitHub
parent 7554156abe
commit aba4e8bc53
3 changed files with 97 additions and 9 deletions
Download Patch File Download Diff File Expand all files Collapse all files

37
swagger/tag_groups/application_swagger.json
View File

@@ -3070,7 +3070,7 @@
],
"operationId": "toggle-status-of-a-conversation",
"summary": "Toggle Status",
"description": "Toggles the status of the conversation between open and resolved",
"description": "Toggle the status of a conversation. Pass `status` to explicitly set the\nconversation state. Use `snoozed` along with `snoozed_until` to snooze a\nconversation until a specific time. If `snoozed_until` is omitted, the\nconversation is snoozed until the next reply from the contact. Regardless\nof the value provided, snoozed conversations always reopen on the next\nreply from the contact.",
"security": [
{
"userApiKey": []
@@ -3094,10 +3094,16 @@
"enum": [
"open",
"resolved",
"pending"
"pending",
"snoozed"
],
"description": "The status of the conversation",
"example": "open"
},
"snoozed_until": {
"type": "number",
"description": "When status is `snoozed`, schedule the reopen time as a Unix timestamp in seconds. If not provided, the conversation is snoozed until the next customer reply. The conversation always reopens when the customer replies.",
"example": 1757506877
}
}
}
@@ -3110,7 +3116,32 @@
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/conversation_status_toggle"
"type": "object",
"properties": {
"meta": {
"type": "object"
},
"payload": {
"type": "object",
"properties": {
"success": {
"type": "boolean"
},
"current_status": {
"type": "string",
"enum": [
"open",
"resolved",
"pending",
"snoozed"
]
},
"conversation_id": {
"type": "number"
}
}
}
}
}
}
}