OverviewAPI ReferenceResources
Conversations

Update conversation

Renames the call. Spaces around the title are removed. The title is stored with the key points, so a call without key points returns 404. Fires conversation.updated.

PATCH
/api/v1/conversations/{id}

Authorization

AuthorizationRequiredBearer <token>

A Convo API key: convo_ followed by 32 hex characters. Create it in the Convo desktop app under Settings → Convo API.

In: header

Request Body

application/jsonRequired
titleRequiredstring

New conversation title

Path Parameters

idRequiredstring

Conversation ID from List conversations

curl -X PATCH "https://www.itsconvo.com/api/v1/conversations/session_1773842400000" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Acme pilot pricing call"
  }'

Conversation updated

{
  "data": {
    "id": "session_1773842400000",
    "title": "Acme pilot pricing call"
  }
}

Was this page helpful?

Share conversation

Makes the call readable by anyone with the link and returns the link. Fires `conversation.shared`.

Delete conversation

Deletes the call. It no longer appears in the API or the app, and it is unlinked from your Convo Memory contacts. The API can't restore it. Fires `conversation.deleted`.