Update a convo's subject and/or notes

Updates `subject` and/or `notes`. Allowed regardless of convo status so notes can be added after the call ends. Only the user who started the convo can update it. At least one field must be provided.

Updates subject and/or notes. Allowed regardless of convo status so notes can be added after the call ends. Only the user who started the convo can update it. At least one field must be provided.

Authorization

bearerAuth

AuthorizationBearer <token>

In: header

Path Parameters

convoId*string

Convo ID

Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Properties1 <= properties

subject?string

New subject. An empty string clears it.

Lengthlength <= 200

notes?string

New notes. An empty string clears them.

Lengthlength <= 5000

Response Body

`application/json`

curl -X PATCH "https://example.com/convos/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "Content-Type: application/json" \  -d '{    "subject": "Design review",    "notes": "Agreed to ship the new header on Friday."  }'

{  "convo": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "convoType": "video",    "status": "active",    "subject": "string",    "notes": "string",    "chatId": "f255124e-3419-4f6e-b7ee-17a6577db94d",    "chat": {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "chatType": "topic",      "topicId": "97b608a9-302e-4387-a5f4-fd35969cdc21",      "topicType": "asset",      "replyType": "quote",      "subject": "string",      "visibility": "creator",      "publicId": "f72dfe8e-6cfd-43c2-b1cb-95adbf313789",      "participants": [        "e3139958-26f5-4fd4-a9c9-fe1c29c5cbac"      ],      "following": [        "6bc36f94-42f8-4778-8086-0f778a9e5f30"      ],      "annotations": [        {}      ],      "totalMessages": 0,      "lastMessageAt": "2019-08-24T14:15:22Z",      "recentMessages": [        "6738c803-41a8-4296-a5bd-8d9974ec6fa0"      ],      "activeConvoId": "6ac5e0e4-f5db-4276-ac1c-9dd077ad79d2",      "activeConvo": "d97b3779-3421-4076-bf6e-15252c014d1d",      "status": "active",      "createdAt": "2019-08-24T14:15:22Z",      "updatedAt": "2019-08-24T14:15:22Z"    },    "chatType": "chat",    "messageId": "8540d774-4863-4d2b-b788-4ecb19412e85",    "message": "3eb7c4fd-0d67-442a-a08d-929546df1ebe",    "dailyRoomName": "string",    "dailyRoomUrl": "string",    "dailyRoomConfig": {},    "startedById": "7347b630-d3cd-4c11-b046-3f92c23756e5",    "startedBy": {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "firstName": "string",      "lastName": "string",      "displayName": "string",      "avatar": "01d8bd6c-6014-46aa-b5b1-14d337c9c779",      "color": "string",      "awards": [        "staff"      ],      "accountType": "standard"    },    "activeParticipants": [      {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "firstName": "string",        "lastName": "string",        "displayName": "string",        "avatar": "01d8bd6c-6014-46aa-b5b1-14d337c9c779",        "color": "string",        "awards": [          "staff"        ],        "accountType": "standard"      }    ],    "allParticipants": [      {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "firstName": "string",        "lastName": "string",        "displayName": "string",        "avatar": "01d8bd6c-6014-46aa-b5b1-14d337c9c779",        "color": "string",        "awards": [          "staff"        ],        "accountType": "standard"      }    ],    "startedAt": 0,    "endedAt": 0,    "durationMinutes": 0,    "recordings": [      {}    ],    "transcripts": [      {}    ],    "participantSessions": [      {}    ],    "billedAtVideo": 0,    "billedCreditsVideo": 0,    "billedAtRecording": 0,    "billedCreditsRecording": 0,    "inheritanceId": "09c886ac-e6e5-4263-a494-a6e14f7e4f46",    "scopeId": "65fafe40-a220-4dd7-8724-4598b81c0643",    "scopeType": "project",    "scopeVisibility": [      "creator"    ],    "createdAt": 0,    "updatedAt": 0  }}