{ "info": { "_postman_id": "e0301987-fa8e-49af-a75a-d7ef9c7680e4", "name": "RingCentral Adaptive Cards Devices 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:21.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "lastUpdatedBy": "35240", "uid": "35240-e0301987-fa8e-49af-a75a-d7ef9c7680e4" }, "item": [ { "name": "restapi", "item": [ { "name": "v2", "item": [ { "name": "accounts", "item": [ { "name": "{accountId}", "item": [ { "name": "device-inventory", "item": [ { "name": "Add Phone to Inventory", "id": "cc61dfd7-ccef-449b-9e6b-91870460c115", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"type\": \"OtherPhone\",\n \"quantity\": \"\",\n \"site\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v2/accounts/:accountId/device-inventory", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v2", "accounts", ":accountId", "device-inventory" ], "variable": [ { "id": "b79ccbbd-9a57-4189-9934-412cf92d5cef", "key": "accountId", "value": "~", "description": "(Required) Internal identifier of the RingCentral account\n(can be set to \"~\" to indicate that the account associated with current authorization session should be used)\n" } ] }, "description": "Adds an existing phone (customer provided device - BYOD) as an unassigned device to the account inventory." }, "response": [ { "id": "ab38bc5f-4146-40b7-bca9-41bc66cd5d65", "name": "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 \"type\": \"OtherPhone\",\n \"quantity\": \"\",\n \"site\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v2/accounts/:accountId/device-inventory", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v2", "accounts", ":accountId", "device-inventory" ], "variable": [ { "key": "accountId" } ] } }, "status": "Created", "code": 201, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"devices\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ],\n \"site\": {\n \"id\": \"\",\n \"name\": \"\"\n }\n}", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-ab38bc5f-4146-40b7-bca9-41bc66cd5d65" }, { "id": "6cf4c726-851b-422d-8458-4345e58e5503", "name": "General response with **HTTP 400 \"Bad request\"** status.
\nReasons: unparsable request, path, query or body parameters are invalid.\nThe error description may contain reference to particular parameter(s) which haven't passed the validation.\n", "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 \"type\": \"OtherPhone\",\n \"quantity\": \"\",\n \"site\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v2/accounts/:accountId/device-inventory", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v2", "accounts", ":accountId", "device-inventory" ], "variable": [ { "key": "accountId" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"errorCode\": \"\",\n \"message\": \"\",\n \"parameterName\": \"\",\n \"parameterValue\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-6cf4c726-851b-422d-8458-4345e58e5503" }, { "id": "c334334c-a937-464c-8408-910734216e5a", "name": "General response with **HTTP 403 \"Forbidden\"** status.
\nReasons: the requested operation is forbidden because of certain resource state, lack of permissions, feature unavailability, etc.\n", "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 \"type\": \"OtherPhone\",\n \"quantity\": \"\",\n \"site\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v2/accounts/:accountId/device-inventory", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v2", "accounts", ":accountId", "device-inventory" ], "variable": [ { "key": "accountId" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"errorCode\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-c334334c-a937-464c-8408-910734216e5a" }, { "id": "87f20228-6d9d-42bb-a15b-fce42fdfa8bc", "name": "General response with **HTTP 404 \"Not found\"** status.
\nReasons: the entity with given ID (typically specified in a path parameter), is not found or inaccessible\n", "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 \"type\": \"OtherPhone\",\n \"quantity\": \"\",\n \"site\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v2/accounts/:accountId/device-inventory", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v2", "accounts", ":accountId", "device-inventory" ], "variable": [ { "key": "accountId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"errorCode\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-87f20228-6d9d-42bb-a15b-fce42fdfa8bc" }, { "id": "2cd78835-dba4-4b26-a6aa-077ef33c5081", "name": "General response with **HTTP 429 \"Too many requests\"** status.
\nReasons: certain rate limit is exceeded.\n", "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 \"type\": \"OtherPhone\",\n \"quantity\": \"\",\n \"site\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v2/accounts/:accountId/device-inventory", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v2", "accounts", ":accountId", "device-inventory" ], "variable": [ { "key": "accountId" } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"errorCode\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-2cd78835-dba4-4b26-a6aa-077ef33c5081" }, { "id": "400f6790-f691-4612-a976-d87fe7864d72", "name": "General response with **HTTP 500 \"Internal Server Error\"** status.
\nReasons: general server-side error.\n", "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 \"type\": \"OtherPhone\",\n \"quantity\": \"\",\n \"site\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v2/accounts/:accountId/device-inventory", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v2", "accounts", ":accountId", "device-inventory" ], "variable": [ { "key": "accountId" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"errorCode\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-400f6790-f691-4612-a976-d87fe7864d72" }, { "id": "a79d59a8-2d28-4565-b55b-7ced2807be4f", "name": "General response with **HTTP 503 \"Service not available\"** status.
\nReasons: server cannot process the request because of being overloaded, misconfiguration or other issues.\n", "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 \"type\": \"OtherPhone\",\n \"quantity\": \"\",\n \"site\": {\n \"id\": \"\"\n }\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v2/accounts/:accountId/device-inventory", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v2", "accounts", ":accountId", "device-inventory" ], "variable": [ { "key": "accountId" } ] } }, "status": "Service Unavailable", "code": 503, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"errorCode\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-a79d59a8-2d28-4565-b55b-7ced2807be4f" } ], "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-cc61dfd7-ccef-449b-9e6b-91870460c115" }, { "name": "Delete Device from Inventory", "id": "42ac0c75-3a00-4c8b-9370-5b2d845bdccd", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"records\": [\n {\n \"deviceId\": \"\"\n },\n {\n \"deviceId\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v2/accounts/:accountId/device-inventory", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v2", "accounts", ":accountId", "device-inventory" ], "variable": [ { "id": "2866c6d9-3e8c-4375-ae93-eed0c1ac8f46", "key": "accountId", "value": "~", "description": "(Required) Internal identifier of the RingCentral account\n(can be set to \"~\" to indicate that the account associated with current authorization session should be used)\n" } ] }, "description": "Deletes an existing unassigned (without digital line or phone number) device or multiple devices\nfrom the account inventory. It is possible to delete up to 10 devices per request.\n" }, "response": [ { "id": "fb951852-f89d-400d-b58a-29ed3b3e42d7", "name": "Successful operation", "originalRequest": { "method": "DELETE", "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 \"records\": [\n {\n \"deviceId\": \"\"\n },\n {\n \"deviceId\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v2/accounts/:accountId/device-inventory", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v2", "accounts", ":accountId", "device-inventory" ], "variable": [ { "key": "accountId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"records\": [\n {\n \"bulkItemSuccessful\": \"\",\n \"deviceId\": \"\",\n \"bulkItemErrors\": [\n {\n \"errorCode\": \"\",\n \"message\": \"\"\n }\n ]\n },\n {\n \"bulkItemSuccessful\": \"\",\n \"deviceId\": \"\",\n \"bulkItemErrors\": [\n {\n \"errorCode\": \"\",\n \"message\": \"\"\n }\n ]\n }\n ]\n}", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-fb951852-f89d-400d-b58a-29ed3b3e42d7" }, { "id": "47cf43f6-bc8a-4497-8ac9-d520c2a4aebf", "name": "General response with **HTTP 400 \"Bad request\"** status.
\nReasons: unparsable request, path, query or body parameters are invalid.\nThe error description may contain reference to particular parameter(s) which haven't passed the validation.\n", "originalRequest": { "method": "DELETE", "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 \"records\": [\n {\n \"deviceId\": \"\"\n },\n {\n \"deviceId\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v2/accounts/:accountId/device-inventory", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v2", "accounts", ":accountId", "device-inventory" ], "variable": [ { "key": "accountId" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"errorCode\": \"\",\n \"message\": \"\",\n \"parameterName\": \"\",\n \"parameterValue\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-47cf43f6-bc8a-4497-8ac9-d520c2a4aebf" }, { "id": "12d68f44-fcfb-4872-87db-4d9bd879f84c", "name": "General response with **HTTP 403 \"Forbidden\"** status.
\nReasons: the requested operation is forbidden because of certain resource state, lack of permissions, feature unavailability, etc.\n", "originalRequest": { "method": "DELETE", "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 \"records\": [\n {\n \"deviceId\": \"\"\n },\n {\n \"deviceId\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v2/accounts/:accountId/device-inventory", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v2", "accounts", ":accountId", "device-inventory" ], "variable": [ { "key": "accountId" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"errorCode\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-12d68f44-fcfb-4872-87db-4d9bd879f84c" }, { "id": "37b7f5fc-bfb6-480e-9cb9-a06e4625ebaa", "name": "General response with **HTTP 429 \"Too many requests\"** status.
\nReasons: certain rate limit is exceeded.\n", "originalRequest": { "method": "DELETE", "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 \"records\": [\n {\n \"deviceId\": \"\"\n },\n {\n \"deviceId\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v2/accounts/:accountId/device-inventory", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v2", "accounts", ":accountId", "device-inventory" ], "variable": [ { "key": "accountId" } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"errorCode\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-37b7f5fc-bfb6-480e-9cb9-a06e4625ebaa" }, { "id": "9f26ae86-ec1a-414f-9c91-3cc94b3866ff", "name": "General response with **HTTP 500 \"Internal Server Error\"** status.
\nReasons: general server-side error.\n", "originalRequest": { "method": "DELETE", "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 \"records\": [\n {\n \"deviceId\": \"\"\n },\n {\n \"deviceId\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v2/accounts/:accountId/device-inventory", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v2", "accounts", ":accountId", "device-inventory" ], "variable": [ { "key": "accountId" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"errorCode\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-9f26ae86-ec1a-414f-9c91-3cc94b3866ff" }, { "id": "82eac010-0ef8-4710-8f3b-2f8d8a727a28", "name": "General response with **HTTP 503 \"Service not available\"** status.
\nReasons: server cannot process the request because of being overloaded, misconfiguration or other issues.\n", "originalRequest": { "method": "DELETE", "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 \"records\": [\n {\n \"deviceId\": \"\"\n },\n {\n \"deviceId\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v2/accounts/:accountId/device-inventory", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v2", "accounts", ":accountId", "device-inventory" ], "variable": [ { "key": "accountId" } ] } }, "status": "Service Unavailable", "code": 503, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"errorCode\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-82eac010-0ef8-4710-8f3b-2f8d8a727a28" } ], "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-42ac0c75-3a00-4c8b-9370-5b2d845bdccd" } ], "id": "25387f57-3000-4cc1-b59b-d8e5ba53c48b", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-25387f57-3000-4cc1-b59b-d8e5ba53c48b" }, { "name": "devices", "item": [ { "name": "{deviceId}", "item": [ { "name": "Remove phone line", "id": "af40d14c-3256-4e0f-aa2d-9c07e30c2b87", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"keepAssetsInInventory\": true\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v2/accounts/:accountId/devices/:deviceId", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v2", "accounts", ":accountId", "devices", ":deviceId" ], "variable": [ { "id": "b5aa365f-e772-45ac-876f-58df8a4f9d5a", "key": "accountId", "value": "~", "description": "(Required) Internal identifier of the RingCentral account\n(can be set to \"~\" to indicate that the account associated with current authorization session should be used)\n" }, { "id": "82e7a12f-1356-4ffb-8431-5eedc940539f", "key": "deviceId", "value": "", "description": "(Required) Internal identifier of a source device" } ] }, "description": "Disassociates a phone line (DL & Device) from an extension:\n\n - if the value of `keepAssetsInInventory` is `true`,\nthe given device is moved to unassigned devices and the number is moved to the number inventory;\n - if the value of `keepAssetsInInventory` is `false`, the given device and number is removed from the account;\n - if the parameter `keepAssetsInInventory` is not set (empty body), default value `true` is set.\n" }, "response": [ { "id": "12e896d9-364a-418e-8cdd-357ed0bc58c7", "name": "Successful response (when `keepAssetsInInventory` is `true`)\n", "originalRequest": { "method": "DELETE", "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 \"keepAssetsInInventory\": true\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v2/accounts/:accountId/devices/:deviceId", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v2", "accounts", ":accountId", "devices", ":deviceId" ], "variable": [ { "key": "accountId" }, { "key": "deviceId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"type\": \"HardPhone\",\n \"name\": \"\",\n \"serial\": \"\"\n}", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-12e896d9-364a-418e-8cdd-357ed0bc58c7" }, { "id": "06206a23-1d44-4e2b-87b5-d3dd920c1400", "name": "Successful response (when `keepAssetsInInventory` is `false`)\n", "originalRequest": { "method": "DELETE", "header": [ { "key": "Content-Type", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"keepAssetsInInventory\": true\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v2/accounts/:accountId/devices/:deviceId", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v2", "accounts", ":accountId", "devices", ":deviceId" ], "variable": [ { "key": "accountId" }, { "key": "deviceId" } ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-06206a23-1d44-4e2b-87b5-d3dd920c1400" }, { "id": "409dfd97-8c7b-4b1f-a439-56607913facb", "name": "General response with **HTTP 400 \"Bad request\"** status.
\nReasons: unparsable request, path, query or body parameters are invalid.\nThe error description may contain reference to particular parameter(s) which haven't passed the validation.\n", "originalRequest": { "method": "DELETE", "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 \"keepAssetsInInventory\": true\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v2/accounts/:accountId/devices/:deviceId", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v2", "accounts", ":accountId", "devices", ":deviceId" ], "variable": [ { "key": "accountId" }, { "key": "deviceId" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"errorCode\": \"\",\n \"message\": \"\",\n \"parameterName\": \"\",\n \"parameterValue\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-409dfd97-8c7b-4b1f-a439-56607913facb" }, { "id": "075a56d2-bc25-496b-bfbb-55cf88345824", "name": "General response with **HTTP 404 \"Not found\"** status.
\nReasons: the entity with given ID (typically specified in a path parameter), is not found or inaccessible\n", "originalRequest": { "method": "DELETE", "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 \"keepAssetsInInventory\": true\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v2/accounts/:accountId/devices/:deviceId", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v2", "accounts", ":accountId", "devices", ":deviceId" ], "variable": [ { "key": "accountId" }, { "key": "deviceId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"errorCode\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-075a56d2-bc25-496b-bfbb-55cf88345824" }, { "id": "3a1844cd-149f-4859-b9a0-0cf592068b20", "name": "General response with **HTTP 500 \"Internal Server Error\"** status.
\nReasons: general server-side error.\n", "originalRequest": { "method": "DELETE", "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 \"keepAssetsInInventory\": true\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v2/accounts/:accountId/devices/:deviceId", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v2", "accounts", ":accountId", "devices", ":deviceId" ], "variable": [ { "key": "accountId" }, { "key": "deviceId" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"errorCode\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-3a1844cd-149f-4859-b9a0-0cf592068b20" } ], "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-af40d14c-3256-4e0f-aa2d-9c07e30c2b87" } ], "id": "a0711164-c419-48b6-bb01-fbae9cca9356", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-a0711164-c419-48b6-bb01-fbae9cca9356" }, { "name": "bulk-add", "item": [ { "name": "Add BYOD Devices", "id": "1f5d1186-2dee-419a-92bf-f2958bf55a72", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"records\": [\n {\n \"emergency\": {\n \"address\": {\n \"street\": \"\",\n \"city\": \"\",\n \"zip\": \"\",\n \"country\": \"\",\n \"street2\": \"\",\n \"state\": \"\"\n }\n },\n \"extension\": {\n \"id\": \"\"\n },\n \"phoneInfo\": {\n \"tollType\": \"Toll\"\n },\n \"type\": \"OtherPhone\",\n \"costCenterId\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v2/accounts/:accountId/devices/bulk-add", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v2", "accounts", ":accountId", "devices", "bulk-add" ], "variable": [ { "id": "7136b46f-d71e-458d-9639-f538f7d749b8", "key": "accountId", "value": "~", "description": "(Required) Internal identifier of the RingCentral account\n(can be set to \"~\" to indicate that the account associated with current authorization session should be used)\n" } ] }, "description": "Adds multiple BYOD (customer provided) devices to an account." }, "response": [ { "id": "b87762f4-db3b-40bf-a194-0582f726c900", "name": "Successful response", "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 \"records\": [\n {\n \"emergency\": {\n \"address\": {\n \"street\": \"\",\n \"city\": \"\",\n \"zip\": \"\",\n \"country\": \"\",\n \"street2\": \"\",\n \"state\": \"\"\n }\n },\n \"extension\": {\n \"id\": \"\"\n },\n \"phoneInfo\": {\n \"tollType\": \"Toll\"\n },\n \"type\": \"OtherPhone\",\n \"costCenterId\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v2/accounts/:accountId/devices/bulk-add", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v2", "accounts", ":accountId", "devices", "bulk-add" ], "variable": [ { "key": "accountId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"results\": [\n {\n \"successful\": \"\",\n \"id\": \"\",\n \"extension\": {\n \"id\": \"\"\n },\n \"phoneNumber\": \"+358963507217\"\n },\n {\n \"successful\": \"\",\n \"id\": \"\",\n \"extension\": {\n \"id\": \"\"\n },\n \"phoneNumber\": \"+839\"\n }\n ]\n}", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-b87762f4-db3b-40bf-a194-0582f726c900" }, { "id": "f1751a69-c169-484e-85d5-4f0a8ef78c81", "name": "General response with **HTTP 400 \"Bad request\"** status.
\nReasons: unparsable request, path, query or body parameters are invalid.\nThe error description may contain reference to particular parameter(s) which haven't passed the validation.\n", "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 \"records\": [\n {\n \"emergency\": {\n \"address\": {\n \"street\": \"\",\n \"city\": \"\",\n \"zip\": \"\",\n \"country\": \"\",\n \"street2\": \"\",\n \"state\": \"\"\n }\n },\n \"extension\": {\n \"id\": \"\"\n },\n \"phoneInfo\": {\n \"tollType\": \"Toll\"\n },\n \"type\": \"OtherPhone\",\n \"costCenterId\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v2/accounts/:accountId/devices/bulk-add", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v2", "accounts", ":accountId", "devices", "bulk-add" ], "variable": [ { "key": "accountId" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"errorCode\": \"\",\n \"message\": \"\",\n \"parameterName\": \"\",\n \"parameterValue\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-f1751a69-c169-484e-85d5-4f0a8ef78c81" }, { "id": "4f9a9a94-8c7c-459c-84e6-001675c62078", "name": "General response with **HTTP 403 \"Forbidden\"** status.
\nReasons: the requested operation is forbidden because of certain resource state, lack of permissions, feature unavailability, etc.\n", "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 \"records\": [\n {\n \"emergency\": {\n \"address\": {\n \"street\": \"\",\n \"city\": \"\",\n \"zip\": \"\",\n \"country\": \"\",\n \"street2\": \"\",\n \"state\": \"\"\n }\n },\n \"extension\": {\n \"id\": \"\"\n },\n \"phoneInfo\": {\n \"tollType\": \"Toll\"\n },\n \"type\": \"OtherPhone\",\n \"costCenterId\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v2/accounts/:accountId/devices/bulk-add", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v2", "accounts", ":accountId", "devices", "bulk-add" ], "variable": [ { "key": "accountId" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"errorCode\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-4f9a9a94-8c7c-459c-84e6-001675c62078" }, { "id": "51c57d23-019c-41e2-ab21-0f5ed1da2476", "name": "General response with **HTTP 404 \"Not found\"** status.
\nReasons: the entity with given ID (typically specified in a path parameter), is not found or inaccessible\n", "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 \"records\": [\n {\n \"emergency\": {\n \"address\": {\n \"street\": \"\",\n \"city\": \"\",\n \"zip\": \"\",\n \"country\": \"\",\n \"street2\": \"\",\n \"state\": \"\"\n }\n },\n \"extension\": {\n \"id\": \"\"\n },\n \"phoneInfo\": {\n \"tollType\": \"Toll\"\n },\n \"type\": \"OtherPhone\",\n \"costCenterId\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v2/accounts/:accountId/devices/bulk-add", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v2", "accounts", ":accountId", "devices", "bulk-add" ], "variable": [ { "key": "accountId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"errorCode\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-51c57d23-019c-41e2-ab21-0f5ed1da2476" }, { "id": "2d3107fe-bc6a-4755-a241-7099a28a7d1b", "name": "General response with **HTTP 429 \"Too many requests\"** status.
\nReasons: certain rate limit is exceeded.\n", "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 \"records\": [\n {\n \"emergency\": {\n \"address\": {\n \"street\": \"\",\n \"city\": \"\",\n \"zip\": \"\",\n \"country\": \"\",\n \"street2\": \"\",\n \"state\": \"\"\n }\n },\n \"extension\": {\n \"id\": \"\"\n },\n \"phoneInfo\": {\n \"tollType\": \"Toll\"\n },\n \"type\": \"OtherPhone\",\n \"costCenterId\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v2/accounts/:accountId/devices/bulk-add", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v2", "accounts", ":accountId", "devices", "bulk-add" ], "variable": [ { "key": "accountId" } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"errorCode\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-2d3107fe-bc6a-4755-a241-7099a28a7d1b" }, { "id": "2c50787f-d90b-48bf-9705-9b61fecf0b58", "name": "General response with **HTTP 500 \"Internal Server Error\"** status.
\nReasons: general server-side error.\n", "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 \"records\": [\n {\n \"emergency\": {\n \"address\": {\n \"street\": \"\",\n \"city\": \"\",\n \"zip\": \"\",\n \"country\": \"\",\n \"street2\": \"\",\n \"state\": \"\"\n }\n },\n \"extension\": {\n \"id\": \"\"\n },\n \"phoneInfo\": {\n \"tollType\": \"Toll\"\n },\n \"type\": \"OtherPhone\",\n \"costCenterId\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v2/accounts/:accountId/devices/bulk-add", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v2", "accounts", ":accountId", "devices", "bulk-add" ], "variable": [ { "key": "accountId" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"errorCode\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-2c50787f-d90b-48bf-9705-9b61fecf0b58" }, { "id": "86094cb0-ea5f-44b8-82f1-c3e429de057e", "name": "General response with **HTTP 503 \"Service not available\"** status.
\nReasons: server cannot process the request because of being overloaded, misconfiguration or other issues.\n", "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 \"records\": [\n {\n \"emergency\": {\n \"address\": {\n \"street\": \"\",\n \"city\": \"\",\n \"zip\": \"\",\n \"country\": \"\",\n \"street2\": \"\",\n \"state\": \"\"\n }\n },\n \"extension\": {\n \"id\": \"\"\n },\n \"phoneInfo\": {\n \"tollType\": \"Toll\"\n },\n \"type\": \"OtherPhone\",\n \"costCenterId\": \"\"\n }\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v2/accounts/:accountId/devices/bulk-add", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v2", "accounts", ":accountId", "devices", "bulk-add" ], "variable": [ { "key": "accountId" } ] } }, "status": "Service Unavailable", "code": 503, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"errorCode\": \"\",\n \"message\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-86094cb0-ea5f-44b8-82f1-c3e429de057e" } ], "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-1f5d1186-2dee-419a-92bf-f2958bf55a72" } ], "id": "04f3059e-36c7-45af-adc7-59bfdad3c222", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-04f3059e-36c7-45af-adc7-59bfdad3c222" } ], "id": "ce222d3b-b150-49ea-95eb-d328fe538a40", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-ce222d3b-b150-49ea-95eb-d328fe538a40" }, { "name": "extensions", "item": [ { "name": "{extensionId}", "item": [ { "name": "devices", "item": [ { "name": "{deviceId}", "item": [ { "name": "replace", "item": [ { "name": "Swap Devices", "id": "f85a0f56-93ba-44af-b9b1-951641b11c7b", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"targetDeviceId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v2/accounts/:accountId/extensions/:extensionId/devices/:deviceId/replace", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v2", "accounts", ":accountId", "extensions", ":extensionId", "devices", ":deviceId", "replace" ], "variable": [ { "id": "0f128ecd-6884-40aa-a557-31ddf89ea80d", "key": "accountId", "value": "~", "description": "(Required) Internal identifier of the RingCentral account\n(can be set to \"~\" to indicate that the account associated with current authorization session should be used)\n" }, { "id": "8b1502ed-6c14-434c-b75e-f5978c9e45c1", "key": "extensionId", "value": "~", "description": "(Required) Internal identifier of the RingCentral extension/user\n(can be set to \"~\" to indicate that the extension associated with current authorization session should be used)\n" }, { "id": "644b363a-19f5-4293-86f3-2948cc5ea0bd", "key": "deviceId", "value": "", "description": "(Required) Internal identifier of a source device that is currently assigned to the given extension" } ] }, "description": "Replaces the user device with another device, which is assigned to an extension\nor is stored in the inventory of the same account.\nCurrently, the following device types can be swapped - `HardPhone` and `OtherPhone`.\n\nPlease note:\n\n - This method allows replacing a device itself, while a phone number,\n a digital Line and an emergency address associated with this device remain unchanged\n and will still work together in a chain with the replacement device.\n - If a target device is from the inventory, then a source device will be moved\n to the inventory, and a target device will be assigned to the current extension.\n - If a target device is currently assigned to another extension,\n then the devices will be just swapped.\n" }, "response": [ { "id": "515ce7b2-ab82-49d9-b1b9-213df6829f7b", "name": "No content", "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 \"targetDeviceId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v2/accounts/:accountId/extensions/:extensionId/devices/:deviceId/replace", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v2", "accounts", ":accountId", "extensions", ":extensionId", "devices", ":deviceId", "replace" ], "variable": [ { "key": "accountId" }, { "key": "extensionId" }, { "key": "deviceId" } ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-515ce7b2-ab82-49d9-b1b9-213df6829f7b" }, { "id": "4c3ef585-fb1c-47f2-ab7f-b4da4f54cdd3", "name": "General response with **HTTP 400 \"Bad request\"** status.
\nReasons: unparsable request, path, query or body parameters are invalid.\nThe error description may contain reference to particular parameter(s) which haven't passed the validation.\n", "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 \"targetDeviceId\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v2/accounts/:accountId/extensions/:extensionId/devices/:deviceId/replace", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v2", "accounts", ":accountId", "extensions", ":extensionId", "devices", ":deviceId", "replace" ], "variable": [ { "key": "accountId" }, { "key": "extensionId" }, { "key": "deviceId" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"errors\": [\n {\n \"errorCode\": \"\",\n \"message\": \"\",\n \"parameterName\": \"\",\n \"parameterValue\": \"\"\n }\n ]\n}", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-4c3ef585-fb1c-47f2-ab7f-b4da4f54cdd3" } ], "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-f85a0f56-93ba-44af-b9b1-951641b11c7b" } ], "id": "33cbac72-af64-4399-a100-9eb1804d06a1", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-33cbac72-af64-4399-a100-9eb1804d06a1" } ], "id": "f7ba9054-1f81-45a0-9664-8bb187b87ebf", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-f7ba9054-1f81-45a0-9664-8bb187b87ebf" } ], "id": "9e67529a-d6b6-426e-a8d5-79483a45a227", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-9e67529a-d6b6-426e-a8d5-79483a45a227" } ], "id": "c6a7f3cf-6bd5-40f9-a607-86d7f534ce7d", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-c6a7f3cf-6bd5-40f9-a607-86d7f534ce7d" } ], "id": "9ff9b068-f4b6-4380-af8a-ac2ebf368f87", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-9ff9b068-f4b6-4380-af8a-ac2ebf368f87" } ], "id": "ca450991-6c62-4b3c-b70e-6a5d1d5c9cd7", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-ca450991-6c62-4b3c-b70e-6a5d1d5c9cd7" } ], "id": "72d577fa-a213-4394-a8a9-c441f3d18190", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-72d577fa-a213-4394-a8a9-c441f3d18190" } ], "id": "a9a0886e-8533-4b2b-8e70-e489da0fe683", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-a9a0886e-8533-4b2b-8e70-e489da0fe683" }, { "name": "v1.0", "item": [ { "name": "account", "item": [ { "name": "{accountId}", "item": [ { "name": "device", "item": [ { "name": "{deviceId}", "item": [ { "name": "sip-info", "item": [ { "name": "Get Device SIP Info", "id": "9949d017-fccd-439b-8dba-38e50105a40f", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/restapi/v1.0/account/:accountId/device/:deviceId/sip-info", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v1.0", "account", ":accountId", "device", ":deviceId", "sip-info" ], "variable": [ { "id": "8ebf371d-1f43-4a2e-8401-ea6ac71486ca", "key": "accountId", "value": "~", "description": "(Required) Internal identifier of the RingCentral account\n(can be set to \"~\" to indicate that the account associated with current authorization session should be used)\n" }, { "id": "eb0e9c4e-ff72-4263-8d6f-56261f2df4af", "key": "deviceId", "value": "", "description": "(Required) Internal identifier of a device" } ] }, "description": "Returns device SIP information." }, "response": [ { "id": "60270989-c76a-4c9b-89bf-36c3507dadeb", "name": "Device SIP information", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/restapi/v1.0/account/:accountId/device/:deviceId/sip-info", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v1.0", "account", ":accountId", "device", ":deviceId", "sip-info" ], "variable": [ { "key": "accountId" }, { "key": "deviceId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"domain\": \"\",\n \"outboundProxies\": [\n {\n \"region\": \"\",\n \"proxy\": \"\",\n \"proxyTLS\": \"\"\n },\n {\n \"region\": \"\",\n \"proxy\": \"\",\n \"proxyTLS\": \"\"\n }\n ],\n \"userName\": \"\",\n \"password\": \"\",\n \"authorizationId\": \"\"\n}", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-60270989-c76a-4c9b-89bf-36c3507dadeb" } ], "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-9949d017-fccd-439b-8dba-38e50105a40f" } ], "id": "9b034412-9ed7-40d7-941a-df879f3d4c73", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-9b034412-9ed7-40d7-941a-df879f3d4c73" }, { "name": "emergency", "item": [ { "name": "Update Device Emergency Info", "id": "6cd8633c-c918-4dec-8b81-6eba64ba8818", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"emergencyServiceAddress\": {\n \"street\": \"\",\n \"street2\": \"\",\n \"city\": \"\",\n \"zip\": \"\",\n \"customerName\": \"\",\n \"state\": \"\",\n \"stateId\": \"\",\n \"country\": \"\",\n \"countryId\": \"\"\n },\n \"emergency\": {\n \"address\": {\n \"country\": \"\",\n \"countryId\": \"\",\n \"countryIsoCode\": \"\",\n \"countryName\": \"\",\n \"state\": \"\",\n \"stateId\": \"\",\n \"stateIsoCode\": \"\",\n \"stateName\": \"\",\n \"city\": \"\",\n \"street\": \"\",\n \"street2\": \"\",\n \"zip\": \"\",\n \"customerName\": \"\"\n },\n \"location\": {\n \"id\": \"\",\n \"name\": \"\",\n \"addressFormatId\": \"\"\n },\n \"outOfCountry\": \"\",\n \"addressStatus\": \"Invalid\",\n \"visibility\": \"Public\",\n \"syncStatus\": \"Failed\",\n \"addressEditableStatus\": \"AnyDevice\"\n },\n \"extension\": {\n \"id\": \"\"\n },\n \"phoneLines\": {\n \"phoneLines\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n },\n \"useAsCommonPhone\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v1.0/account/:accountId/device/:deviceId/emergency", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v1.0", "account", ":accountId", "device", ":deviceId", "emergency" ], "variable": [ { "id": "11eb078f-2cc7-4f5a-bc3f-ab1be7a4999d", "key": "accountId", "value": "~", "description": "(Required) Internal identifier of the RingCentral account\n(can be set to \"~\" to indicate that the account associated with current authorization session should be used)\n" }, { "id": "de02c2f4-782a-4c9e-b674-a83addfb0997", "key": "deviceId", "value": "", "description": "(Required) Internal identifier of a device" } ] }, "description": "Updates account device emergency information." }, "response": [ { "id": "e8d89746-d10f-4cf9-a8bb-890b232c80c7", "name": "Updated emergency information of a device", "originalRequest": { "method": "PUT", "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 \"emergencyServiceAddress\": {\n \"street\": \"\",\n \"street2\": \"\",\n \"city\": \"\",\n \"zip\": \"\",\n \"customerName\": \"\",\n \"state\": \"\",\n \"stateId\": \"\",\n \"country\": \"\",\n \"countryId\": \"\"\n },\n \"emergency\": {\n \"address\": {\n \"country\": \"\",\n \"countryId\": \"\",\n \"countryIsoCode\": \"\",\n \"countryName\": \"\",\n \"state\": \"\",\n \"stateId\": \"\",\n \"stateIsoCode\": \"\",\n \"stateName\": \"\",\n \"city\": \"\",\n \"street\": \"\",\n \"street2\": \"\",\n \"zip\": \"\",\n \"customerName\": \"\"\n },\n \"location\": {\n \"id\": \"\",\n \"name\": \"\",\n \"addressFormatId\": \"\"\n },\n \"outOfCountry\": \"\",\n \"addressStatus\": \"Invalid\",\n \"visibility\": \"Public\",\n \"syncStatus\": \"Failed\",\n \"addressEditableStatus\": \"AnyDevice\"\n },\n \"extension\": {\n \"id\": \"\"\n },\n \"phoneLines\": {\n \"phoneLines\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n },\n \"useAsCommonPhone\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v1.0/account/:accountId/device/:deviceId/emergency", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v1.0", "account", ":accountId", "device", ":deviceId", "emergency" ], "variable": [ { "key": "accountId" }, { "key": "deviceId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"uri\": \"\",\n \"sku\": \"\",\n \"type\": \"HardPhone\",\n \"name\": \"\",\n \"serial\": \"\",\n \"status\": \"Online\",\n \"computerName\": \"\",\n \"model\": {\n \"id\": \"\",\n \"name\": \"\",\n \"addons\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"count\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"count\": \"\"\n }\n ],\n \"deviceClass\": \"\",\n \"features\": [\n \"BLA\",\n \"CommonPhone\"\n ],\n \"lineCount\": \"\"\n },\n \"extension\": {\n \"id\": \"\",\n \"uri\": \"\",\n \"extensionNumber\": \"\",\n \"partnerId\": \"\"\n },\n \"emergency\": {\n \"address\": {\n \"country\": \"\",\n \"countryId\": \"\",\n \"countryIsoCode\": \"\",\n \"countryName\": \"\",\n \"state\": \"\",\n \"stateId\": \"\",\n \"stateIsoCode\": \"\",\n \"stateName\": \"\",\n \"city\": \"\",\n \"street\": \"\",\n \"street2\": \"\",\n \"zip\": \"\",\n \"customerName\": \"\"\n },\n \"location\": {\n \"id\": \"\",\n \"name\": \"\",\n \"addressFormatId\": \"\"\n },\n \"outOfCountry\": \"\",\n \"addressStatus\": \"Invalid\",\n \"visibility\": \"Public\",\n \"syncStatus\": \"Unsupported\",\n \"addressEditableStatus\": \"MainDevice\"\n },\n \"emergencyServiceAddress\": {\n \"street\": \"\",\n \"street2\": \"\",\n \"city\": \"\",\n \"zip\": \"\",\n \"customerName\": \"\",\n \"state\": \"\",\n \"stateId\": \"\",\n \"stateIsoCode\": \"\",\n \"stateName\": \"\",\n \"countryId\": \"\",\n \"countryIsoCode\": \"\",\n \"country\": \"\",\n \"countryName\": \"\",\n \"outOfCountry\": \"\",\n \"syncStatus\": \"Failed\",\n \"additionalCustomerName\": \"\",\n \"customerEmail\": \"\",\n \"additionalCustomerEmail\": \"\",\n \"customerPhone\": \"\",\n \"additionalCustomerPhone\": \"\",\n \"lineProvisioningStatus\": \"Provisioning\",\n \"taxId\": \"\"\n },\n \"phoneLines\": [\n {\n \"id\": \"\",\n \"lineType\": \"StandaloneFree\",\n \"phoneInfo\": {\n \"id\": \"\",\n \"country\": {\n \"id\": \"\",\n \"uri\": \"\",\n \"name\": \"\"\n },\n \"extension\": {\n \"id\": \"\",\n \"uri\": \"\",\n \"extensionNumber\": \"\",\n \"partnerId\": \"\"\n },\n \"label\": \"\",\n \"location\": \"\",\n \"paymentType\": \"External\",\n \"phoneNumber\": \"\",\n \"status\": \"\",\n \"type\": \"FaxOnly\",\n \"usageType\": \"ForwardedCompanyNumber\"\n },\n \"emergencyAddress\": {\n \"required\": \"\",\n \"localOnly\": \"\",\n \"lineProvisioningStatus\": \"Invalid\"\n }\n },\n {\n \"id\": \"\",\n \"lineType\": \"Unknown\",\n \"phoneInfo\": {\n \"id\": \"\",\n \"country\": {\n \"id\": \"\",\n \"uri\": \"\",\n \"name\": \"\"\n },\n \"extension\": {\n \"id\": \"\",\n \"uri\": \"\",\n \"extensionNumber\": \"\",\n \"partnerId\": \"\"\n },\n \"label\": \"\",\n \"location\": \"\",\n \"paymentType\": \"External\",\n \"phoneNumber\": \"\",\n \"status\": \"\",\n \"type\": \"VoiceOnly\",\n \"usageType\": \"CompanyNumber\"\n },\n \"emergencyAddress\": {\n \"required\": \"\",\n \"localOnly\": \"\",\n \"lineProvisioningStatus\": \"Valid\"\n }\n }\n ],\n \"shipping\": {\n \"status\": \"Shipped\",\n \"carrier\": \"\",\n \"trackingNumber\": \"\",\n \"method\": {\n \"id\": \"1\",\n \"name\": \"Ground\"\n },\n \"address\": {\n \"customerName\": \"\",\n \"additionalCustomerName\": \"\",\n \"customerEmail\": \"\",\n \"additionalCustomerEmail\": \"\",\n \"customerPhone\": \"\",\n \"additionalCustomerPhone\": \"\",\n \"street\": \"\",\n \"street2\": \"\",\n \"city\": \"\",\n \"state\": \"\",\n \"stateId\": \"\",\n \"stateIsoCode\": \"\",\n \"stateName\": \"\",\n \"countryId\": \"\",\n \"countryIsoCode\": \"\",\n \"country\": \"\",\n \"countryName\": \"\",\n \"zip\": \"\",\n \"taxId\": \"\"\n }\n },\n \"boxBillingId\": \"\",\n \"useAsCommonPhone\": \"\",\n \"hotDeskDevice\": \"\",\n \"inCompanyNet\": \"\",\n \"site\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"lastLocationReportTime\": \"\",\n \"linePooling\": \"None\",\n \"billingStatement\": {\n \"currency\": \"\",\n \"charges\": [\n {\n \"description\": \"\",\n \"amount\": \"\",\n \"feature\": \"\",\n \"freeServiceCredit\": \"\"\n },\n {\n \"description\": \"\",\n \"amount\": \"\",\n \"feature\": \"\",\n \"freeServiceCredit\": \"\"\n }\n ],\n \"fees\": [\n {\n \"description\": \"\",\n \"amount\": \"\",\n \"freeServiceCredit\": \"\"\n },\n {\n \"description\": \"\",\n \"amount\": \"\",\n \"freeServiceCredit\": \"\"\n }\n ],\n \"totalCharged\": \"\",\n \"totalCharges\": \"\",\n \"totalFees\": \"\",\n \"subtotal\": \"\",\n \"totalFreeServiceCredit\": \"\"\n }\n}", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-e8d89746-d10f-4cf9-a8bb-890b232c80c7" } ], "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-6cd8633c-c918-4dec-8b81-6eba64ba8818" } ], "id": "c63ceea4-3c5e-4028-a950-71044a607688", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-c63ceea4-3c5e-4028-a950-71044a607688" }, { "name": "Get Device", "id": "e2fb2d7f-faee-4e3a-ac16-fa0a0e1aa1a2", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/restapi/v1.0/account/:accountId/device/:deviceId?syncEmergencyAddress=false", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v1.0", "account", ":accountId", "device", ":deviceId" ], "query": [ { "description": "Specifies if an emergency address should be synchronized or not", "key": "syncEmergencyAddress", "value": "false" } ], "variable": [ { "id": "44ee2d37-5b29-4055-a1f7-7bb43e55ec28", "key": "accountId", "value": "~", "description": "(Required) Internal identifier of the RingCentral account\n(can be set to \"~\" to indicate that the account associated with current authorization session should be used)\n" }, { "id": "2fee80a4-cfdc-4a93-b40a-cd8d2c199a28", "key": "deviceId", "value": "", "description": "(Required) Internal identifier of a device" } ] }, "description": "Returns account device(s) by their ID(s)." }, "response": [ { "id": "cd2cfac6-1932-4f9c-b114-2d0143d37683", "name": "Account device(s) information", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/restapi/v1.0/account/:accountId/device/:deviceId?syncEmergencyAddress=false", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v1.0", "account", ":accountId", "device", ":deviceId" ], "query": [ { "description": "Specifies if an emergency address should be synchronized or not", "key": "syncEmergencyAddress", "value": "false" } ], "variable": [ { "key": "accountId" }, { "key": "deviceId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"uri\": \"\",\n \"sku\": \"\",\n \"type\": \"HardPhone\",\n \"name\": \"\",\n \"serial\": \"\",\n \"status\": \"Online\",\n \"computerName\": \"\",\n \"model\": {\n \"id\": \"\",\n \"name\": \"\",\n \"addons\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"count\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"count\": \"\"\n }\n ],\n \"deviceClass\": \"\",\n \"features\": [\n \"BLA\",\n \"CommonPhone\"\n ],\n \"lineCount\": \"\"\n },\n \"extension\": {\n \"id\": \"\",\n \"uri\": \"\",\n \"extensionNumber\": \"\",\n \"partnerId\": \"\"\n },\n \"emergency\": {\n \"address\": {\n \"country\": \"\",\n \"countryId\": \"\",\n \"countryIsoCode\": \"\",\n \"countryName\": \"\",\n \"state\": \"\",\n \"stateId\": \"\",\n \"stateIsoCode\": \"\",\n \"stateName\": \"\",\n \"city\": \"\",\n \"street\": \"\",\n \"street2\": \"\",\n \"zip\": \"\",\n \"customerName\": \"\"\n },\n \"location\": {\n \"id\": \"\",\n \"name\": \"\",\n \"addressFormatId\": \"\"\n },\n \"outOfCountry\": \"\",\n \"addressStatus\": \"Invalid\",\n \"visibility\": \"Public\",\n \"syncStatus\": \"Unsupported\",\n \"addressEditableStatus\": \"MainDevice\"\n },\n \"emergencyServiceAddress\": {\n \"street\": \"\",\n \"street2\": \"\",\n \"city\": \"\",\n \"zip\": \"\",\n \"customerName\": \"\",\n \"state\": \"\",\n \"stateId\": \"\",\n \"stateIsoCode\": \"\",\n \"stateName\": \"\",\n \"countryId\": \"\",\n \"countryIsoCode\": \"\",\n \"country\": \"\",\n \"countryName\": \"\",\n \"outOfCountry\": \"\",\n \"syncStatus\": \"Failed\",\n \"additionalCustomerName\": \"\",\n \"customerEmail\": \"\",\n \"additionalCustomerEmail\": \"\",\n \"customerPhone\": \"\",\n \"additionalCustomerPhone\": \"\",\n \"lineProvisioningStatus\": \"Provisioning\",\n \"taxId\": \"\"\n },\n \"phoneLines\": [\n {\n \"id\": \"\",\n \"lineType\": \"StandaloneFree\",\n \"phoneInfo\": {\n \"id\": \"\",\n \"country\": {\n \"id\": \"\",\n \"uri\": \"\",\n \"name\": \"\"\n },\n \"extension\": {\n \"id\": \"\",\n \"uri\": \"\",\n \"extensionNumber\": \"\",\n \"partnerId\": \"\"\n },\n \"label\": \"\",\n \"location\": \"\",\n \"paymentType\": \"External\",\n \"phoneNumber\": \"\",\n \"status\": \"\",\n \"type\": \"FaxOnly\",\n \"usageType\": \"ForwardedCompanyNumber\"\n },\n \"emergencyAddress\": {\n \"required\": \"\",\n \"localOnly\": \"\",\n \"lineProvisioningStatus\": \"Invalid\"\n }\n },\n {\n \"id\": \"\",\n \"lineType\": \"Unknown\",\n \"phoneInfo\": {\n \"id\": \"\",\n \"country\": {\n \"id\": \"\",\n \"uri\": \"\",\n \"name\": \"\"\n },\n \"extension\": {\n \"id\": \"\",\n \"uri\": \"\",\n \"extensionNumber\": \"\",\n \"partnerId\": \"\"\n },\n \"label\": \"\",\n \"location\": \"\",\n \"paymentType\": \"External\",\n \"phoneNumber\": \"\",\n \"status\": \"\",\n \"type\": \"VoiceOnly\",\n \"usageType\": \"CompanyNumber\"\n },\n \"emergencyAddress\": {\n \"required\": \"\",\n \"localOnly\": \"\",\n \"lineProvisioningStatus\": \"Valid\"\n }\n }\n ],\n \"shipping\": {\n \"status\": \"Shipped\",\n \"carrier\": \"\",\n \"trackingNumber\": \"\",\n \"method\": {\n \"id\": \"1\",\n \"name\": \"Ground\"\n },\n \"address\": {\n \"customerName\": \"\",\n \"additionalCustomerName\": \"\",\n \"customerEmail\": \"\",\n \"additionalCustomerEmail\": \"\",\n \"customerPhone\": \"\",\n \"additionalCustomerPhone\": \"\",\n \"street\": \"\",\n \"street2\": \"\",\n \"city\": \"\",\n \"state\": \"\",\n \"stateId\": \"\",\n \"stateIsoCode\": \"\",\n \"stateName\": \"\",\n \"countryId\": \"\",\n \"countryIsoCode\": \"\",\n \"country\": \"\",\n \"countryName\": \"\",\n \"zip\": \"\",\n \"taxId\": \"\"\n }\n },\n \"boxBillingId\": \"\",\n \"useAsCommonPhone\": \"\",\n \"hotDeskDevice\": \"\",\n \"inCompanyNet\": \"\",\n \"site\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"lastLocationReportTime\": \"\",\n \"linePooling\": \"None\",\n \"billingStatement\": {\n \"currency\": \"\",\n \"charges\": [\n {\n \"description\": \"\",\n \"amount\": \"\",\n \"feature\": \"\",\n \"freeServiceCredit\": \"\"\n },\n {\n \"description\": \"\",\n \"amount\": \"\",\n \"feature\": \"\",\n \"freeServiceCredit\": \"\"\n }\n ],\n \"fees\": [\n {\n \"description\": \"\",\n \"amount\": \"\",\n \"freeServiceCredit\": \"\"\n },\n {\n \"description\": \"\",\n \"amount\": \"\",\n \"freeServiceCredit\": \"\"\n }\n ],\n \"totalCharged\": \"\",\n \"totalCharges\": \"\",\n \"totalFees\": \"\",\n \"subtotal\": \"\",\n \"totalFreeServiceCredit\": \"\"\n }\n}", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-cd2cfac6-1932-4f9c-b114-2d0143d37683" } ], "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-e2fb2d7f-faee-4e3a-ac16-fa0a0e1aa1a2" }, { "name": "Update Device", "id": "2073ec21-dc78-486c-ae91-d9415d9bc9a5", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "PUT", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"emergencyServiceAddress\": {\n \"street\": \"\",\n \"street2\": \"\",\n \"city\": \"\",\n \"zip\": \"\",\n \"customerName\": \"\",\n \"state\": \"\",\n \"stateId\": \"\",\n \"country\": \"\",\n \"countryId\": \"\"\n },\n \"emergency\": {\n \"address\": {\n \"country\": \"\",\n \"countryId\": \"\",\n \"countryIsoCode\": \"\",\n \"countryName\": \"\",\n \"state\": \"\",\n \"stateId\": \"\",\n \"stateIsoCode\": \"\",\n \"stateName\": \"\",\n \"city\": \"\",\n \"street\": \"\",\n \"street2\": \"\",\n \"zip\": \"\",\n \"customerName\": \"\"\n },\n \"location\": {\n \"id\": \"\",\n \"name\": \"\",\n \"addressFormatId\": \"\"\n },\n \"outOfCountry\": \"\",\n \"addressStatus\": \"Invalid\",\n \"visibility\": \"Public\",\n \"syncStatus\": \"Failed\",\n \"addressEditableStatus\": \"AnyDevice\"\n },\n \"extension\": {\n \"id\": \"\"\n },\n \"phoneLines\": {\n \"phoneLines\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n },\n \"useAsCommonPhone\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v1.0/account/:accountId/device/:deviceId?prestatement=", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v1.0", "account", ":accountId", "device", ":deviceId" ], "query": [ { "key": "prestatement", "value": "" } ], "variable": [ { "id": "41e40f33-95b1-4ee1-bd91-1a7501d6389b", "key": "accountId", "value": "~", "description": "(Required) Internal identifier of the RingCentral account\n(can be set to \"~\" to indicate that the account associated with current authorization session should be used)\n" }, { "id": "d18d831d-6c88-4bf1-8593-c2450a8821f0", "key": "deviceId", "value": "", "description": "(Required) Internal identifier of a device" } ] }, "description": "Updates account device(s) by their ID(s)." }, "response": [ { "id": "cd683423-8385-4cc7-bed5-3c30c39f75ef", "name": "Updated device(s) information", "originalRequest": { "method": "PUT", "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 \"emergencyServiceAddress\": {\n \"street\": \"\",\n \"street2\": \"\",\n \"city\": \"\",\n \"zip\": \"\",\n \"customerName\": \"\",\n \"state\": \"\",\n \"stateId\": \"\",\n \"country\": \"\",\n \"countryId\": \"\"\n },\n \"emergency\": {\n \"address\": {\n \"country\": \"\",\n \"countryId\": \"\",\n \"countryIsoCode\": \"\",\n \"countryName\": \"\",\n \"state\": \"\",\n \"stateId\": \"\",\n \"stateIsoCode\": \"\",\n \"stateName\": \"\",\n \"city\": \"\",\n \"street\": \"\",\n \"street2\": \"\",\n \"zip\": \"\",\n \"customerName\": \"\"\n },\n \"location\": {\n \"id\": \"\",\n \"name\": \"\",\n \"addressFormatId\": \"\"\n },\n \"outOfCountry\": \"\",\n \"addressStatus\": \"Invalid\",\n \"visibility\": \"Public\",\n \"syncStatus\": \"Failed\",\n \"addressEditableStatus\": \"AnyDevice\"\n },\n \"extension\": {\n \"id\": \"\"\n },\n \"phoneLines\": {\n \"phoneLines\": [\n {\n \"id\": \"\"\n },\n {\n \"id\": \"\"\n }\n ]\n },\n \"useAsCommonPhone\": \"\",\n \"name\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/restapi/v1.0/account/:accountId/device/:deviceId?prestatement=", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v1.0", "account", ":accountId", "device", ":deviceId" ], "query": [ { "key": "prestatement", "value": "" } ], "variable": [ { "key": "accountId" }, { "key": "deviceId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"id\": \"\",\n \"uri\": \"\",\n \"sku\": \"\",\n \"type\": \"HardPhone\",\n \"name\": \"\",\n \"serial\": \"\",\n \"status\": \"Online\",\n \"computerName\": \"\",\n \"model\": {\n \"id\": \"\",\n \"name\": \"\",\n \"addons\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"count\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"count\": \"\"\n }\n ],\n \"deviceClass\": \"\",\n \"features\": [\n \"BLA\",\n \"CommonPhone\"\n ],\n \"lineCount\": \"\"\n },\n \"extension\": {\n \"id\": \"\",\n \"uri\": \"\",\n \"extensionNumber\": \"\",\n \"partnerId\": \"\"\n },\n \"emergency\": {\n \"address\": {\n \"country\": \"\",\n \"countryId\": \"\",\n \"countryIsoCode\": \"\",\n \"countryName\": \"\",\n \"state\": \"\",\n \"stateId\": \"\",\n \"stateIsoCode\": \"\",\n \"stateName\": \"\",\n \"city\": \"\",\n \"street\": \"\",\n \"street2\": \"\",\n \"zip\": \"\",\n \"customerName\": \"\"\n },\n \"location\": {\n \"id\": \"\",\n \"name\": \"\",\n \"addressFormatId\": \"\"\n },\n \"outOfCountry\": \"\",\n \"addressStatus\": \"Invalid\",\n \"visibility\": \"Public\",\n \"syncStatus\": \"Unsupported\",\n \"addressEditableStatus\": \"MainDevice\"\n },\n \"emergencyServiceAddress\": {\n \"street\": \"\",\n \"street2\": \"\",\n \"city\": \"\",\n \"zip\": \"\",\n \"customerName\": \"\",\n \"state\": \"\",\n \"stateId\": \"\",\n \"stateIsoCode\": \"\",\n \"stateName\": \"\",\n \"countryId\": \"\",\n \"countryIsoCode\": \"\",\n \"country\": \"\",\n \"countryName\": \"\",\n \"outOfCountry\": \"\",\n \"syncStatus\": \"Failed\",\n \"additionalCustomerName\": \"\",\n \"customerEmail\": \"\",\n \"additionalCustomerEmail\": \"\",\n \"customerPhone\": \"\",\n \"additionalCustomerPhone\": \"\",\n \"lineProvisioningStatus\": \"Provisioning\",\n \"taxId\": \"\"\n },\n \"phoneLines\": [\n {\n \"id\": \"\",\n \"lineType\": \"StandaloneFree\",\n \"phoneInfo\": {\n \"id\": \"\",\n \"country\": {\n \"id\": \"\",\n \"uri\": \"\",\n \"name\": \"\"\n },\n \"extension\": {\n \"id\": \"\",\n \"uri\": \"\",\n \"extensionNumber\": \"\",\n \"partnerId\": \"\"\n },\n \"label\": \"\",\n \"location\": \"\",\n \"paymentType\": \"External\",\n \"phoneNumber\": \"\",\n \"status\": \"\",\n \"type\": \"FaxOnly\",\n \"usageType\": \"ForwardedCompanyNumber\"\n },\n \"emergencyAddress\": {\n \"required\": \"\",\n \"localOnly\": \"\",\n \"lineProvisioningStatus\": \"Invalid\"\n }\n },\n {\n \"id\": \"\",\n \"lineType\": \"Unknown\",\n \"phoneInfo\": {\n \"id\": \"\",\n \"country\": {\n \"id\": \"\",\n \"uri\": \"\",\n \"name\": \"\"\n },\n \"extension\": {\n \"id\": \"\",\n \"uri\": \"\",\n \"extensionNumber\": \"\",\n \"partnerId\": \"\"\n },\n \"label\": \"\",\n \"location\": \"\",\n \"paymentType\": \"External\",\n \"phoneNumber\": \"\",\n \"status\": \"\",\n \"type\": \"VoiceOnly\",\n \"usageType\": \"CompanyNumber\"\n },\n \"emergencyAddress\": {\n \"required\": \"\",\n \"localOnly\": \"\",\n \"lineProvisioningStatus\": \"Valid\"\n }\n }\n ],\n \"shipping\": {\n \"status\": \"Shipped\",\n \"carrier\": \"\",\n \"trackingNumber\": \"\",\n \"method\": {\n \"id\": \"1\",\n \"name\": \"Ground\"\n },\n \"address\": {\n \"customerName\": \"\",\n \"additionalCustomerName\": \"\",\n \"customerEmail\": \"\",\n \"additionalCustomerEmail\": \"\",\n \"customerPhone\": \"\",\n \"additionalCustomerPhone\": \"\",\n \"street\": \"\",\n \"street2\": \"\",\n \"city\": \"\",\n \"state\": \"\",\n \"stateId\": \"\",\n \"stateIsoCode\": \"\",\n \"stateName\": \"\",\n \"countryId\": \"\",\n \"countryIsoCode\": \"\",\n \"country\": \"\",\n \"countryName\": \"\",\n \"zip\": \"\",\n \"taxId\": \"\"\n }\n },\n \"boxBillingId\": \"\",\n \"useAsCommonPhone\": \"\",\n \"hotDeskDevice\": \"\",\n \"inCompanyNet\": \"\",\n \"site\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"lastLocationReportTime\": \"\",\n \"linePooling\": \"None\",\n \"billingStatement\": {\n \"currency\": \"\",\n \"charges\": [\n {\n \"description\": \"\",\n \"amount\": \"\",\n \"feature\": \"\",\n \"freeServiceCredit\": \"\"\n },\n {\n \"description\": \"\",\n \"amount\": \"\",\n \"feature\": \"\",\n \"freeServiceCredit\": \"\"\n }\n ],\n \"fees\": [\n {\n \"description\": \"\",\n \"amount\": \"\",\n \"freeServiceCredit\": \"\"\n },\n {\n \"description\": \"\",\n \"amount\": \"\",\n \"freeServiceCredit\": \"\"\n }\n ],\n \"totalCharged\": \"\",\n \"totalCharges\": \"\",\n \"totalFees\": \"\",\n \"subtotal\": \"\",\n \"totalFreeServiceCredit\": \"\"\n }\n}", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-cd683423-8385-4cc7-bed5-3c30c39f75ef" } ], "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-2073ec21-dc78-486c-ae91-d9415d9bc9a5" } ], "id": "2e18455f-36e1-449b-aa96-0ed1778581f8", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-2e18455f-36e1-449b-aa96-0ed1778581f8" } ], "id": "ddb42e32-9b25-43c9-81d6-410b61a0ef8f", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-ddb42e32-9b25-43c9-81d6-410b61a0ef8f" }, { "name": "extension", "item": [ { "name": "{extensionId}", "item": [ { "name": "device", "item": [ { "name": "List Extension Devices", "id": "d8ab5ea4-84f5-431f-9c83-b4f0f72a4d85", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/restapi/v1.0/account/:accountId/extension/:extensionId/device?page=1&perPage=100&linePooling=Guest&feature=BLA&type=HardPhone&lineType=Standalone", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v1.0", "account", ":accountId", "extension", ":extensionId", "device" ], "query": [ { "description": "The result set page number (1-indexed) to return", "key": "page", "value": "1" }, { "description": "The number of items per page. If provided value in the request\nis greater than a maximum, the maximum value is applied\n", "key": "perPage", "value": "100" }, { "description": "Pooling type of device - Host - a device with standalone paid phone line which can be linked to a soft client instance - Guest - a device with a linked phone line - None - a device without a phone line or with specific line (free, BLA, etc.)", "key": "linePooling", "value": "Guest" }, { "description": "Device feature or multiple features supported", "key": "feature", "value": "BLA" }, { "description": "Device type", "key": "type", "value": "HardPhone" }, { "description": "Phone line type", "key": "lineType", "value": "Standalone" } ], "variable": [ { "id": "1ff966dd-e5db-4ba0-a87c-658bdde216b5", "key": "accountId", "value": "~", "description": "(Required) Internal identifier of the RingCentral account\n(can be set to \"~\" to indicate that the account associated with current authorization session should be used)\n" }, { "id": "9953fd6e-f22f-4639-a8d9-6f2f8e625644", "key": "extensionId", "value": "~", "description": "(Required) Internal identifier of the RingCentral extension/user\n(can be set to \"~\" to indicate that the extension associated with current authorization session should be used)\n" } ] }, "description": "Returns devices of an extension or multiple extensions by their ID(s). Batch request\nis supported.\n" }, "response": [ { "id": "11e622fb-6517-41b5-88f3-1846ca369c34", "name": "Extension devices information", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/restapi/v1.0/account/:accountId/extension/:extensionId/device?page=1&perPage=100&linePooling=Guest&feature=BLA&type=HardPhone&lineType=Standalone", "host": [ "{{baseUrl}}" ], "path": [ "restapi", "v1.0", "account", ":accountId", "extension", ":extensionId", "device" ], "query": [ { "description": "The result set page number (1-indexed) to return", "key": "page", "value": "1" }, { "description": "The number of items per page. If provided value in the request\nis greater than a maximum, the maximum value is applied\n", "key": "perPage", "value": "100" }, { "description": "Pooling type of device - Host - a device with standalone paid phone line which can be linked to a soft client instance - Guest - a device with a linked phone line - None - a device without a phone line or with specific line (free, BLA, etc.)", "key": "linePooling", "value": "Guest" }, { "description": "Device feature or multiple features supported", "key": "feature", "value": "BLA" }, { "description": "Device type", "key": "type", "value": "HardPhone" }, { "description": "Phone line type", "key": "lineType", "value": "Standalone" } ], "variable": [ { "key": "accountId" }, { "key": "extensionId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"navigation\": {\n \"firstPage\": {\n \"uri\": \"\"\n },\n \"nextPage\": {\n \"uri\": \"\"\n },\n \"previousPage\": {\n \"uri\": \"\"\n },\n \"lastPage\": {\n \"uri\": \"\"\n }\n },\n \"paging\": {\n \"perPage\": \"\",\n \"page\": \"\",\n \"pageStart\": \"\",\n \"pageEnd\": \"\",\n \"totalPages\": \"\",\n \"totalElements\": \"\"\n },\n \"records\": [\n {\n \"id\": \"\",\n \"uri\": \"\",\n \"sku\": \"\",\n \"type\": \"HardPhone\",\n \"name\": \"\",\n \"serial\": \"\",\n \"status\": \"Online\",\n \"computerName\": \"\",\n \"model\": {\n \"id\": \"\",\n \"name\": \"\",\n \"addons\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"count\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"count\": \"\"\n }\n ],\n \"deviceClass\": \"\",\n \"features\": [\n \"Intercom\",\n \"HELD\"\n ],\n \"lineCount\": \"\"\n },\n \"extension\": {\n \"id\": \"\",\n \"uri\": \"\",\n \"extensionNumber\": \"\",\n \"partnerId\": \"\"\n },\n \"emergency\": {\n \"address\": {\n \"country\": \"\",\n \"countryId\": \"\",\n \"countryIsoCode\": \"\",\n \"countryName\": \"\",\n \"state\": \"\",\n \"stateId\": \"\",\n \"stateIsoCode\": \"\",\n \"stateName\": \"\",\n \"city\": \"\",\n \"street\": \"\",\n \"street2\": \"\",\n \"zip\": \"\",\n \"customerName\": \"\"\n },\n \"location\": {\n \"id\": \"\",\n \"name\": \"\",\n \"addressFormatId\": \"\"\n },\n \"outOfCountry\": \"\",\n \"addressStatus\": \"Valid\",\n \"visibility\": \"Public\",\n \"syncStatus\": \"Deleted\",\n \"addressEditableStatus\": \"AnyDevice\"\n },\n \"emergencyServiceAddress\": {\n \"street\": \"\",\n \"street2\": \"\",\n \"city\": \"\",\n \"zip\": \"\",\n \"customerName\": \"\",\n \"state\": \"\",\n \"stateId\": \"\",\n \"stateIsoCode\": \"\",\n \"stateName\": \"\",\n \"countryId\": \"\",\n \"countryIsoCode\": \"\",\n \"country\": \"\",\n \"countryName\": \"\",\n \"outOfCountry\": \"\",\n \"syncStatus\": \"Failed\",\n \"additionalCustomerName\": \"\",\n \"customerEmail\": \"\",\n \"additionalCustomerEmail\": \"\",\n \"customerPhone\": \"\",\n \"additionalCustomerPhone\": \"\",\n \"lineProvisioningStatus\": \"Invalid\",\n \"taxId\": \"\"\n },\n \"phoneLines\": [\n {\n \"id\": \"\",\n \"lineType\": \"StandaloneFree\",\n \"phoneInfo\": {\n \"id\": \"\",\n \"country\": {\n \"id\": \"\",\n \"uri\": \"\",\n \"name\": \"\"\n },\n \"extension\": {\n \"id\": \"\",\n \"uri\": \"\",\n \"extensionNumber\": \"\",\n \"partnerId\": \"\"\n },\n \"label\": \"\",\n \"location\": \"\",\n \"paymentType\": \"External\",\n \"phoneNumber\": \"\",\n \"status\": \"\",\n \"type\": \"FaxOnly\",\n \"usageType\": \"AdditionalCompanyNumber\"\n },\n \"emergencyAddress\": {\n \"required\": \"\",\n \"localOnly\": \"\",\n \"lineProvisioningStatus\": \"Valid\"\n }\n },\n {\n \"id\": \"\",\n \"lineType\": \"Standalone\",\n \"phoneInfo\": {\n \"id\": \"\",\n \"country\": {\n \"id\": \"\",\n \"uri\": \"\",\n \"name\": \"\"\n },\n \"extension\": {\n \"id\": \"\",\n \"uri\": \"\",\n \"extensionNumber\": \"\",\n \"partnerId\": \"\"\n },\n \"label\": \"\",\n \"location\": \"\",\n \"paymentType\": \"External\",\n \"phoneNumber\": \"\",\n \"status\": \"\",\n \"type\": \"FaxOnly\",\n \"usageType\": \"DirectNumber\"\n },\n \"emergencyAddress\": {\n \"required\": \"\",\n \"localOnly\": \"\",\n \"lineProvisioningStatus\": \"Valid\"\n }\n }\n ],\n \"shipping\": {\n \"status\": \"Shipped\",\n \"carrier\": \"\",\n \"trackingNumber\": \"\",\n \"method\": {\n \"id\": \"1\",\n \"name\": \"2 Day\"\n },\n \"address\": {\n \"customerName\": \"\",\n \"additionalCustomerName\": \"\",\n \"customerEmail\": \"\",\n \"additionalCustomerEmail\": \"\",\n \"customerPhone\": \"\",\n \"additionalCustomerPhone\": \"\",\n \"street\": \"\",\n \"street2\": \"\",\n \"city\": \"\",\n \"state\": \"\",\n \"stateId\": \"\",\n \"stateIsoCode\": \"\",\n \"stateName\": \"\",\n \"countryId\": \"\",\n \"countryIsoCode\": \"\",\n \"country\": \"\",\n \"countryName\": \"\",\n \"zip\": \"\",\n \"taxId\": \"\"\n }\n },\n \"boxBillingId\": \"\",\n \"useAsCommonPhone\": \"\",\n \"hotDeskDevice\": \"\",\n \"inCompanyNet\": \"\",\n \"site\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"lastLocationReportTime\": \"\",\n \"linePooling\": \"None\",\n \"billingStatement\": {\n \"currency\": \"\",\n \"charges\": [\n {\n \"description\": \"\",\n \"amount\": \"\",\n \"feature\": \"\",\n \"freeServiceCredit\": \"\"\n },\n {\n \"description\": \"\",\n \"amount\": \"\",\n \"feature\": \"\",\n \"freeServiceCredit\": \"\"\n }\n ],\n \"fees\": [\n {\n \"description\": \"\",\n \"amount\": \"\",\n \"freeServiceCredit\": \"\"\n },\n {\n \"description\": \"\",\n \"amount\": \"\",\n \"freeServiceCredit\": \"\"\n }\n ],\n \"totalCharged\": \"\",\n \"totalCharges\": \"\",\n \"totalFees\": \"\",\n \"subtotal\": \"\",\n \"totalFreeServiceCredit\": \"\"\n }\n },\n {\n \"id\": \"\",\n \"uri\": \"\",\n \"sku\": \"\",\n \"type\": \"HardPhone\",\n \"name\": \"\",\n \"serial\": \"\",\n \"status\": \"Offline\",\n \"computerName\": \"\",\n \"model\": {\n \"id\": \"\",\n \"name\": \"\",\n \"addons\": [\n {\n \"id\": \"\",\n \"name\": \"\",\n \"count\": \"\"\n },\n {\n \"id\": \"\",\n \"name\": \"\",\n \"count\": \"\"\n }\n ],\n \"deviceClass\": \"\",\n \"features\": [\n \"Paging\",\n \"Intercom\"\n ],\n \"lineCount\": \"\"\n },\n \"extension\": {\n \"id\": \"\",\n \"uri\": \"\",\n \"extensionNumber\": \"\",\n \"partnerId\": \"\"\n },\n \"emergency\": {\n \"address\": {\n \"country\": \"\",\n \"countryId\": \"\",\n \"countryIsoCode\": \"\",\n \"countryName\": \"\",\n \"state\": \"\",\n \"stateId\": \"\",\n \"stateIsoCode\": \"\",\n \"stateName\": \"\",\n \"city\": \"\",\n \"street\": \"\",\n \"street2\": \"\",\n \"zip\": \"\",\n \"customerName\": \"\"\n },\n \"location\": {\n \"id\": \"\",\n \"name\": \"\",\n \"addressFormatId\": \"\"\n },\n \"outOfCountry\": \"\",\n \"addressStatus\": \"Provisioning\",\n \"visibility\": \"Public\",\n \"syncStatus\": \"Unsupported\",\n \"addressEditableStatus\": \"MainDevice\"\n },\n \"emergencyServiceAddress\": {\n \"street\": \"\",\n \"street2\": \"\",\n \"city\": \"\",\n \"zip\": \"\",\n \"customerName\": \"\",\n \"state\": \"\",\n \"stateId\": \"\",\n \"stateIsoCode\": \"\",\n \"stateName\": \"\",\n \"countryId\": \"\",\n \"countryIsoCode\": \"\",\n \"country\": \"\",\n \"countryName\": \"\",\n \"outOfCountry\": \"\",\n \"syncStatus\": \"Deleted\",\n \"additionalCustomerName\": \"\",\n \"customerEmail\": \"\",\n \"additionalCustomerEmail\": \"\",\n \"customerPhone\": \"\",\n \"additionalCustomerPhone\": \"\",\n \"lineProvisioningStatus\": \"Valid\",\n \"taxId\": \"\"\n },\n \"phoneLines\": [\n {\n \"id\": \"\",\n \"lineType\": \"Standalone\",\n \"phoneInfo\": {\n \"id\": \"\",\n \"country\": {\n \"id\": \"\",\n \"uri\": \"\",\n \"name\": \"\"\n },\n \"extension\": {\n \"id\": \"\",\n \"uri\": \"\",\n \"extensionNumber\": \"\",\n \"partnerId\": \"\"\n },\n \"label\": \"\",\n \"location\": \"\",\n \"paymentType\": \"External\",\n \"phoneNumber\": \"\",\n \"status\": \"\",\n \"type\": \"FaxOnly\",\n \"usageType\": \"DirectNumber\"\n },\n \"emergencyAddress\": {\n \"required\": \"\",\n \"localOnly\": \"\",\n \"lineProvisioningStatus\": \"Invalid\"\n }\n },\n {\n \"id\": \"\",\n \"lineType\": \"StandaloneFree\",\n \"phoneInfo\": {\n \"id\": \"\",\n \"country\": {\n \"id\": \"\",\n \"uri\": \"\",\n \"name\": \"\"\n },\n \"extension\": {\n \"id\": \"\",\n \"uri\": \"\",\n \"extensionNumber\": \"\",\n \"partnerId\": \"\"\n },\n \"label\": \"\",\n \"location\": \"\",\n \"paymentType\": \"Local\",\n \"phoneNumber\": \"\",\n \"status\": \"\",\n \"type\": \"VoiceFax\",\n \"usageType\": \"AdditionalCompanyNumber\"\n },\n \"emergencyAddress\": {\n \"required\": \"\",\n \"localOnly\": \"\",\n \"lineProvisioningStatus\": \"Provisioning\"\n }\n }\n ],\n \"shipping\": {\n \"status\": \"Accepted\",\n \"carrier\": \"\",\n \"trackingNumber\": \"\",\n \"method\": {\n \"id\": \"1\",\n \"name\": \"Ground\"\n },\n \"address\": {\n \"customerName\": \"\",\n \"additionalCustomerName\": \"\",\n \"customerEmail\": \"\",\n \"additionalCustomerEmail\": \"\",\n \"customerPhone\": \"\",\n \"additionalCustomerPhone\": \"\",\n \"street\": \"\",\n \"street2\": \"\",\n \"city\": \"\",\n \"state\": \"\",\n \"stateId\": \"\",\n \"stateIsoCode\": \"\",\n \"stateName\": \"\",\n \"countryId\": \"\",\n \"countryIsoCode\": \"\",\n \"country\": \"\",\n \"countryName\": \"\",\n \"zip\": \"\",\n \"taxId\": \"\"\n }\n },\n \"boxBillingId\": \"\",\n \"useAsCommonPhone\": \"\",\n \"hotDeskDevice\": \"\",\n \"inCompanyNet\": \"\",\n \"site\": {\n \"id\": \"\",\n \"name\": \"\"\n },\n \"lastLocationReportTime\": \"\",\n \"linePooling\": \"Host\",\n \"billingStatement\": {\n \"currency\": \"\",\n \"charges\": [\n {\n \"description\": \"\",\n \"amount\": \"\",\n \"feature\": \"\",\n \"freeServiceCredit\": \"\"\n },\n {\n \"description\": \"\",\n \"amount\": \"\",\n \"feature\": \"\",\n \"freeServiceCredit\": \"\"\n }\n ],\n \"fees\": [\n {\n \"description\": \"\",\n \"amount\": \"\",\n \"freeServiceCredit\": \"\"\n },\n {\n \"description\": \"\",\n \"amount\": \"\",\n \"freeServiceCredit\": \"\"\n }\n ],\n \"totalCharged\": \"\",\n \"totalCharges\": \"\",\n \"totalFees\": \"\",\n \"subtotal\": \"\",\n \"totalFreeServiceCredit\": \"\"\n }\n }\n ],\n \"uri\": \"\"\n}", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-11e622fb-6517-41b5-88f3-1846ca369c34" } ], "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-d8ab5ea4-84f5-431f-9c83-b4f0f72a4d85" } ], "id": "ffa150a4-c13e-4f1c-aae6-fceb99612f03", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-ffa150a4-c13e-4f1c-aae6-fceb99612f03" } ], "id": "f09854b7-fb3b-46d8-93b5-ed16f3e25a82", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-f09854b7-fb3b-46d8-93b5-ed16f3e25a82" } ], "id": "b6a1270a-1f4a-4d5c-86ff-b50766c947c9", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-b6a1270a-1f4a-4d5c-86ff-b50766c947c9" } ], "id": "11bebb06-9662-4e0f-9e30-5355bb8ccecc", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-11bebb06-9662-4e0f-9e30-5355bb8ccecc" } ], "id": "6d7d2384-3b87-49dd-bc4e-c78ed34f2f7f", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-6d7d2384-3b87-49dd-bc4e-c78ed34f2f7f" } ], "id": "0178fa6c-fb0c-4e2e-b036-20a5c5551743", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-0178fa6c-fb0c-4e2e-b036-20a5c5551743" } ], "id": "7d1d9968-dde5-4bd0-b0d7-08902cf3e606", "createdAt": "2026-07-28T02:49:22.000Z", "updatedAt": "2026-07-28T02:49:22.000Z", "uid": "35240-7d1d9968-dde5-4bd0-b0d7-08902cf3e606" } ], "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" } ] }