v1

latestOpenAPI 3.0.02026-07-2447166133.5 KB
Conversation Tags

Create a conversation tag

This operation creates a conversation tag for the given organization. This tag can then be applied to conversations in subsequent operations. Requesting creation of an already existing tag will result in a 201 response and the response will contain the existing tag.

post/conversations/tags

Headers

s-idempotency-keystring

A unique value generated by the client used to recognize subsequent retries of the same request. Idempotency keys can be up to 255 characters long.

Request body

valuestring required

The text value of a conversation tag

Example request

{
  "value": "Smith"
}

Response

created

idstring required

Spruce's conversation tag ID

objectstring required

String representing the object's type

valuestring required

The text value of a conversation tag

Example response

{
  "id": "tag_0E5QDGJC03000",
  "value": "Smith"
}