Conversations

Close conversation manually

Close a WhatsApp conversation manually. This will:

  • Set lifecycleStatus to 'completed'
  • Disable AI auto-replies
  • Enqueue conversation analysis (if ≥3 messages and analyzer enabled)

The legacy status field is still returned for compatibility during the transition to split lifecycle/delivery states.

This is useful when you want to end a conversation before the 24h window expires.

Note: Already-closed conversations return 200 OK (idempotent).

post/api/v1/conversations/{conversationId}/close

Request

  • Base URL: http://localhost:8080
  • URL: http://localhost:8080/api/v1/conversations/{conversationId}/close
  • Auth: bearerAuth (a scheme the document does not define)

Path parameters

conversationIdstring required

Conversation ID

Request body

reasonstring

Optional reason for closing conversation

Example request

{
  "reason": "Conversation resolved manually"
}

Response

Created

successtrue required
messagestring

Changes

No recorded changes to this operation across all 1 revision of this API.