Full name: projects.locations.instances.users.conversations.delete
conversations.delete is used to delete a conversation. Deleting a conversation also deletes all the corresponding messages.
HTTP request
Path parameters
Parameters
name
string
Required. The name of the conversation to delete. Format: projects/{project}/locations/{location}/instances/{instance}/users/{user}/conversations/{conversation}
Query parameters
Parameters
force
boolean
Optional. If set to true, any messages from this conversation will also be deleted. Otherwise, the request will only work if the conversation has no messages.
Request body
The request body must be empty.
Response body
If successful, the response body is an empty JSON object.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-25 UTC."],[[["\u003cp\u003eThis webpage details the \u003ccode\u003eDeleteConversation\u003c/code\u003e method for removing a conversation and its associated messages from the system.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request for deleting a conversation uses the \u003ccode\u003eDELETE\u003c/code\u003e method, targeting a specific resource name in the \u003ccode\u003echronicle.googleapis.com\u003c/code\u003e domain.\u003c/p\u003e\n"],["\u003cp\u003eThe method requires a \u003ccode\u003ename\u003c/code\u003e path parameter to specify the conversation to be deleted, following a structured format that identifies the project, location, instance, user, and conversation.\u003c/p\u003e\n"],["\u003cp\u003eIt supports an optional \u003ccode\u003eforce\u003c/code\u003e query parameter to dictate whether messages should also be deleted; without this parameter, deletion only occurs if the conversation has no messages.\u003c/p\u003e\n"],["\u003cp\u003eThe request body is empty, and a successful response returns an empty JSON object, requiring \u003ccode\u003echronicle.conversations.delete\u003c/code\u003e IAM permission and the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,[]]
