{ "info": { "_postman_id": "f8d42650-cb3b-451e-9c27-71f144b49e5b", "name": "RingCentral Adaptive Cards Conversations API", "description": "RingCentral API specification\n\nContact Support:\n Name: RingCentral Developers Support", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T02:49:18.000Z", "updatedAt": "2026-07-28T02:49:18.000Z", "lastUpdatedBy": "35240", "uid": "35240-f8d42650-cb3b-451e-9c27-71f144b49e5b" }, "item": [ { "name": "team-messaging", "item": [ { "name": "v1", "item": [ { "name": "conversations", "item": [ { "name": "{chatId}", "item": [ { "name": "Get Conversation", "id": "b253e0a0-75fc-4a90-96c8-b2dfa08f5699", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/team-messaging/v1/conversations/:chatId", "host": [ "{{baseUrl}}" ], "path": [ "team-messaging", "v1", "conversations", ":chatId" ], "variable": [ { "id": "0af2e2f2-d670-4009-99a0-d1932be40d06", "key": "chatId", "value": "", "description": "(Required) Internal identifier of a conversation to be returned." } ] }, "description": "Returns information about the specified conversation, including the list of conversation participants. A conversation is an adhoc discussion between a particular set of users, not featuring any specific name or description; it is a chat of 'Group' type. If you add a person to the existing conversation, it creates a whole new conversation." }, "response": [ { "id": "73bd220b-6254-44f7-a9f3-3573e1aa23d5", "name": "Success", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/team-messaging/v1/conversations/:chatId", "host": [ "{{baseUrl}}" ], "path": [ "team-messaging", "v1", "conversations", ":chatId" ], "variable": [ { "key": "chatId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"type\": \"Group\",\n \"creationTime\": \"\",\n \"lastModifiedTime\": \"\",\n \"members\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:49:18.000Z", "updatedAt": "2026-07-28T02:49:18.000Z", "uid": "35240-73bd220b-6254-44f7-a9f3-3573e1aa23d5" }, { "id": "ccd82c1e-2a69-4470-aeb2-2fd852140553", "name": "Conversation Not Found.", "originalRequest": { "method": "GET", "header": [ { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/team-messaging/v1/conversations/:chatId", "host": [ "{{baseUrl}}" ], "path": [ "team-messaging", "v1", "conversations", ":chatId" ], "variable": [ { "key": "chatId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:49:18.000Z", "updatedAt": "2026-07-28T02:49:18.000Z", "uid": "35240-ccd82c1e-2a69-4470-aeb2-2fd852140553" } ], "createdAt": "2026-07-28T02:49:18.000Z", "updatedAt": "2026-07-28T02:49:18.000Z", "uid": "35240-b253e0a0-75fc-4a90-96c8-b2dfa08f5699" } ], "id": "e796f54b-115e-4fa3-8877-499876a68091", "createdAt": "2026-07-28T02:49:18.000Z", "updatedAt": "2026-07-28T02:49:18.000Z", "uid": "35240-e796f54b-115e-4fa3-8877-499876a68091" }, { "name": "List Conversations", "id": "9782c4f7-2be8-4916-ab2f-30d561be0ead", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/team-messaging/v1/conversations?recordCount=30&pageToken=", "host": [ "{{baseUrl}}" ], "path": [ "team-messaging", "v1", "conversations" ], "query": [ { "description": "Number of conversations to be fetched by one request. The maximum value is 250, by default - 30", "key": "recordCount", "value": "30" }, { "description": "Pagination token.", "key": "pageToken", "value": "" } ] }, "description": "Returns the list of conversations where the user is a member. All records in response are sorted by creation time of a conversation in ascending order. Conversation is a chat of the *Group* type." }, "response": [ { "id": "cf222836-1ebe-4183-b25e-2c8d6499c81b", "name": "OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/team-messaging/v1/conversations?recordCount=30&pageToken=", "host": [ "{{baseUrl}}" ], "path": [ "team-messaging", "v1", "conversations" ], "query": [ { "description": "Number of conversations to be fetched by one request. The maximum value is 250, by default - 30", "key": "recordCount", "value": "30" }, { "description": "Pagination token.", "key": "pageToken", "value": "" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"records\": [\n {\n \"id\": \"\",\n \"type\": \"Direct\",\n \"creationTime\": \"\",\n \"lastModifiedTime\": \"\",\n \"members\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n },\n {\n \"id\": \"\",\n \"type\": \"Direct\",\n \"creationTime\": \"\",\n \"lastModifiedTime\": \"\",\n \"members\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n }\n ],\n \"navigation\": {\n \"prevPageToken\": \"\",\n \"nextPageToken\": \"\"\n }\n}", "createdAt": "2026-07-28T02:49:18.000Z", "updatedAt": "2026-07-28T02:49:18.000Z", "uid": "35240-cf222836-1ebe-4183-b25e-2c8d6499c81b" } ], "createdAt": "2026-07-28T02:49:18.000Z", "updatedAt": "2026-07-28T02:49:18.000Z", "uid": "35240-9782c4f7-2be8-4916-ab2f-30d561be0ead" }, { "name": "Create/Open Conversation", "id": "6f6c8ee7-25d2-42c0-b1df-afa0f72395c4", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"members\": [\n {\n \"id\": \"\",\n \"email\": \"\"\n },\n {\n \"id\": \"\",\n \"email\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/team-messaging/v1/conversations", "host": [ "{{baseUrl}}" ], "path": [ "team-messaging", "v1", "conversations" ] }, "description": "Creates a new conversation or opens the existing one. If the conversation already exists, then its ID will be returned in response. A conversation is an adhoc discussion between a particular set of users, not featuring any specific name or description; it is a chat of 'Group' type. If you add a person to the existing conversation (group), it creates a whole new conversation." }, "response": [ { "id": "81dc680b-4c22-4e76-8819-25bb74f27961", "name": "Conversation is opened", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"members\": [\n {\n \"id\": \"\",\n \"email\": \"\"\n },\n {\n \"id\": \"\",\n \"email\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/team-messaging/v1/conversations", "host": [ "{{baseUrl}}" ], "path": [ "team-messaging", "v1", "conversations" ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"type\": \"Group\",\n \"creationTime\": \"\",\n \"lastModifiedTime\": \"\",\n \"members\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:49:18.000Z", "updatedAt": "2026-07-28T02:49:18.000Z", "uid": "35240-81dc680b-4c22-4e76-8819-25bb74f27961" }, { "id": "b5c1ad2c-7dbf-4c6b-bc85-30b7297b7bb9", "name": "Conversation is created", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"members\": [\n {\n \"id\": \"\",\n \"email\": \"\"\n },\n {\n \"id\": \"\",\n \"email\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/team-messaging/v1/conversations", "host": [ "{{baseUrl}}" ], "path": [ "team-messaging", "v1", "conversations" ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"type\": \"Group\",\n \"creationTime\": \"\",\n \"lastModifiedTime\": \"\",\n \"members\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:49:18.000Z", "updatedAt": "2026-07-28T02:49:18.000Z", "uid": "35240-b5c1ad2c-7dbf-4c6b-bc85-30b7297b7bb9" }, { "id": "bcff28c0-6306-438d-9a6f-e2fb91a9fd7a", "name": "Some of the parameters are missing or have invalid format", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"members\": [\n {\n \"id\": \"\",\n \"email\": \"\"\n },\n {\n \"id\": \"\",\n \"email\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/team-messaging/v1/conversations", "host": [ "{{baseUrl}}" ], "path": [ "team-messaging", "v1", "conversations" ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:49:18.000Z", "updatedAt": "2026-07-28T02:49:18.000Z", "uid": "35240-bcff28c0-6306-438d-9a6f-e2fb91a9fd7a" } ], "createdAt": "2026-07-28T02:49:18.000Z", "updatedAt": "2026-07-28T02:49:18.000Z", "uid": "35240-6f6c8ee7-25d2-42c0-b1df-afa0f72395c4" } ], "id": "cb52b03c-6a11-45ce-bc75-7cde4bac3fc3", "createdAt": "2026-07-28T02:49:18.000Z", "updatedAt": "2026-07-28T02:49:18.000Z", "uid": "35240-cb52b03c-6a11-45ce-bc75-7cde4bac3fc3" } ], "id": "317e6790-acad-460d-800f-351c971537fd", "createdAt": "2026-07-28T02:49:18.000Z", "updatedAt": "2026-07-28T02:49:18.000Z", "uid": "35240-317e6790-acad-460d-800f-351c971537fd" } ], "id": "3739b93e-76f2-482b-beff-0340dc345616", "createdAt": "2026-07-28T02:49:18.000Z", "updatedAt": "2026-07-28T02:49:18.000Z", "uid": "35240-3739b93e-76f2-482b-beff-0340dc345616" } ], "auth": { "type": "oauth2", "oauth2": [ { "key": "redirect_uri", "value": "https://platform.ringcentral.com/restapi/oauth/token", "type": "string" }, { "key": "accessTokenUrl", "value": "https://platform.ringcentral.com/restapi/oauth/token", "type": "string" }, { "key": "authUrl", "value": "https://platform.ringcentral.com/restapi/oauth/authorize", "type": "string" }, { "key": "grant_type", "value": "authorization_code", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://platform.ringcentral.com" } ] }