Nurama Developers
Convos

Get all convos for a chat

Retrieve all convos (active, completed, or cancelled) for a specific chat. Results are sorted by creation time in descending order (newest first). Optionally filter by status. Requires read access to the chat (`canGetChat`) and an active workspace subscription.

GET
/chats/{chatId}/convos

Retrieve all convos (active, completed, or cancelled) for a specific chat. Results are sorted by creation time in descending order (newest first). Optionally filter by status. Requires read access to the chat (canGetChat) and an active workspace subscription.

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: chat:read

Path Parameters

chatId*string

Chat 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

Query Parameters

status?string

Filter convos by status

Value in

  • "active"
  • "completed"
  • "cancelled"

Response Body

application/json

curl -X GET "https://example.com/chats/497f6eca-6276-4993-bfeb-53cbbbba6f08/convos"
[  {    "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  }]