Nurama Developers
Convos

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.

PATCH
/convos/{convoId}

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

AuthorizationBearer <token>

OAuth 2.1 authorization code flow with PKCE (required of every client, public or confidential). Scopes are a ceiling on the credential, not a grant of access: a token also cannot exceed what the user who approved it may already do. A write scope does not imply its matching read — ask for both.

In: header

Scope: convos:write

Path Parameters

convoId*string

Convo ID

Match^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Properties1 <= properties

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  }}