Conversation Service
/
ConversationService
/
Adds a tag to 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

List all the tags of a conversation.

Request

Path
parentstringrequired

The resource name of the conversation to be listed.

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

Responses

A successful response.

Bodyapplication/json
tagsArray of objects(Tags can be set on conversations to help with filtering and searching. Next id: 14)

The resource name of the tags that are added to the conversation.

Response
application/json
{
  "tags": [
    { … }
  ]
}

Adds a tag to a conversation.

Request

Path
parentstringrequired

The resource name of the conversation to be tagged.

Bodyapplication/jsonrequired
tagstringrequired

The resource name of the tag to be added to the conversation.

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

Responses

A successful response.

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

Deletes a tag from a conversation

Request

Path
parentstringrequired

The resource name of the conversation to be untagged.

tagIdstringrequired

The resource id of the tag to be removed from the conversation.

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

Responses

A successful response.

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