Conversation Service
/
ConversationService
/
Closes a Conversation.

Conversation Service

Our Conversation Service API comprehensively manages the entire lifecycle of conversations—enabling creation, updates (audio persistence, display name, language, sharing, skill, state, and metadata), retrieval, redaction or deletion of messages, tagging, event logging, batch operations, and final closure—providing robust end-to-end conversation management.

Languages
Servers
https://{api-domain}.cresta.com/

ConversationService

Operations

Deletes a conversation and all its messages from the apps DB.

Request

If the conversation does not exist, it returns a NOT_FOUND (404) error.

Path
namestringrequired

The resource name of the conversation to be deleted.

curl -i -X DELETE \
  'https://{api-domain}.cresta.com/v1/{name=customers/*/profiles/*/conversations/*}'

Responses

A successful response.

Bodyapplication/json
object(Response of [ConversationService.DeleteConversation][])
Response
application/json
{}

Closes a Conversation.

Request

If the Conversation does not exist, it returns a NOT_FOUND (404) error.

DEPRECATED: Use UpdateConversationState instead.

Path
namestringrequired

Resource name of the Conversation to be closed.

Format: customers/{customer_id}/profiles/{profile_id}/conversations/{conversation_id}

Bodyapplication/jsonrequired
object

Request of [ConversationService.CloseConversation][].

curl -i -X POST \
  'https://{api-domain}.cresta.com/v1/{name=customers/*/profiles/*/conversations/*}:close' \
  -H 'Content-Type: application/json' \
  -d '{}'

Responses

A successful response.

Bodyapplication/json
object(conversationCloseConversationResponse)

Response of [ConversationService.CloseConversation][].

Response
application/json
{}

AddStarTagToConversation

Request

Adds a star tag to a conversation. This service behaves like AddConversationTag but it creates star tag automatically if the star tag for a user is not set.

Path
parentstringrequired

The resource name of the conversation to be starred.

Bodyapplication/jsonrequired
object(Request of [ConversationService.AddConversationStarTag][])
curl -i -X POST \
  'https://{api-domain}.cresta.com/v1/{parent=customers/*/profiles/*/conversations/*}/addConversationStarTag' \
  -H 'Content-Type: application/json' \
  -d '{}'

Responses

A successful response.

Bodyapplication/json
object(Response of [ConversationService.AddConversationStarTag][])
Response
application/json
{}