Required. Parent value for CreateConversationRequest. Format: projects/{project}/locations/{location}
Query parameters
Parameters
conversationId
string
Optional. The conversation id of the conversation to create. Must be unique within the parent. The allowed format is: ^[a-z]([a-z0-9-]{0,61}[a-z0-9])?$. If not provided, the server will auto-generate a value for the id.
requestId
string
Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request.
Request body
The request body contains an instance of Conversation.
Response body
If successful, the response body contains a newly created instance of Conversation.
[[["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-09-04 UTC."],[],[],null,["# Method: projects.locations.conversations.create\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\nCreates a new conversation to persist the conversation history. Each conversation will have multiple messages associated with it.\n\n### HTTP request\n\n`POST https://geminidataanalytics.googleapis.com/v1alpha/{parent=projects/*/locations/*}/conversations`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body contains an instance of [Conversation](/gemini/docs/conversational-analytics-api/reference/rest/v1alpha/projects.locations.conversations#Conversation).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Conversation](/gemini/docs/conversational-analytics-api/reference/rest/v1alpha/projects.locations.conversations#Conversation).\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)."]]