Method: projects.locations.conversations.create

• HTTP request
• Path parameters
• Query parameters
• Request body
• Response body
• Authorization scopes
• IAM Permissions
• Try it!

Creates a conversation. Note that this method does not support audio transcription or redaction. Use conversations.upload instead.

HTTP request

POST https://{endpoint}/v1alpha1/{parent=projects/*/locations/*}/conversations

Where {endpoint} is one of the supported service endpoints.

The URLs use gRPC Transcoding syntax.

Path parameters

Parameters
parent	string Required. The parent resource of the conversation.

Query parameters

Parameters
conversationId	string A unique ID for the new conversation. This ID will become the final component of the conversation's resource name. If no ID is specified, a server-generated ID will be used. This value should be 4-64 characters and must match the regular expression ^[a-z0-9-]{4,64}$. Valid characters are [a-z][0-9]-

Request body

The request body contains an instance of Conversation.

Response body

If successful, the response body contains a newly created instance of Conversation.

Authorization scopes

Requires the following OAuth scope:

• https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.

IAM Permissions

Requires the following IAM permissions on the parent resource:

• contactcenterinsights.authorizedConversations.create
• contactcenterinsights.conversations.create

For more information, see the IAM documentation.