{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"{% admonition type=\"warning\" name=\"Irreversible operation\" %}\nDeleting a conversation is permanent and cannot be reversed.\n{% /admonition %}\n\nYou can delete a single conversation. The behavior depends on the `retain_metrics` parameter:\n\n- **With `retain_metrics=true` (default)**: Deletes the conversation while retaining reporting data. The conversation will still appear in reporting, though some data may be incomplete due to the deletion.\n\n- **With `retain_metrics=false`**: Deletes the conversation and all associated reporting data. The conversation will be completely removed from both the inbox and all reporting.\n\n{% admonition type=\"info\" name=\"Required scope for retain_metrics=false\" %}\nUsing `retain_metrics=false` requires the `delete_conversations_and_metrics` OAuth scope.\n{% /admonition %}\n\nFor more info, see [this help center article](https://www.intercom.com/help/en/articles/13885146-deleting-a-conversation).\n","properties":{"headers":{"type":"object","properties":{"Intercom-Version":{"$ref":"#/definitions/intercom_version","enum":["2.17"]}},"required":[],"additionalProperties":false},"path":{"type":"object","properties":{"conversation_id":{"type":"integer","description":"id"}},"required":["conversation_id"],"additionalProperties":false},"query":{"type":"object","properties":{"retain_metrics":{"type":"boolean","examples":[true],"description":"If true (default), deletes the conversation while retaining reporting data. If false, deletes the conversation and all associated reporting data. Setting to false requires the `delete_conversations_and_metrics` OAuth scope."}},"required":[],"additionalProperties":false}},"required":["path"],"additionalProperties":false,"definitions":{"intercom_version":{"description":"Intercom API version.</br>If you omit the header, the API uses the version set in your app package, and 1.0 if none is set.","type":"string","enum":["1.0","1.1","1.2","1.3","1.4","2.0","2.1","2.2","2.3","2.4","2.5","2.6","2.7","2.8","2.9","2.10","2.11","2.12","2.13","2.14","2.15","2.16","2.17"],"examples":["2.17"]}}},"name":"Delete a conversation","id":"intercom.deleteconversation","example":{"path":{"conversation_id":1}},"maxRequests":1,"summary":false}}