Method: projects.locations.conversations.create

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

HTTP request

POST https://{endpoint}/v1/{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.