Conversations

Update a conversation

Updates the fields you name and keeps the rest. metadata merges into the stored metadata by key, and a null value deletes that key. primaryChannel must be one of the conversation's channels. Tags, categories, and channels are not updated here: use POST and DELETE on /v1/conversations/{id}/tags, /v1/conversations/{id}/categories, and /v1/conversations/{id}/channels.

patch/v1/conversations/{id}

Request

  • Base URL: https://api.samva.dev
  • URL: https://api.samva.dev/v1/conversations/{id}
  • Auth: API key in header x-api-key

Path parameters

idstring required

Request body

titlestring nullable
descriptionstring nullable
externalIdstring nullable
parentConversationIdstring
primaryChannel'email' nullable
status'active' | 'waiting' | 'resolved' | 'escalated' | 'archived' nullable
statusReasonstring nullable
priorityinteger nullable
urgency'low' | 'medium' | 'high' | 'critical' nullable
complexity'simple' | 'moderate' | 'complex' nullable
metadataJsonObject
isTestboolean nullable
isInternalboolean nullable
isPrivateboolean nullable

Response

Conversation

idstring required
titlestring nullable required
externalIdstring nullable required
status'active' | 'waiting' | 'resolved' | 'escalated' | 'archived' required
primaryChannel'email' required
channelsstring[] required
priorityinteger required
urgency'low' | 'medium' | 'high' | 'critical' required
tagsstring[] required
isTestboolean required
messageCountinteger required
lastActivityAtstring required
createdAtstring required
descriptionstring nullable required
parentConversationIdstring required
statusReasonstring nullable required
complexity'simple' | 'moderate' | 'complex' required
categoriesstring[] required
metadataJsonObject required
isInternalboolean required
isPrivateboolean required
startedAtstring required
lastHumanActivityAtstring nullable required
resolvedAtstring nullable required
archivedAtstring nullable required
resolutionType'automated' | 'human_assisted' | 'escalated' | 'abandoned' | 'timeout' nullable required
resolutionNotesstring nullable required
updatedAtstring required

Changes

No recorded changes to this operation across all 1 revision of this API.