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,["# Method: conversations.delete\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [IAM Permissions](#body.aspect_1)\n- [Try it!](#try-it)\n\n**Full name**: projects.locations.instances.users.conversations.delete\n\nconversations.delete is used to delete a conversation. Deleting a conversation also deletes all the corresponding messages.\n\n### HTTP request\n\nChoose a location: \nafrica-south1 asia-northeast1 asia-south1 asia-southeast1 asia-southeast2 australia-southeast1 europe-west12 europe-west2 europe-west3 europe-west6 europe-west9 me-central1 me-central2 me-west1 northamerica-northeast2 southamerica-east1 us eu \n\n\u003cbr /\u003e\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body is an empty JSON object.\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp).\n\n### IAM Permissions\n\nRequires the following [IAM](https://cloud.google.com/iam/docs) permission on the `name` resource:\n\n- `chronicle.conversations.delete`\n\nFor more information, see the [IAM documentation](https://cloud.google.com/iam/docs)."]]
