{ "info": { "_postman_id": "4e34a210-d1c6-4e20-a3d8-5a0b62cd64e1", "name": "Webex Admin Address Book Devices API", "description": "The Webex Admin APIs provide comprehensive programmatic access to administrative functions for managing Webex organizations, users, licenses, and settings. These APIs enable automation of user provisioning, license assignment, compliance management, and audit event retrieval. Administrators can integrate with enterprise identity systems, enforce security policies, monitor usage, and streamline onboarding/offboarding processes. The APIs support granular control over organizational resources, making them ideal for large-scale deployments and custom admin tooling.", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "lastUpdatedBy": "35240", "uid": "35240-4e34a210-d1c6-4e20-a3d8-5a0b62cd64e1" }, "item": [ { "name": "devices", "item": [ { "name": "{deviceId}", "item": [ { "name": "Get Device Details", "id": "a948b44e-ea72-4d4f-8a2f-d14b66b81a4e", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "id": "64e0e9e2-e681-43f1-a3de-09655e0ee441", "key": "deviceId", "value": "", "description": "(Required) \nA unique identifier for the device.\n" } ] }, "description": "Shows details for a device, by ID. This requires an auth token with the `spark:devices_read` scope to see your own device, or `spark-admin:devices_read` to see any other device in your organization.\n\nSpecify the device ID in the `deviceId` parameter in the URI." }, "response": [ { "id": "c8fc236b-7709-4c24-bf9e-b777820fd2d5", "name": "OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"created\": \"\",\n \"id\": \"\",\n \"displayName\": \"\",\n \"placeId\": \"\",\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"orgId\": \"\",\n \"capabilities\": [\n \"xapi\",\n \"xapi\"\n ],\n \"permissions\": [\n \"xapi:readonly\",\n \"xapi:all\"\n ],\n \"connectionStatus\": \"activating\",\n \"product\": \"\",\n \"type\": \"\",\n \"tags\": [\n \"\",\n \"\"\n ],\n \"ip\": \"\",\n \"activeInterface\": \"wired\",\n \"mac\": \"\",\n \"primarySipUrl\": \"\",\n \"sipUrls\": [\n \"\",\n \"\"\n ],\n \"serial\": \"\",\n \"software\": \"\",\n \"upgradeChannel\": \"\",\n \"locationId\": \"\",\n \"workspaceLocationId\": \"\",\n \"errorCodes\": [\n \"\",\n \"\"\n ],\n \"firstSeen\": \"\",\n \"lastSeen\": \"\",\n \"managedBy\": \"PARTNER\",\n \"devicePlatform\": \"microsoftTeamsRoom\",\n \"plannedMaintenance\": {\n \"mode\": \"off\"\n }\n}", "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-c8fc236b-7709-4c24-bf9e-b777820fd2d5" }, { "id": "dcbfce88-bb5c-4c51-92a0-f47156e0a7a7", "name": "Bad Request: The request was invalid or cannot be otherwise served. An accompanying error message will explain further.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-dcbfce88-bb5c-4c51-92a0-f47156e0a7a7" }, { "id": "53c084f9-6922-4358-83cc-66fb8e1d67a8", "name": "Unauthorized: Authentication credentials were missing or incorrect.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-53c084f9-6922-4358-83cc-66fb8e1d67a8" }, { "id": "c974d2e8-8801-457b-8c45-391d80590268", "name": "Forbidden: The request is understood, but it has been refused or access is not allowed.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-c974d2e8-8801-457b-8c45-391d80590268" }, { "id": "52709d52-05f4-4c35-a2bb-6f8f34ad1b64", "name": "Not Found: The URI requested is invalid or the resource requested, such as a user, does not exist. Also returned when the requested format is not supported by the requested method.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-52709d52-05f4-4c35-a2bb-6f8f34ad1b64" }, { "id": "0499c446-8759-4073-a525-6898e64a067e", "name": "Method Not Allowed: The request was made to a resource using an HTTP request method that is not supported.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Method Not Allowed", "code": 405, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-0499c446-8759-4073-a525-6898e64a067e" }, { "id": "fb5550b1-e8fc-417b-bec9-44286b4d4948", "name": "Conflict: The request could not be processed because it conflicts with some established rule of the system. For example, a person may not be added to a room more than once.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-fb5550b1-e8fc-417b-bec9-44286b4d4948" }, { "id": "bcf7f76c-cd24-4a0e-950e-667bb43aa640", "name": "Gone: The requested resource is no longer available.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Gone", "code": 410, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-bcf7f76c-cd24-4a0e-950e-667bb43aa640" }, { "id": "e5343a29-7625-403d-b8e5-86d14f5db34c", "name": "Unsupported Media Type: The request was made to a resource without specifying a media type or used a media type that is not supported.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Unsupported Media Type", "code": 415, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-e5343a29-7625-403d-b8e5-86d14f5db34c" }, { "id": "71208ada-1798-43da-8d0f-2c32a04c183f", "name": "Locked: The requested resource is temporarily unavailable. A Retry-After header may be present that specifies how many seconds you need to wait before attempting the request again.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Locked (WebDAV) (RFC 4918)", "code": 423, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-71208ada-1798-43da-8d0f-2c32a04c183f" }, { "id": "f26f69cc-b3ad-4434-8882-899a23058637", "name": "Precondition Required: File(s) cannot be scanned for malware and need to be force downloaded.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Precondition Required", "code": 428, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-f26f69cc-b3ad-4434-8882-899a23058637" }, { "id": "b0bb7da9-9920-46e7-8934-7d13e4559b69", "name": "Too Many Requests: Too many requests have been sent in a given amount of time and the request has been rate limited. A Retry-After header should be present that specifies how many seconds you need to wait before a successful request can be made.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-b0bb7da9-9920-46e7-8934-7d13e4559b69" }, { "id": "04acad58-dfb4-4f50-b53c-0a83031bc9db", "name": "Internal Server Error: Something went wrong on the server. If the issue persists, feel free to contact the [Webex Developer Support team](/explore/support).", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-04acad58-dfb4-4f50-b53c-0a83031bc9db" }, { "id": "7a091e32-5509-4282-97a6-913c4f63576a", "name": "Bad Gateway: The server received an invalid response from an upstream server while processing the request. Try again later.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Bad Gateway", "code": 502, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-7a091e32-5509-4282-97a6-913c4f63576a" }, { "id": "b4cbec3b-f6ba-462d-8aa1-d212ac6a9b0e", "name": "Service Unavailable: Server is overloaded with requests. Try again later.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Service Unavailable", "code": 503, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-b4cbec3b-f6ba-462d-8aa1-d212ac6a9b0e" }, { "id": "f771670c-636b-4408-a15f-a2ba75ecf476", "name": "Gateway Timeout: An upstream server failed to respond on time. If your query uses max parameter, please try to reduce it.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Gateway Timeout", "code": 504, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-f771670c-636b-4408-a15f-a2ba75ecf476" } ], "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-a948b44e-ea72-4d4f-8a2f-d14b66b81a4e" }, { "name": "Delete a Device", "id": "b3c8d7d0-9cc6-4bde-a173-4067ed5a7bdb", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "id": "c58c1e4d-bd8f-4860-b612-a2cd22b3c2b7", "key": "deviceId", "value": "", "description": "(Required) A unique identifier for the device." } ] }, "description": "Deletes a device, by ID. Deleting your own device requires an auth token with the `spark:devices_write` scope. Deleting any other device in the organization will require an administrator auth token with the `spark-admin:devices_write` scope.\n\nSpecify the device ID in the `deviceId` parameter in the URI.\n\n
Deleting a device from a person with a Webex Calling Standard license will enable Webex Calling across their Webex mobile, tablet, desktop, and browser applications.
" }, "response": [ { "id": "15d0b4cc-f4f6-4bbe-ac32-3671a97d2963", "name": "No Content", "originalRequest": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "No Content", "code": 204, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-15d0b4cc-f4f6-4bbe-ac32-3671a97d2963" }, { "id": "362c00a6-fc4b-49e9-9372-ee0913d9f9d8", "name": "Bad Request: The request was invalid or cannot be otherwise served. An accompanying error message will explain further.", "originalRequest": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-362c00a6-fc4b-49e9-9372-ee0913d9f9d8" }, { "id": "c6a13c56-dfce-4d12-907f-772a567d2221", "name": "Unauthorized: Authentication credentials were missing or incorrect.", "originalRequest": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-c6a13c56-dfce-4d12-907f-772a567d2221" }, { "id": "c84622ef-8012-42c4-ac3e-391fa23d67f4", "name": "Forbidden: The request is understood, but it has been refused or access is not allowed.", "originalRequest": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-c84622ef-8012-42c4-ac3e-391fa23d67f4" }, { "id": "a1e61aca-3c57-4853-b2c1-4afab84c2b28", "name": "Not Found: The URI requested is invalid or the resource requested, such as a user, does not exist. Also returned when the requested format is not supported by the requested method.", "originalRequest": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-a1e61aca-3c57-4853-b2c1-4afab84c2b28" }, { "id": "93a138c4-4870-4a66-9f81-0a1b97166196", "name": "Method Not Allowed: The request was made to a resource using an HTTP request method that is not supported.", "originalRequest": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Method Not Allowed", "code": 405, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-93a138c4-4870-4a66-9f81-0a1b97166196" }, { "id": "e4667ab5-25b8-4c36-bf79-90719ce6358c", "name": "Conflict: The request could not be processed because it conflicts with some established rule of the system. For example, a person may not be added to a room more than once.", "originalRequest": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-e4667ab5-25b8-4c36-bf79-90719ce6358c" }, { "id": "70b8f32d-a3fd-4ae1-a763-b16edc186071", "name": "Gone: The requested resource is no longer available.", "originalRequest": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Gone", "code": 410, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-70b8f32d-a3fd-4ae1-a763-b16edc186071" }, { "id": "2e791a84-67a6-4a7b-988c-1b2fddd5f246", "name": "Unsupported Media Type: The request was made to a resource without specifying a media type or used a media type that is not supported.", "originalRequest": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Unsupported Media Type", "code": 415, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-2e791a84-67a6-4a7b-988c-1b2fddd5f246" }, { "id": "7b4cd035-ad70-458f-a0da-8943a833df9f", "name": "Locked: The requested resource is temporarily unavailable. A Retry-After header may be present that specifies how many seconds you need to wait before attempting the request again.", "originalRequest": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Locked (WebDAV) (RFC 4918)", "code": 423, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-7b4cd035-ad70-458f-a0da-8943a833df9f" }, { "id": "d1c70884-6805-4276-8633-34dab8fd6f39", "name": "Precondition Required: File(s) cannot be scanned for malware and need to be force downloaded.", "originalRequest": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Precondition Required", "code": 428, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-d1c70884-6805-4276-8633-34dab8fd6f39" }, { "id": "3b910da6-36aa-4a89-a323-a43805b8b33c", "name": "Too Many Requests: Too many requests have been sent in a given amount of time and the request has been rate limited. A Retry-After header should be present that specifies how many seconds you need to wait before a successful request can be made.", "originalRequest": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-3b910da6-36aa-4a89-a323-a43805b8b33c" }, { "id": "ea587a74-7028-4dfb-8333-19331a19c5ec", "name": "Internal Server Error: Something went wrong on the server. If the issue persists, feel free to contact the [Webex Developer Support team](/explore/support).", "originalRequest": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-ea587a74-7028-4dfb-8333-19331a19c5ec" }, { "id": "e4a49192-3720-40e5-a3a9-f9eb2f8d5885", "name": "Bad Gateway: The server received an invalid response from an upstream server while processing the request. Try again later.", "originalRequest": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Bad Gateway", "code": 502, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-e4a49192-3720-40e5-a3a9-f9eb2f8d5885" }, { "id": "289f8f6a-a44a-46e3-aadc-ffd7f515b0a2", "name": "Service Unavailable: Server is overloaded with requests. Try again later.", "originalRequest": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Service Unavailable", "code": 503, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-289f8f6a-a44a-46e3-aadc-ffd7f515b0a2" }, { "id": "46374836-7745-485f-b7d0-7319b6827501", "name": "Gateway Timeout: An upstream server failed to respond on time. If your query uses max parameter, please try to reduce it.", "originalRequest": { "method": "DELETE", "header": [], "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Gateway Timeout", "code": 504, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-46374836-7745-485f-b7d0-7319b6827501" } ], "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-b3c8d7d0-9cc6-4bde-a173-4067ed5a7bdb" }, { "name": "Modify Device Tags", "id": "d5c0b51f-3a31-40cc-a8b5-1679aa211cc7", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json-patch+json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"op\": \"add\",\n \"path\": \"\",\n \"value\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "id": "83aabdaf-4212-4d01-8d19-6d17fa4b1458", "key": "deviceId", "value": "", "description": "(Required) Unique identifier for the device." } ] }, "description": "Create, delete or update tags on a device. For your own device, this requires an auth token with the `spark:devices_write` scope. An auth token with the `spark-admin:devices_write` scope is required to operate on other devices within the organization.\n\nSpecify the device ID in the `deviceId` parameter in the URI.\n\nInclude only the tag array in the request body, no other device attributes can be changed. This action will overwrite any previous tags. A common approach is to first [GET the devices's details](/docs/api/v1/devices/get-device-details), make changes to the `tags` array, and then PATCH the new complete array with this endpoint." }, "response": [ { "id": "c61ce002-73e8-45d6-aead-1d9bf30ded0b", "name": "OK", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json-patch+json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"op\": \"add\",\n \"path\": \"\",\n \"value\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"created\": \"\",\n \"id\": \"\",\n \"displayName\": \"\",\n \"placeId\": \"\",\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"orgId\": \"\",\n \"capabilities\": [\n \"xapi\",\n \"xapi\"\n ],\n \"permissions\": [\n \"xapi:readonly\",\n \"xapi:all\"\n ],\n \"connectionStatus\": \"activating\",\n \"product\": \"\",\n \"type\": \"\",\n \"tags\": [\n \"\",\n \"\"\n ],\n \"ip\": \"\",\n \"activeInterface\": \"wired\",\n \"mac\": \"\",\n \"primarySipUrl\": \"\",\n \"sipUrls\": [\n \"\",\n \"\"\n ],\n \"serial\": \"\",\n \"software\": \"\",\n \"upgradeChannel\": \"\",\n \"locationId\": \"\",\n \"workspaceLocationId\": \"\",\n \"errorCodes\": [\n \"\",\n \"\"\n ],\n \"firstSeen\": \"\",\n \"lastSeen\": \"\",\n \"managedBy\": \"PARTNER\",\n \"devicePlatform\": \"microsoftTeamsRoom\",\n \"plannedMaintenance\": {\n \"mode\": \"off\"\n }\n}", "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-c61ce002-73e8-45d6-aead-1d9bf30ded0b" }, { "id": "3b8d2b90-c118-4b53-a9bb-36706a0d75cf", "name": "Bad Request: The request was invalid or cannot be otherwise served. An accompanying error message will explain further.", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json-patch+json" } ], "body": { "mode": "raw", "raw": "{\n \"op\": \"add\",\n \"path\": \"\",\n \"value\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-3b8d2b90-c118-4b53-a9bb-36706a0d75cf" }, { "id": "a96f2050-40a9-4829-8da4-0f0c64aec2e0", "name": "Unauthorized: Authentication credentials were missing or incorrect.", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json-patch+json" } ], "body": { "mode": "raw", "raw": "{\n \"op\": \"add\",\n \"path\": \"\",\n \"value\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-a96f2050-40a9-4829-8da4-0f0c64aec2e0" }, { "id": "2dc72140-e9af-40e6-ac5e-b457809776b9", "name": "Forbidden: The request is understood, but it has been refused or access is not allowed.", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json-patch+json" } ], "body": { "mode": "raw", "raw": "{\n \"op\": \"add\",\n \"path\": \"\",\n \"value\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-2dc72140-e9af-40e6-ac5e-b457809776b9" }, { "id": "90896f37-999b-4a5e-9f6e-8d2d396b0b6e", "name": "Not Found: The URI requested is invalid or the resource requested, such as a user, does not exist. Also returned when the requested format is not supported by the requested method.", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json-patch+json" } ], "body": { "mode": "raw", "raw": "{\n \"op\": \"add\",\n \"path\": \"\",\n \"value\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-90896f37-999b-4a5e-9f6e-8d2d396b0b6e" }, { "id": "6ef8f203-9333-4944-9e49-e2c1a5e2d3ee", "name": "Method Not Allowed: The request was made to a resource using an HTTP request method that is not supported.", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json-patch+json" } ], "body": { "mode": "raw", "raw": "{\n \"op\": \"add\",\n \"path\": \"\",\n \"value\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Method Not Allowed", "code": 405, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-6ef8f203-9333-4944-9e49-e2c1a5e2d3ee" }, { "id": "ec9b7ec9-2934-475f-a1be-f3957a08b627", "name": "Conflict: The request could not be processed because it conflicts with some established rule of the system. For example, a person may not be added to a room more than once.", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json-patch+json" } ], "body": { "mode": "raw", "raw": "{\n \"op\": \"add\",\n \"path\": \"\",\n \"value\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-ec9b7ec9-2934-475f-a1be-f3957a08b627" }, { "id": "42b4d48b-2522-47fa-9b35-fd0303fcea7c", "name": "Gone: The requested resource is no longer available.", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json-patch+json" } ], "body": { "mode": "raw", "raw": "{\n \"op\": \"add\",\n \"path\": \"\",\n \"value\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Gone", "code": 410, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-42b4d48b-2522-47fa-9b35-fd0303fcea7c" }, { "id": "5f24e9cf-8f83-4615-bc7e-4d5cb179b9da", "name": "Unsupported Media Type: The request was made to a resource without specifying a media type or used a media type that is not supported.", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json-patch+json" } ], "body": { "mode": "raw", "raw": "{\n \"op\": \"add\",\n \"path\": \"\",\n \"value\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Unsupported Media Type", "code": 415, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-5f24e9cf-8f83-4615-bc7e-4d5cb179b9da" }, { "id": "2b57bda2-73c1-41a5-b458-19bb9bc841ff", "name": "Locked: The requested resource is temporarily unavailable. A Retry-After header may be present that specifies how many seconds you need to wait before attempting the request again.", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json-patch+json" } ], "body": { "mode": "raw", "raw": "{\n \"op\": \"add\",\n \"path\": \"\",\n \"value\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Locked (WebDAV) (RFC 4918)", "code": 423, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-2b57bda2-73c1-41a5-b458-19bb9bc841ff" }, { "id": "a4630ccf-60d4-46d0-b7e5-60af3d11893c", "name": "Precondition Required: File(s) cannot be scanned for malware and need to be force downloaded.", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json-patch+json" } ], "body": { "mode": "raw", "raw": "{\n \"op\": \"add\",\n \"path\": \"\",\n \"value\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Precondition Required", "code": 428, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-a4630ccf-60d4-46d0-b7e5-60af3d11893c" }, { "id": "6b9507e6-3436-46e7-8a82-44ce73853a7c", "name": "Too Many Requests: Too many requests have been sent in a given amount of time and the request has been rate limited. A Retry-After header should be present that specifies how many seconds you need to wait before a successful request can be made.", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json-patch+json" } ], "body": { "mode": "raw", "raw": "{\n \"op\": \"add\",\n \"path\": \"\",\n \"value\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-6b9507e6-3436-46e7-8a82-44ce73853a7c" }, { "id": "49baabc5-c3f7-496d-a4ec-d7579a1fbb52", "name": "Internal Server Error: Something went wrong on the server. If the issue persists, feel free to contact the [Webex Developer Support team](/explore/support).", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json-patch+json" } ], "body": { "mode": "raw", "raw": "{\n \"op\": \"add\",\n \"path\": \"\",\n \"value\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-49baabc5-c3f7-496d-a4ec-d7579a1fbb52" }, { "id": "9ea90eb8-d4b5-4fbe-b6b1-c9bcb3921fe7", "name": "Bad Gateway: The server received an invalid response from an upstream server while processing the request. Try again later.", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json-patch+json" } ], "body": { "mode": "raw", "raw": "{\n \"op\": \"add\",\n \"path\": \"\",\n \"value\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Bad Gateway", "code": 502, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-9ea90eb8-d4b5-4fbe-b6b1-c9bcb3921fe7" }, { "id": "24eaf500-5884-49ea-a490-015727246f9e", "name": "Service Unavailable: Server is overloaded with requests. Try again later.", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json-patch+json" } ], "body": { "mode": "raw", "raw": "{\n \"op\": \"add\",\n \"path\": \"\",\n \"value\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Service Unavailable", "code": 503, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-24eaf500-5884-49ea-a490-015727246f9e" }, { "id": "2ffd64df-d25c-4260-8630-7a953e25f9f2", "name": "Gateway Timeout: An upstream server failed to respond on time. If your query uses max parameter, please try to reduce it.", "originalRequest": { "method": "PATCH", "header": [ { "key": "Content-Type", "value": "application/json-patch+json" } ], "body": { "mode": "raw", "raw": "{\n \"op\": \"add\",\n \"path\": \"\",\n \"value\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices/:deviceId?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", ":deviceId" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ], "variable": [ { "key": "deviceId" } ] } }, "status": "Gateway Timeout", "code": 504, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-2ffd64df-d25c-4260-8630-7a953e25f9f2" } ], "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-d5c0b51f-3a31-40cc-a8b5-1679aa211cc7" } ], "id": "30246667-aded-438b-8236-623c736dc836", "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-30246667-aded-438b-8236-623c736dc836" }, { "name": "activationCode", "item": [ { "name": "Create a Device Activation Code", "id": "eb3e236b-f592-45be-b28e-cddc7497b647", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"model\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices/activationCode?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", "activationCode" ], "query": [ { "description": "The organization associated with the activation code generated. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ] }, "description": "Generate an activation code for a device in a specific workspace by `workspaceId` or for a person by `personId`. This requires an auth token with the `spark-admin:devices_write` scope, and either `identity:placeonetimepassword_create` (allows creating activation codes for workspaces only) or `identity:one_time_password` (allows creating activation codes for workspaces or persons).\n\n* Adding a device to a workspace with calling type `none` or `thirdPartySipCalling` will reset the workspace calling type to `freeCalling`.\n\n* Either `workspaceId` or `personId` should be provided. If both are supplied, the request will be invalid.\n\n* If no `model` is supplied, the `code` returned will only be accepted on RoomOS devices.\n\n* If your device is a phone, you must provide the `model` as a field. You can get the `model` from the [supported devices](/docs/api/v1/device-call-settings/read-the-list-of-supported-devices) API.\n\n
Adding a device to a person with a Webex Calling Standard license will disable Webex Calling across their Webex mobile, tablet, desktop, and browser applications.

When adding devices to a Webex Calling Professional licensed person or workspace, wait for each API call to finish before starting the next. This prevents race conditions that can cause errors when assigning primary versus secondary device status.
" }, "response": [ { "id": "53405f01-6989-4c84-856e-8bd16936b59f", "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"model\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices/activationCode?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", "activationCode" ], "query": [ { "description": "The organization associated with the activation code generated. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"code\": \"\",\n \"expiryTime\": \"\"\n}", "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-53405f01-6989-4c84-856e-8bd16936b59f" }, { "id": "5bdd0668-88b9-4b8a-84c9-0b46c2c0a0f6", "name": "Bad Request: The request was invalid or cannot be otherwise served. An accompanying error message will explain further.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"model\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices/activationCode?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", "activationCode" ], "query": [ { "description": "The organization associated with the activation code generated. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-5bdd0668-88b9-4b8a-84c9-0b46c2c0a0f6" }, { "id": "fd26e6d2-ca61-414c-b42e-707db1f602e0", "name": "Unauthorized: Authentication credentials were missing or incorrect.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"model\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices/activationCode?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", "activationCode" ], "query": [ { "description": "The organization associated with the activation code generated. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-fd26e6d2-ca61-414c-b42e-707db1f602e0" }, { "id": "5d040610-1fa4-4a70-8beb-ab2a7d6ba8a6", "name": "Forbidden: The request is understood, but it has been refused or access is not allowed.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"model\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices/activationCode?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", "activationCode" ], "query": [ { "description": "The organization associated with the activation code generated. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-5d040610-1fa4-4a70-8beb-ab2a7d6ba8a6" }, { "id": "f1977454-cbe7-494a-bf2e-406d2286a339", "name": "Not Found: The URI requested is invalid or the resource requested, such as a user, does not exist. Also returned when the requested format is not supported by the requested method.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"model\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices/activationCode?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", "activationCode" ], "query": [ { "description": "The organization associated with the activation code generated. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-f1977454-cbe7-494a-bf2e-406d2286a339" }, { "id": "785ce152-dade-4458-90a1-a56850537dfc", "name": "Method Not Allowed: The request was made to a resource using an HTTP request method that is not supported.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"model\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices/activationCode?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", "activationCode" ], "query": [ { "description": "The organization associated with the activation code generated. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ] } }, "status": "Method Not Allowed", "code": 405, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-785ce152-dade-4458-90a1-a56850537dfc" }, { "id": "40c84a4b-1b55-4b9d-8a65-25e3bcc63a6a", "name": "Conflict: The request could not be processed because it conflicts with some established rule of the system. For example, a person may not be added to a room more than once.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"model\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices/activationCode?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", "activationCode" ], "query": [ { "description": "The organization associated with the activation code generated. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ] } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-40c84a4b-1b55-4b9d-8a65-25e3bcc63a6a" }, { "id": "2be7762b-e2d4-4d5c-9b36-5bef2e94594b", "name": "Gone: The requested resource is no longer available.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"model\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices/activationCode?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", "activationCode" ], "query": [ { "description": "The organization associated with the activation code generated. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ] } }, "status": "Gone", "code": 410, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-2be7762b-e2d4-4d5c-9b36-5bef2e94594b" }, { "id": "45727dc4-eec0-4993-8af4-217b0338e389", "name": "Unsupported Media Type: The request was made to a resource without specifying a media type or used a media type that is not supported.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"model\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices/activationCode?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", "activationCode" ], "query": [ { "description": "The organization associated with the activation code generated. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ] } }, "status": "Unsupported Media Type", "code": 415, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-45727dc4-eec0-4993-8af4-217b0338e389" }, { "id": "9e060caf-c7a8-487d-9246-5e56dc09acbe", "name": "Locked: The requested resource is temporarily unavailable. A Retry-After header may be present that specifies how many seconds you need to wait before attempting the request again.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"model\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices/activationCode?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", "activationCode" ], "query": [ { "description": "The organization associated with the activation code generated. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ] } }, "status": "Locked (WebDAV) (RFC 4918)", "code": 423, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-9e060caf-c7a8-487d-9246-5e56dc09acbe" }, { "id": "1f4c34f9-6ee5-4d5d-ad9d-01e7c3d6e39d", "name": "Precondition Required: File(s) cannot be scanned for malware and need to be force downloaded.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"model\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices/activationCode?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", "activationCode" ], "query": [ { "description": "The organization associated with the activation code generated. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ] } }, "status": "Precondition Required", "code": 428, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-1f4c34f9-6ee5-4d5d-ad9d-01e7c3d6e39d" }, { "id": "2f2c3d87-4f44-4be4-8982-d734e507d1dc", "name": "Too Many Requests: Too many requests have been sent in a given amount of time and the request has been rate limited. A Retry-After header should be present that specifies how many seconds you need to wait before a successful request can be made.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"model\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices/activationCode?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", "activationCode" ], "query": [ { "description": "The organization associated with the activation code generated. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-2f2c3d87-4f44-4be4-8982-d734e507d1dc" }, { "id": "e06244c5-b908-42ce-9f9b-b8237668d121", "name": "Internal Server Error: Something went wrong on the server. If the issue persists, feel free to contact the [Webex Developer Support team](/explore/support).", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"model\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices/activationCode?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", "activationCode" ], "query": [ { "description": "The organization associated with the activation code generated. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-e06244c5-b908-42ce-9f9b-b8237668d121" }, { "id": "2f3188a5-4ab7-4a1f-8c31-db8dbec43c7b", "name": "Bad Gateway: The server received an invalid response from an upstream server while processing the request. Try again later.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"model\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices/activationCode?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", "activationCode" ], "query": [ { "description": "The organization associated with the activation code generated. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ] } }, "status": "Bad Gateway", "code": 502, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-2f3188a5-4ab7-4a1f-8c31-db8dbec43c7b" }, { "id": "d0c67ab9-6eda-42d4-9222-6d75c40b9d82", "name": "Service Unavailable: Server is overloaded with requests. Try again later.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"model\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices/activationCode?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", "activationCode" ], "query": [ { "description": "The organization associated with the activation code generated. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ] } }, "status": "Service Unavailable", "code": 503, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-d0c67ab9-6eda-42d4-9222-6d75c40b9d82" }, { "id": "9c03109e-0128-4ce1-b13d-f61e00b8f430", "name": "Gateway Timeout: An upstream server failed to respond on time. If your query uses max parameter, please try to reduce it.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"model\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices/activationCode?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices", "activationCode" ], "query": [ { "description": "The organization associated with the activation code generated. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ] } }, "status": "Gateway Timeout", "code": 504, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-9c03109e-0128-4ce1-b13d-f61e00b8f430" } ], "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-eb3e236b-f592-45be-b28e-cddc7497b647" } ], "id": "5c8988d1-4b18-4cf4-9b06-3bfa0fb3f23a", "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-5c8988d1-4b18-4cf4-9b06-3bfa0fb3f23a" }, { "name": "List Devices", "id": "abe3be9f-439e-4c60-8e89-764bc83cb573", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/devices?max=&start=&displayName=&personId=&workspaceId=&orgId=&connectionStatus=&product=RoomKit&type=phone&serial=&tag=&software=&upgradeChannel=&errorCode=&capability=xapi&permission=&locationId=&workspaceLocationId=&mac=&devicePlatform=cisco&plannedMaintenance=upcoming", "host": [ "{{baseUrl}}" ], "path": [ "devices" ], "query": [ { "description": "Limit the maximum number of devices in the response.", "key": "max", "value": "" }, { "description": "\nOffset. Default is 0.\n", "key": "start", "value": "" }, { "description": "\nList devices with this display name.\n", "key": "displayName", "value": "" }, { "description": "\nList devices by person ID.\n", "key": "personId", "value": "" }, { "description": "\nList devices by workspace ID.\n", "key": "workspaceId", "value": "" }, { "description": "\nList devices in this organization. Only admin users of another organization (such as partners) may use this parameter.\n", "key": "orgId", "value": "" }, { "description": "\nList devices with this connection status.\n", "key": "connectionStatus", "value": "" }, { "description": "\nList devices with this product name.\n", "key": "product", "value": "RoomKit" }, { "description": "\nList devices with this type.\n", "key": "type", "value": "phone" }, { "description": "\nList devices with this serial number.\n", "key": "serial", "value": "" }, { "description": "\nList devices which have a tag. Searching for multiple tags (logical AND) can be done by comma separating the `tag` values or adding several `tag` parameters.\n", "key": "tag", "value": "" }, { "description": "\nList devices with this software version.\n", "key": "software", "value": "" }, { "description": "\nList devices with this upgrade channel.\n", "key": "upgradeChannel", "value": "" }, { "description": "\nList devices with this error code.\n", "key": "errorCode", "value": "" }, { "description": "\nList devices with this capability.\n", "key": "capability", "value": "xapi" }, { "description": "\nList devices with this permission.\n", "key": "permission", "value": "" }, { "description": "\nList devices by location ID.\n", "key": "locationId", "value": "" }, { "description": "\nList devices by workspace location ID. Deprecated, prefer `locationId`.\n", "key": "workspaceLocationId", "value": "" }, { "description": "\nList devices with this MAC address.\n", "key": "mac", "value": "" }, { "description": "\nList devices with this device platform.\n", "key": "devicePlatform", "value": "cisco" }, { "description": "\nList devices with this planned maintenance.\n", "key": "plannedMaintenance", "value": "upcoming" } ] }, "description": "Lists all active Webex devices associated with the authenticated user, such as devices activated in personal mode. This requires the `spark:devices_read` scope. Administrators can list all devices within their organization. This requires an administrator auth token with the `spark-admin:devices_read` scope." }, "response": [ { "id": "a0e81a86-5256-42b9-81c7-d493c05485b2", "name": "OK", "originalRequest": { "method": "GET", "header": [ { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/devices?max=&start=&displayName=&personId=&workspaceId=&orgId=&connectionStatus=&product=RoomKit&type=phone&serial=&tag=&software=&upgradeChannel=&errorCode=&capability=xapi&permission=&locationId=&workspaceLocationId=&mac=&devicePlatform=cisco&plannedMaintenance=upcoming", "host": [ "{{baseUrl}}" ], "path": [ "devices" ], "query": [ { "description": "Limit the maximum number of devices in the response.", "key": "max", "value": "" }, { "description": "\nOffset. Default is 0.\n", "key": "start", "value": "" }, { "description": "\nList devices with this display name.\n", "key": "displayName", "value": "" }, { "description": "\nList devices by person ID.\n", "key": "personId", "value": "" }, { "description": "\nList devices by workspace ID.\n", "key": "workspaceId", "value": "" }, { "description": "\nList devices in this organization. Only admin users of another organization (such as partners) may use this parameter.\n", "key": "orgId", "value": "" }, { "description": "\nList devices with this connection status.\n", "key": "connectionStatus", "value": "" }, { "description": "\nList devices with this product name.\n", "key": "product", "value": "RoomKit" }, { "description": "\nList devices with this type.\n", "key": "type", "value": "phone" }, { "description": "\nList devices with this serial number.\n", "key": "serial", "value": "" }, { "description": "\nList devices which have a tag. Searching for multiple tags (logical AND) can be done by comma separating the `tag` values or adding several `tag` parameters.\n", "key": "tag", "value": "" }, { "description": "\nList devices with this software version.\n", "key": "software", "value": "" }, { "description": "\nList devices with this upgrade channel.\n", "key": "upgradeChannel", "value": "" }, { "description": "\nList devices with this error code.\n", "key": "errorCode", "value": "" }, { "description": "\nList devices with this capability.\n", "key": "capability", "value": "xapi" }, { "description": "\nList devices with this permission.\n", "key": "permission", "value": "" }, { "description": "\nList devices by location ID.\n", "key": "locationId", "value": "" }, { "description": "\nList devices by workspace location ID. Deprecated, prefer `locationId`.\n", "key": "workspaceLocationId", "value": "" }, { "description": "\nList devices with this MAC address.\n", "key": "mac", "value": "" }, { "description": "\nList devices with this device platform.\n", "key": "devicePlatform", "value": "cisco" }, { "description": "\nList devices with this planned maintenance.\n", "key": "plannedMaintenance", "value": "upcoming" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "", "type": "text/plain" }, "key": "Link", "value": "" } ], "cookie": [], "responseTime": null, "body": "{\n \"items\": [\n {\n \"created\": \"\",\n \"id\": \"\",\n \"displayName\": \"\",\n \"placeId\": \"\",\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"orgId\": \"\",\n \"capabilities\": [\n \"xapi\",\n \"xapi\"\n ],\n \"permissions\": [\n \"xapi:all\",\n \"xapi:readonly\"\n ],\n \"connectionStatus\": \"unknown\",\n \"product\": \"\",\n \"type\": \"\",\n \"tags\": [\n \"\",\n \"\"\n ],\n \"ip\": \"\",\n \"activeInterface\": \"wired\",\n \"mac\": \"\",\n \"primarySipUrl\": \"\",\n \"sipUrls\": [\n \"\",\n \"\"\n ],\n \"serial\": \"\",\n \"software\": \"\",\n \"upgradeChannel\": \"\",\n \"locationId\": \"\",\n \"workspaceLocationId\": \"\",\n \"errorCodes\": [\n \"\",\n \"\"\n ],\n \"firstSeen\": \"\",\n \"lastSeen\": \"\",\n \"managedBy\": \"CUSTOMER\",\n \"devicePlatform\": \"cisco\",\n \"plannedMaintenance\": {\n \"mode\": \"off\"\n }\n },\n {\n \"created\": \"\",\n \"id\": \"\",\n \"displayName\": \"\",\n \"placeId\": \"\",\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"orgId\": \"\",\n \"capabilities\": [\n \"xapi\",\n \"xapi\"\n ],\n \"permissions\": [\n \"xapi:readonly\",\n \"xapi:all\"\n ],\n \"connectionStatus\": \"offline_deep_sleep\",\n \"product\": \"\",\n \"type\": \"\",\n \"tags\": [\n \"\",\n \"\"\n ],\n \"ip\": \"\",\n \"activeInterface\": \"wired\",\n \"mac\": \"\",\n \"primarySipUrl\": \"\",\n \"sipUrls\": [\n \"\",\n \"\"\n ],\n \"serial\": \"\",\n \"software\": \"\",\n \"upgradeChannel\": \"\",\n \"locationId\": \"\",\n \"workspaceLocationId\": \"\",\n \"errorCodes\": [\n \"\",\n \"\"\n ],\n \"firstSeen\": \"\",\n \"lastSeen\": \"\",\n \"managedBy\": \"CISCO\",\n \"devicePlatform\": \"microsoftTeamsRoom\",\n \"plannedMaintenance\": {\n \"mode\": \"on\"\n }\n }\n ]\n}", "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-a0e81a86-5256-42b9-81c7-d493c05485b2" }, { "id": "00280b83-b6ea-453a-bf74-35a2caa65318", "name": "Bad Request: The request was invalid or cannot be otherwise served. An accompanying error message will explain further.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/devices?max=&start=&displayName=&personId=&workspaceId=&orgId=&connectionStatus=&product=RoomKit&type=phone&serial=&tag=&software=&upgradeChannel=&errorCode=&capability=xapi&permission=&locationId=&workspaceLocationId=&mac=&devicePlatform=cisco&plannedMaintenance=upcoming", "host": [ "{{baseUrl}}" ], "path": [ "devices" ], "query": [ { "description": "Limit the maximum number of devices in the response.", "key": "max", "value": "" }, { "description": "\nOffset. Default is 0.\n", "key": "start", "value": "" }, { "description": "\nList devices with this display name.\n", "key": "displayName", "value": "" }, { "description": "\nList devices by person ID.\n", "key": "personId", "value": "" }, { "description": "\nList devices by workspace ID.\n", "key": "workspaceId", "value": "" }, { "description": "\nList devices in this organization. Only admin users of another organization (such as partners) may use this parameter.\n", "key": "orgId", "value": "" }, { "description": "\nList devices with this connection status.\n", "key": "connectionStatus", "value": "" }, { "description": "\nList devices with this product name.\n", "key": "product", "value": "RoomKit" }, { "description": "\nList devices with this type.\n", "key": "type", "value": "phone" }, { "description": "\nList devices with this serial number.\n", "key": "serial", "value": "" }, { "description": "\nList devices which have a tag. Searching for multiple tags (logical AND) can be done by comma separating the `tag` values or adding several `tag` parameters.\n", "key": "tag", "value": "" }, { "description": "\nList devices with this software version.\n", "key": "software", "value": "" }, { "description": "\nList devices with this upgrade channel.\n", "key": "upgradeChannel", "value": "" }, { "description": "\nList devices with this error code.\n", "key": "errorCode", "value": "" }, { "description": "\nList devices with this capability.\n", "key": "capability", "value": "xapi" }, { "description": "\nList devices with this permission.\n", "key": "permission", "value": "" }, { "description": "\nList devices by location ID.\n", "key": "locationId", "value": "" }, { "description": "\nList devices by workspace location ID. Deprecated, prefer `locationId`.\n", "key": "workspaceLocationId", "value": "" }, { "description": "\nList devices with this MAC address.\n", "key": "mac", "value": "" }, { "description": "\nList devices with this device platform.\n", "key": "devicePlatform", "value": "cisco" }, { "description": "\nList devices with this planned maintenance.\n", "key": "plannedMaintenance", "value": "upcoming" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-00280b83-b6ea-453a-bf74-35a2caa65318" }, { "id": "6c0236c4-f09c-4761-9fcf-66ac463f5357", "name": "Unauthorized: Authentication credentials were missing or incorrect.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/devices?max=&start=&displayName=&personId=&workspaceId=&orgId=&connectionStatus=&product=RoomKit&type=phone&serial=&tag=&software=&upgradeChannel=&errorCode=&capability=xapi&permission=&locationId=&workspaceLocationId=&mac=&devicePlatform=cisco&plannedMaintenance=upcoming", "host": [ "{{baseUrl}}" ], "path": [ "devices" ], "query": [ { "description": "Limit the maximum number of devices in the response.", "key": "max", "value": "" }, { "description": "\nOffset. Default is 0.\n", "key": "start", "value": "" }, { "description": "\nList devices with this display name.\n", "key": "displayName", "value": "" }, { "description": "\nList devices by person ID.\n", "key": "personId", "value": "" }, { "description": "\nList devices by workspace ID.\n", "key": "workspaceId", "value": "" }, { "description": "\nList devices in this organization. Only admin users of another organization (such as partners) may use this parameter.\n", "key": "orgId", "value": "" }, { "description": "\nList devices with this connection status.\n", "key": "connectionStatus", "value": "" }, { "description": "\nList devices with this product name.\n", "key": "product", "value": "RoomKit" }, { "description": "\nList devices with this type.\n", "key": "type", "value": "phone" }, { "description": "\nList devices with this serial number.\n", "key": "serial", "value": "" }, { "description": "\nList devices which have a tag. Searching for multiple tags (logical AND) can be done by comma separating the `tag` values or adding several `tag` parameters.\n", "key": "tag", "value": "" }, { "description": "\nList devices with this software version.\n", "key": "software", "value": "" }, { "description": "\nList devices with this upgrade channel.\n", "key": "upgradeChannel", "value": "" }, { "description": "\nList devices with this error code.\n", "key": "errorCode", "value": "" }, { "description": "\nList devices with this capability.\n", "key": "capability", "value": "xapi" }, { "description": "\nList devices with this permission.\n", "key": "permission", "value": "" }, { "description": "\nList devices by location ID.\n", "key": "locationId", "value": "" }, { "description": "\nList devices by workspace location ID. Deprecated, prefer `locationId`.\n", "key": "workspaceLocationId", "value": "" }, { "description": "\nList devices with this MAC address.\n", "key": "mac", "value": "" }, { "description": "\nList devices with this device platform.\n", "key": "devicePlatform", "value": "cisco" }, { "description": "\nList devices with this planned maintenance.\n", "key": "plannedMaintenance", "value": "upcoming" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-6c0236c4-f09c-4761-9fcf-66ac463f5357" }, { "id": "47b016a4-b397-4463-861d-2ad1bfbcbffa", "name": "Forbidden: The request is understood, but it has been refused or access is not allowed.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/devices?max=&start=&displayName=&personId=&workspaceId=&orgId=&connectionStatus=&product=RoomKit&type=phone&serial=&tag=&software=&upgradeChannel=&errorCode=&capability=xapi&permission=&locationId=&workspaceLocationId=&mac=&devicePlatform=cisco&plannedMaintenance=upcoming", "host": [ "{{baseUrl}}" ], "path": [ "devices" ], "query": [ { "description": "Limit the maximum number of devices in the response.", "key": "max", "value": "" }, { "description": "\nOffset. Default is 0.\n", "key": "start", "value": "" }, { "description": "\nList devices with this display name.\n", "key": "displayName", "value": "" }, { "description": "\nList devices by person ID.\n", "key": "personId", "value": "" }, { "description": "\nList devices by workspace ID.\n", "key": "workspaceId", "value": "" }, { "description": "\nList devices in this organization. Only admin users of another organization (such as partners) may use this parameter.\n", "key": "orgId", "value": "" }, { "description": "\nList devices with this connection status.\n", "key": "connectionStatus", "value": "" }, { "description": "\nList devices with this product name.\n", "key": "product", "value": "RoomKit" }, { "description": "\nList devices with this type.\n", "key": "type", "value": "phone" }, { "description": "\nList devices with this serial number.\n", "key": "serial", "value": "" }, { "description": "\nList devices which have a tag. Searching for multiple tags (logical AND) can be done by comma separating the `tag` values or adding several `tag` parameters.\n", "key": "tag", "value": "" }, { "description": "\nList devices with this software version.\n", "key": "software", "value": "" }, { "description": "\nList devices with this upgrade channel.\n", "key": "upgradeChannel", "value": "" }, { "description": "\nList devices with this error code.\n", "key": "errorCode", "value": "" }, { "description": "\nList devices with this capability.\n", "key": "capability", "value": "xapi" }, { "description": "\nList devices with this permission.\n", "key": "permission", "value": "" }, { "description": "\nList devices by location ID.\n", "key": "locationId", "value": "" }, { "description": "\nList devices by workspace location ID. Deprecated, prefer `locationId`.\n", "key": "workspaceLocationId", "value": "" }, { "description": "\nList devices with this MAC address.\n", "key": "mac", "value": "" }, { "description": "\nList devices with this device platform.\n", "key": "devicePlatform", "value": "cisco" }, { "description": "\nList devices with this planned maintenance.\n", "key": "plannedMaintenance", "value": "upcoming" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-47b016a4-b397-4463-861d-2ad1bfbcbffa" }, { "id": "f64a1bec-4271-43f3-9e77-8af62b38b110", "name": "Not Found: The URI requested is invalid or the resource requested, such as a user, does not exist. Also returned when the requested format is not supported by the requested method.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/devices?max=&start=&displayName=&personId=&workspaceId=&orgId=&connectionStatus=&product=RoomKit&type=phone&serial=&tag=&software=&upgradeChannel=&errorCode=&capability=xapi&permission=&locationId=&workspaceLocationId=&mac=&devicePlatform=cisco&plannedMaintenance=upcoming", "host": [ "{{baseUrl}}" ], "path": [ "devices" ], "query": [ { "description": "Limit the maximum number of devices in the response.", "key": "max", "value": "" }, { "description": "\nOffset. Default is 0.\n", "key": "start", "value": "" }, { "description": "\nList devices with this display name.\n", "key": "displayName", "value": "" }, { "description": "\nList devices by person ID.\n", "key": "personId", "value": "" }, { "description": "\nList devices by workspace ID.\n", "key": "workspaceId", "value": "" }, { "description": "\nList devices in this organization. Only admin users of another organization (such as partners) may use this parameter.\n", "key": "orgId", "value": "" }, { "description": "\nList devices with this connection status.\n", "key": "connectionStatus", "value": "" }, { "description": "\nList devices with this product name.\n", "key": "product", "value": "RoomKit" }, { "description": "\nList devices with this type.\n", "key": "type", "value": "phone" }, { "description": "\nList devices with this serial number.\n", "key": "serial", "value": "" }, { "description": "\nList devices which have a tag. Searching for multiple tags (logical AND) can be done by comma separating the `tag` values or adding several `tag` parameters.\n", "key": "tag", "value": "" }, { "description": "\nList devices with this software version.\n", "key": "software", "value": "" }, { "description": "\nList devices with this upgrade channel.\n", "key": "upgradeChannel", "value": "" }, { "description": "\nList devices with this error code.\n", "key": "errorCode", "value": "" }, { "description": "\nList devices with this capability.\n", "key": "capability", "value": "xapi" }, { "description": "\nList devices with this permission.\n", "key": "permission", "value": "" }, { "description": "\nList devices by location ID.\n", "key": "locationId", "value": "" }, { "description": "\nList devices by workspace location ID. Deprecated, prefer `locationId`.\n", "key": "workspaceLocationId", "value": "" }, { "description": "\nList devices with this MAC address.\n", "key": "mac", "value": "" }, { "description": "\nList devices with this device platform.\n", "key": "devicePlatform", "value": "cisco" }, { "description": "\nList devices with this planned maintenance.\n", "key": "plannedMaintenance", "value": "upcoming" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-f64a1bec-4271-43f3-9e77-8af62b38b110" }, { "id": "7244b1dd-f7a9-491b-8a27-b95a6c30bbe2", "name": "Method Not Allowed: The request was made to a resource using an HTTP request method that is not supported.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/devices?max=&start=&displayName=&personId=&workspaceId=&orgId=&connectionStatus=&product=RoomKit&type=phone&serial=&tag=&software=&upgradeChannel=&errorCode=&capability=xapi&permission=&locationId=&workspaceLocationId=&mac=&devicePlatform=cisco&plannedMaintenance=upcoming", "host": [ "{{baseUrl}}" ], "path": [ "devices" ], "query": [ { "description": "Limit the maximum number of devices in the response.", "key": "max", "value": "" }, { "description": "\nOffset. Default is 0.\n", "key": "start", "value": "" }, { "description": "\nList devices with this display name.\n", "key": "displayName", "value": "" }, { "description": "\nList devices by person ID.\n", "key": "personId", "value": "" }, { "description": "\nList devices by workspace ID.\n", "key": "workspaceId", "value": "" }, { "description": "\nList devices in this organization. Only admin users of another organization (such as partners) may use this parameter.\n", "key": "orgId", "value": "" }, { "description": "\nList devices with this connection status.\n", "key": "connectionStatus", "value": "" }, { "description": "\nList devices with this product name.\n", "key": "product", "value": "RoomKit" }, { "description": "\nList devices with this type.\n", "key": "type", "value": "phone" }, { "description": "\nList devices with this serial number.\n", "key": "serial", "value": "" }, { "description": "\nList devices which have a tag. Searching for multiple tags (logical AND) can be done by comma separating the `tag` values or adding several `tag` parameters.\n", "key": "tag", "value": "" }, { "description": "\nList devices with this software version.\n", "key": "software", "value": "" }, { "description": "\nList devices with this upgrade channel.\n", "key": "upgradeChannel", "value": "" }, { "description": "\nList devices with this error code.\n", "key": "errorCode", "value": "" }, { "description": "\nList devices with this capability.\n", "key": "capability", "value": "xapi" }, { "description": "\nList devices with this permission.\n", "key": "permission", "value": "" }, { "description": "\nList devices by location ID.\n", "key": "locationId", "value": "" }, { "description": "\nList devices by workspace location ID. Deprecated, prefer `locationId`.\n", "key": "workspaceLocationId", "value": "" }, { "description": "\nList devices with this MAC address.\n", "key": "mac", "value": "" }, { "description": "\nList devices with this device platform.\n", "key": "devicePlatform", "value": "cisco" }, { "description": "\nList devices with this planned maintenance.\n", "key": "plannedMaintenance", "value": "upcoming" } ] } }, "status": "Method Not Allowed", "code": 405, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-7244b1dd-f7a9-491b-8a27-b95a6c30bbe2" }, { "id": "c636adf3-3c59-4ec9-b046-c8c1bafc1c59", "name": "Conflict: The request could not be processed because it conflicts with some established rule of the system. For example, a person may not be added to a room more than once.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/devices?max=&start=&displayName=&personId=&workspaceId=&orgId=&connectionStatus=&product=RoomKit&type=phone&serial=&tag=&software=&upgradeChannel=&errorCode=&capability=xapi&permission=&locationId=&workspaceLocationId=&mac=&devicePlatform=cisco&plannedMaintenance=upcoming", "host": [ "{{baseUrl}}" ], "path": [ "devices" ], "query": [ { "description": "Limit the maximum number of devices in the response.", "key": "max", "value": "" }, { "description": "\nOffset. Default is 0.\n", "key": "start", "value": "" }, { "description": "\nList devices with this display name.\n", "key": "displayName", "value": "" }, { "description": "\nList devices by person ID.\n", "key": "personId", "value": "" }, { "description": "\nList devices by workspace ID.\n", "key": "workspaceId", "value": "" }, { "description": "\nList devices in this organization. Only admin users of another organization (such as partners) may use this parameter.\n", "key": "orgId", "value": "" }, { "description": "\nList devices with this connection status.\n", "key": "connectionStatus", "value": "" }, { "description": "\nList devices with this product name.\n", "key": "product", "value": "RoomKit" }, { "description": "\nList devices with this type.\n", "key": "type", "value": "phone" }, { "description": "\nList devices with this serial number.\n", "key": "serial", "value": "" }, { "description": "\nList devices which have a tag. Searching for multiple tags (logical AND) can be done by comma separating the `tag` values or adding several `tag` parameters.\n", "key": "tag", "value": "" }, { "description": "\nList devices with this software version.\n", "key": "software", "value": "" }, { "description": "\nList devices with this upgrade channel.\n", "key": "upgradeChannel", "value": "" }, { "description": "\nList devices with this error code.\n", "key": "errorCode", "value": "" }, { "description": "\nList devices with this capability.\n", "key": "capability", "value": "xapi" }, { "description": "\nList devices with this permission.\n", "key": "permission", "value": "" }, { "description": "\nList devices by location ID.\n", "key": "locationId", "value": "" }, { "description": "\nList devices by workspace location ID. Deprecated, prefer `locationId`.\n", "key": "workspaceLocationId", "value": "" }, { "description": "\nList devices with this MAC address.\n", "key": "mac", "value": "" }, { "description": "\nList devices with this device platform.\n", "key": "devicePlatform", "value": "cisco" }, { "description": "\nList devices with this planned maintenance.\n", "key": "plannedMaintenance", "value": "upcoming" } ] } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-c636adf3-3c59-4ec9-b046-c8c1bafc1c59" }, { "id": "8ea2c372-3513-4fb9-b536-8f98c959eb91", "name": "Gone: The requested resource is no longer available.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/devices?max=&start=&displayName=&personId=&workspaceId=&orgId=&connectionStatus=&product=RoomKit&type=phone&serial=&tag=&software=&upgradeChannel=&errorCode=&capability=xapi&permission=&locationId=&workspaceLocationId=&mac=&devicePlatform=cisco&plannedMaintenance=upcoming", "host": [ "{{baseUrl}}" ], "path": [ "devices" ], "query": [ { "description": "Limit the maximum number of devices in the response.", "key": "max", "value": "" }, { "description": "\nOffset. Default is 0.\n", "key": "start", "value": "" }, { "description": "\nList devices with this display name.\n", "key": "displayName", "value": "" }, { "description": "\nList devices by person ID.\n", "key": "personId", "value": "" }, { "description": "\nList devices by workspace ID.\n", "key": "workspaceId", "value": "" }, { "description": "\nList devices in this organization. Only admin users of another organization (such as partners) may use this parameter.\n", "key": "orgId", "value": "" }, { "description": "\nList devices with this connection status.\n", "key": "connectionStatus", "value": "" }, { "description": "\nList devices with this product name.\n", "key": "product", "value": "RoomKit" }, { "description": "\nList devices with this type.\n", "key": "type", "value": "phone" }, { "description": "\nList devices with this serial number.\n", "key": "serial", "value": "" }, { "description": "\nList devices which have a tag. Searching for multiple tags (logical AND) can be done by comma separating the `tag` values or adding several `tag` parameters.\n", "key": "tag", "value": "" }, { "description": "\nList devices with this software version.\n", "key": "software", "value": "" }, { "description": "\nList devices with this upgrade channel.\n", "key": "upgradeChannel", "value": "" }, { "description": "\nList devices with this error code.\n", "key": "errorCode", "value": "" }, { "description": "\nList devices with this capability.\n", "key": "capability", "value": "xapi" }, { "description": "\nList devices with this permission.\n", "key": "permission", "value": "" }, { "description": "\nList devices by location ID.\n", "key": "locationId", "value": "" }, { "description": "\nList devices by workspace location ID. Deprecated, prefer `locationId`.\n", "key": "workspaceLocationId", "value": "" }, { "description": "\nList devices with this MAC address.\n", "key": "mac", "value": "" }, { "description": "\nList devices with this device platform.\n", "key": "devicePlatform", "value": "cisco" }, { "description": "\nList devices with this planned maintenance.\n", "key": "plannedMaintenance", "value": "upcoming" } ] } }, "status": "Gone", "code": 410, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-8ea2c372-3513-4fb9-b536-8f98c959eb91" }, { "id": "97d71eab-5f7b-4188-ae41-f3a506cfb83d", "name": "Unsupported Media Type: The request was made to a resource without specifying a media type or used a media type that is not supported.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/devices?max=&start=&displayName=&personId=&workspaceId=&orgId=&connectionStatus=&product=RoomKit&type=phone&serial=&tag=&software=&upgradeChannel=&errorCode=&capability=xapi&permission=&locationId=&workspaceLocationId=&mac=&devicePlatform=cisco&plannedMaintenance=upcoming", "host": [ "{{baseUrl}}" ], "path": [ "devices" ], "query": [ { "description": "Limit the maximum number of devices in the response.", "key": "max", "value": "" }, { "description": "\nOffset. Default is 0.\n", "key": "start", "value": "" }, { "description": "\nList devices with this display name.\n", "key": "displayName", "value": "" }, { "description": "\nList devices by person ID.\n", "key": "personId", "value": "" }, { "description": "\nList devices by workspace ID.\n", "key": "workspaceId", "value": "" }, { "description": "\nList devices in this organization. Only admin users of another organization (such as partners) may use this parameter.\n", "key": "orgId", "value": "" }, { "description": "\nList devices with this connection status.\n", "key": "connectionStatus", "value": "" }, { "description": "\nList devices with this product name.\n", "key": "product", "value": "RoomKit" }, { "description": "\nList devices with this type.\n", "key": "type", "value": "phone" }, { "description": "\nList devices with this serial number.\n", "key": "serial", "value": "" }, { "description": "\nList devices which have a tag. Searching for multiple tags (logical AND) can be done by comma separating the `tag` values or adding several `tag` parameters.\n", "key": "tag", "value": "" }, { "description": "\nList devices with this software version.\n", "key": "software", "value": "" }, { "description": "\nList devices with this upgrade channel.\n", "key": "upgradeChannel", "value": "" }, { "description": "\nList devices with this error code.\n", "key": "errorCode", "value": "" }, { "description": "\nList devices with this capability.\n", "key": "capability", "value": "xapi" }, { "description": "\nList devices with this permission.\n", "key": "permission", "value": "" }, { "description": "\nList devices by location ID.\n", "key": "locationId", "value": "" }, { "description": "\nList devices by workspace location ID. Deprecated, prefer `locationId`.\n", "key": "workspaceLocationId", "value": "" }, { "description": "\nList devices with this MAC address.\n", "key": "mac", "value": "" }, { "description": "\nList devices with this device platform.\n", "key": "devicePlatform", "value": "cisco" }, { "description": "\nList devices with this planned maintenance.\n", "key": "plannedMaintenance", "value": "upcoming" } ] } }, "status": "Unsupported Media Type", "code": 415, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-97d71eab-5f7b-4188-ae41-f3a506cfb83d" }, { "id": "dc3f5145-52f8-4132-8433-3547ad78eb24", "name": "Locked: The requested resource is temporarily unavailable. A Retry-After header may be present that specifies how many seconds you need to wait before attempting the request again.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/devices?max=&start=&displayName=&personId=&workspaceId=&orgId=&connectionStatus=&product=RoomKit&type=phone&serial=&tag=&software=&upgradeChannel=&errorCode=&capability=xapi&permission=&locationId=&workspaceLocationId=&mac=&devicePlatform=cisco&plannedMaintenance=upcoming", "host": [ "{{baseUrl}}" ], "path": [ "devices" ], "query": [ { "description": "Limit the maximum number of devices in the response.", "key": "max", "value": "" }, { "description": "\nOffset. Default is 0.\n", "key": "start", "value": "" }, { "description": "\nList devices with this display name.\n", "key": "displayName", "value": "" }, { "description": "\nList devices by person ID.\n", "key": "personId", "value": "" }, { "description": "\nList devices by workspace ID.\n", "key": "workspaceId", "value": "" }, { "description": "\nList devices in this organization. Only admin users of another organization (such as partners) may use this parameter.\n", "key": "orgId", "value": "" }, { "description": "\nList devices with this connection status.\n", "key": "connectionStatus", "value": "" }, { "description": "\nList devices with this product name.\n", "key": "product", "value": "RoomKit" }, { "description": "\nList devices with this type.\n", "key": "type", "value": "phone" }, { "description": "\nList devices with this serial number.\n", "key": "serial", "value": "" }, { "description": "\nList devices which have a tag. Searching for multiple tags (logical AND) can be done by comma separating the `tag` values or adding several `tag` parameters.\n", "key": "tag", "value": "" }, { "description": "\nList devices with this software version.\n", "key": "software", "value": "" }, { "description": "\nList devices with this upgrade channel.\n", "key": "upgradeChannel", "value": "" }, { "description": "\nList devices with this error code.\n", "key": "errorCode", "value": "" }, { "description": "\nList devices with this capability.\n", "key": "capability", "value": "xapi" }, { "description": "\nList devices with this permission.\n", "key": "permission", "value": "" }, { "description": "\nList devices by location ID.\n", "key": "locationId", "value": "" }, { "description": "\nList devices by workspace location ID. Deprecated, prefer `locationId`.\n", "key": "workspaceLocationId", "value": "" }, { "description": "\nList devices with this MAC address.\n", "key": "mac", "value": "" }, { "description": "\nList devices with this device platform.\n", "key": "devicePlatform", "value": "cisco" }, { "description": "\nList devices with this planned maintenance.\n", "key": "plannedMaintenance", "value": "upcoming" } ] } }, "status": "Locked (WebDAV) (RFC 4918)", "code": 423, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-dc3f5145-52f8-4132-8433-3547ad78eb24" }, { "id": "23337e60-32b9-42cc-a629-6cc110805884", "name": "Precondition Required: File(s) cannot be scanned for malware and need to be force downloaded.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/devices?max=&start=&displayName=&personId=&workspaceId=&orgId=&connectionStatus=&product=RoomKit&type=phone&serial=&tag=&software=&upgradeChannel=&errorCode=&capability=xapi&permission=&locationId=&workspaceLocationId=&mac=&devicePlatform=cisco&plannedMaintenance=upcoming", "host": [ "{{baseUrl}}" ], "path": [ "devices" ], "query": [ { "description": "Limit the maximum number of devices in the response.", "key": "max", "value": "" }, { "description": "\nOffset. Default is 0.\n", "key": "start", "value": "" }, { "description": "\nList devices with this display name.\n", "key": "displayName", "value": "" }, { "description": "\nList devices by person ID.\n", "key": "personId", "value": "" }, { "description": "\nList devices by workspace ID.\n", "key": "workspaceId", "value": "" }, { "description": "\nList devices in this organization. Only admin users of another organization (such as partners) may use this parameter.\n", "key": "orgId", "value": "" }, { "description": "\nList devices with this connection status.\n", "key": "connectionStatus", "value": "" }, { "description": "\nList devices with this product name.\n", "key": "product", "value": "RoomKit" }, { "description": "\nList devices with this type.\n", "key": "type", "value": "phone" }, { "description": "\nList devices with this serial number.\n", "key": "serial", "value": "" }, { "description": "\nList devices which have a tag. Searching for multiple tags (logical AND) can be done by comma separating the `tag` values or adding several `tag` parameters.\n", "key": "tag", "value": "" }, { "description": "\nList devices with this software version.\n", "key": "software", "value": "" }, { "description": "\nList devices with this upgrade channel.\n", "key": "upgradeChannel", "value": "" }, { "description": "\nList devices with this error code.\n", "key": "errorCode", "value": "" }, { "description": "\nList devices with this capability.\n", "key": "capability", "value": "xapi" }, { "description": "\nList devices with this permission.\n", "key": "permission", "value": "" }, { "description": "\nList devices by location ID.\n", "key": "locationId", "value": "" }, { "description": "\nList devices by workspace location ID. Deprecated, prefer `locationId`.\n", "key": "workspaceLocationId", "value": "" }, { "description": "\nList devices with this MAC address.\n", "key": "mac", "value": "" }, { "description": "\nList devices with this device platform.\n", "key": "devicePlatform", "value": "cisco" }, { "description": "\nList devices with this planned maintenance.\n", "key": "plannedMaintenance", "value": "upcoming" } ] } }, "status": "Precondition Required", "code": 428, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-23337e60-32b9-42cc-a629-6cc110805884" }, { "id": "9426ebac-5168-428c-ba40-79d8d0175daa", "name": "Too Many Requests: Too many requests have been sent in a given amount of time and the request has been rate limited. A Retry-After header should be present that specifies how many seconds you need to wait before a successful request can be made.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/devices?max=&start=&displayName=&personId=&workspaceId=&orgId=&connectionStatus=&product=RoomKit&type=phone&serial=&tag=&software=&upgradeChannel=&errorCode=&capability=xapi&permission=&locationId=&workspaceLocationId=&mac=&devicePlatform=cisco&plannedMaintenance=upcoming", "host": [ "{{baseUrl}}" ], "path": [ "devices" ], "query": [ { "description": "Limit the maximum number of devices in the response.", "key": "max", "value": "" }, { "description": "\nOffset. Default is 0.\n", "key": "start", "value": "" }, { "description": "\nList devices with this display name.\n", "key": "displayName", "value": "" }, { "description": "\nList devices by person ID.\n", "key": "personId", "value": "" }, { "description": "\nList devices by workspace ID.\n", "key": "workspaceId", "value": "" }, { "description": "\nList devices in this organization. Only admin users of another organization (such as partners) may use this parameter.\n", "key": "orgId", "value": "" }, { "description": "\nList devices with this connection status.\n", "key": "connectionStatus", "value": "" }, { "description": "\nList devices with this product name.\n", "key": "product", "value": "RoomKit" }, { "description": "\nList devices with this type.\n", "key": "type", "value": "phone" }, { "description": "\nList devices with this serial number.\n", "key": "serial", "value": "" }, { "description": "\nList devices which have a tag. Searching for multiple tags (logical AND) can be done by comma separating the `tag` values or adding several `tag` parameters.\n", "key": "tag", "value": "" }, { "description": "\nList devices with this software version.\n", "key": "software", "value": "" }, { "description": "\nList devices with this upgrade channel.\n", "key": "upgradeChannel", "value": "" }, { "description": "\nList devices with this error code.\n", "key": "errorCode", "value": "" }, { "description": "\nList devices with this capability.\n", "key": "capability", "value": "xapi" }, { "description": "\nList devices with this permission.\n", "key": "permission", "value": "" }, { "description": "\nList devices by location ID.\n", "key": "locationId", "value": "" }, { "description": "\nList devices by workspace location ID. Deprecated, prefer `locationId`.\n", "key": "workspaceLocationId", "value": "" }, { "description": "\nList devices with this MAC address.\n", "key": "mac", "value": "" }, { "description": "\nList devices with this device platform.\n", "key": "devicePlatform", "value": "cisco" }, { "description": "\nList devices with this planned maintenance.\n", "key": "plannedMaintenance", "value": "upcoming" } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-9426ebac-5168-428c-ba40-79d8d0175daa" }, { "id": "44cd91df-1a19-4a12-8c97-26ce8cb29206", "name": "Internal Server Error: Something went wrong on the server. If the issue persists, feel free to contact the [Webex Developer Support team](/explore/support).", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/devices?max=&start=&displayName=&personId=&workspaceId=&orgId=&connectionStatus=&product=RoomKit&type=phone&serial=&tag=&software=&upgradeChannel=&errorCode=&capability=xapi&permission=&locationId=&workspaceLocationId=&mac=&devicePlatform=cisco&plannedMaintenance=upcoming", "host": [ "{{baseUrl}}" ], "path": [ "devices" ], "query": [ { "description": "Limit the maximum number of devices in the response.", "key": "max", "value": "" }, { "description": "\nOffset. Default is 0.\n", "key": "start", "value": "" }, { "description": "\nList devices with this display name.\n", "key": "displayName", "value": "" }, { "description": "\nList devices by person ID.\n", "key": "personId", "value": "" }, { "description": "\nList devices by workspace ID.\n", "key": "workspaceId", "value": "" }, { "description": "\nList devices in this organization. Only admin users of another organization (such as partners) may use this parameter.\n", "key": "orgId", "value": "" }, { "description": "\nList devices with this connection status.\n", "key": "connectionStatus", "value": "" }, { "description": "\nList devices with this product name.\n", "key": "product", "value": "RoomKit" }, { "description": "\nList devices with this type.\n", "key": "type", "value": "phone" }, { "description": "\nList devices with this serial number.\n", "key": "serial", "value": "" }, { "description": "\nList devices which have a tag. Searching for multiple tags (logical AND) can be done by comma separating the `tag` values or adding several `tag` parameters.\n", "key": "tag", "value": "" }, { "description": "\nList devices with this software version.\n", "key": "software", "value": "" }, { "description": "\nList devices with this upgrade channel.\n", "key": "upgradeChannel", "value": "" }, { "description": "\nList devices with this error code.\n", "key": "errorCode", "value": "" }, { "description": "\nList devices with this capability.\n", "key": "capability", "value": "xapi" }, { "description": "\nList devices with this permission.\n", "key": "permission", "value": "" }, { "description": "\nList devices by location ID.\n", "key": "locationId", "value": "" }, { "description": "\nList devices by workspace location ID. Deprecated, prefer `locationId`.\n", "key": "workspaceLocationId", "value": "" }, { "description": "\nList devices with this MAC address.\n", "key": "mac", "value": "" }, { "description": "\nList devices with this device platform.\n", "key": "devicePlatform", "value": "cisco" }, { "description": "\nList devices with this planned maintenance.\n", "key": "plannedMaintenance", "value": "upcoming" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-44cd91df-1a19-4a12-8c97-26ce8cb29206" }, { "id": "2e8577c5-e95d-4681-bc91-9849ade34e87", "name": "Bad Gateway: The server received an invalid response from an upstream server while processing the request. Try again later.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/devices?max=&start=&displayName=&personId=&workspaceId=&orgId=&connectionStatus=&product=RoomKit&type=phone&serial=&tag=&software=&upgradeChannel=&errorCode=&capability=xapi&permission=&locationId=&workspaceLocationId=&mac=&devicePlatform=cisco&plannedMaintenance=upcoming", "host": [ "{{baseUrl}}" ], "path": [ "devices" ], "query": [ { "description": "Limit the maximum number of devices in the response.", "key": "max", "value": "" }, { "description": "\nOffset. Default is 0.\n", "key": "start", "value": "" }, { "description": "\nList devices with this display name.\n", "key": "displayName", "value": "" }, { "description": "\nList devices by person ID.\n", "key": "personId", "value": "" }, { "description": "\nList devices by workspace ID.\n", "key": "workspaceId", "value": "" }, { "description": "\nList devices in this organization. Only admin users of another organization (such as partners) may use this parameter.\n", "key": "orgId", "value": "" }, { "description": "\nList devices with this connection status.\n", "key": "connectionStatus", "value": "" }, { "description": "\nList devices with this product name.\n", "key": "product", "value": "RoomKit" }, { "description": "\nList devices with this type.\n", "key": "type", "value": "phone" }, { "description": "\nList devices with this serial number.\n", "key": "serial", "value": "" }, { "description": "\nList devices which have a tag. Searching for multiple tags (logical AND) can be done by comma separating the `tag` values or adding several `tag` parameters.\n", "key": "tag", "value": "" }, { "description": "\nList devices with this software version.\n", "key": "software", "value": "" }, { "description": "\nList devices with this upgrade channel.\n", "key": "upgradeChannel", "value": "" }, { "description": "\nList devices with this error code.\n", "key": "errorCode", "value": "" }, { "description": "\nList devices with this capability.\n", "key": "capability", "value": "xapi" }, { "description": "\nList devices with this permission.\n", "key": "permission", "value": "" }, { "description": "\nList devices by location ID.\n", "key": "locationId", "value": "" }, { "description": "\nList devices by workspace location ID. Deprecated, prefer `locationId`.\n", "key": "workspaceLocationId", "value": "" }, { "description": "\nList devices with this MAC address.\n", "key": "mac", "value": "" }, { "description": "\nList devices with this device platform.\n", "key": "devicePlatform", "value": "cisco" }, { "description": "\nList devices with this planned maintenance.\n", "key": "plannedMaintenance", "value": "upcoming" } ] } }, "status": "Bad Gateway", "code": 502, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-2e8577c5-e95d-4681-bc91-9849ade34e87" }, { "id": "18f915a9-b5e8-48cc-930c-78055e12ee80", "name": "Service Unavailable: Server is overloaded with requests. Try again later.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/devices?max=&start=&displayName=&personId=&workspaceId=&orgId=&connectionStatus=&product=RoomKit&type=phone&serial=&tag=&software=&upgradeChannel=&errorCode=&capability=xapi&permission=&locationId=&workspaceLocationId=&mac=&devicePlatform=cisco&plannedMaintenance=upcoming", "host": [ "{{baseUrl}}" ], "path": [ "devices" ], "query": [ { "description": "Limit the maximum number of devices in the response.", "key": "max", "value": "" }, { "description": "\nOffset. Default is 0.\n", "key": "start", "value": "" }, { "description": "\nList devices with this display name.\n", "key": "displayName", "value": "" }, { "description": "\nList devices by person ID.\n", "key": "personId", "value": "" }, { "description": "\nList devices by workspace ID.\n", "key": "workspaceId", "value": "" }, { "description": "\nList devices in this organization. Only admin users of another organization (such as partners) may use this parameter.\n", "key": "orgId", "value": "" }, { "description": "\nList devices with this connection status.\n", "key": "connectionStatus", "value": "" }, { "description": "\nList devices with this product name.\n", "key": "product", "value": "RoomKit" }, { "description": "\nList devices with this type.\n", "key": "type", "value": "phone" }, { "description": "\nList devices with this serial number.\n", "key": "serial", "value": "" }, { "description": "\nList devices which have a tag. Searching for multiple tags (logical AND) can be done by comma separating the `tag` values or adding several `tag` parameters.\n", "key": "tag", "value": "" }, { "description": "\nList devices with this software version.\n", "key": "software", "value": "" }, { "description": "\nList devices with this upgrade channel.\n", "key": "upgradeChannel", "value": "" }, { "description": "\nList devices with this error code.\n", "key": "errorCode", "value": "" }, { "description": "\nList devices with this capability.\n", "key": "capability", "value": "xapi" }, { "description": "\nList devices with this permission.\n", "key": "permission", "value": "" }, { "description": "\nList devices by location ID.\n", "key": "locationId", "value": "" }, { "description": "\nList devices by workspace location ID. Deprecated, prefer `locationId`.\n", "key": "workspaceLocationId", "value": "" }, { "description": "\nList devices with this MAC address.\n", "key": "mac", "value": "" }, { "description": "\nList devices with this device platform.\n", "key": "devicePlatform", "value": "cisco" }, { "description": "\nList devices with this planned maintenance.\n", "key": "plannedMaintenance", "value": "upcoming" } ] } }, "status": "Service Unavailable", "code": 503, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-18f915a9-b5e8-48cc-930c-78055e12ee80" }, { "id": "5f4cdddb-a030-48cf-a10f-4c4e46e726db", "name": "Gateway Timeout: An upstream server failed to respond on time. If your query uses max parameter, please try to reduce it.", "originalRequest": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/devices?max=&start=&displayName=&personId=&workspaceId=&orgId=&connectionStatus=&product=RoomKit&type=phone&serial=&tag=&software=&upgradeChannel=&errorCode=&capability=xapi&permission=&locationId=&workspaceLocationId=&mac=&devicePlatform=cisco&plannedMaintenance=upcoming", "host": [ "{{baseUrl}}" ], "path": [ "devices" ], "query": [ { "description": "Limit the maximum number of devices in the response.", "key": "max", "value": "" }, { "description": "\nOffset. Default is 0.\n", "key": "start", "value": "" }, { "description": "\nList devices with this display name.\n", "key": "displayName", "value": "" }, { "description": "\nList devices by person ID.\n", "key": "personId", "value": "" }, { "description": "\nList devices by workspace ID.\n", "key": "workspaceId", "value": "" }, { "description": "\nList devices in this organization. Only admin users of another organization (such as partners) may use this parameter.\n", "key": "orgId", "value": "" }, { "description": "\nList devices with this connection status.\n", "key": "connectionStatus", "value": "" }, { "description": "\nList devices with this product name.\n", "key": "product", "value": "RoomKit" }, { "description": "\nList devices with this type.\n", "key": "type", "value": "phone" }, { "description": "\nList devices with this serial number.\n", "key": "serial", "value": "" }, { "description": "\nList devices which have a tag. Searching for multiple tags (logical AND) can be done by comma separating the `tag` values or adding several `tag` parameters.\n", "key": "tag", "value": "" }, { "description": "\nList devices with this software version.\n", "key": "software", "value": "" }, { "description": "\nList devices with this upgrade channel.\n", "key": "upgradeChannel", "value": "" }, { "description": "\nList devices with this error code.\n", "key": "errorCode", "value": "" }, { "description": "\nList devices with this capability.\n", "key": "capability", "value": "xapi" }, { "description": "\nList devices with this permission.\n", "key": "permission", "value": "" }, { "description": "\nList devices by location ID.\n", "key": "locationId", "value": "" }, { "description": "\nList devices by workspace location ID. Deprecated, prefer `locationId`.\n", "key": "workspaceLocationId", "value": "" }, { "description": "\nList devices with this MAC address.\n", "key": "mac", "value": "" }, { "description": "\nList devices with this device platform.\n", "key": "devicePlatform", "value": "cisco" }, { "description": "\nList devices with this planned maintenance.\n", "key": "plannedMaintenance", "value": "upcoming" } ] } }, "status": "Gateway Timeout", "code": 504, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-5f4cdddb-a030-48cf-a10f-4c4e46e726db" } ], "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-abe3be9f-439e-4c60-8e89-764bc83cb573" }, { "name": "Create a Device by MAC Address", "id": "007cf600-254d-47d3-af58-2e0a3909ee6e", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"mac\": \"\",\n \"model\": \"\",\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"password\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ] }, "description": "Create a phone by its MAC address in a specific workspace or for a person.\n\nSpecify the `mac`, `model` and either `workspaceId` or `personId`.\n\n* You can get the `model` from the [supported devices](/docs/api/v1/device-call-settings/read-the-list-of-supported-devices) API.\n\n* Either `workspaceId` or `personId` should be provided. If both are supplied, the request will be invalid.\n\n* The `password` field is only required for third party devices. You can obtain the required third party phone configuration from [here](/docs/api/v1/beta-device-call-settings-with-third-party-device-support/get-third-party-device).\n\n
Adding a device to a person with a Webex Calling Standard license will disable Webex Calling across their Webex mobile, tablet, desktop, and browser applications.

When adding devices to a Webex Calling Professional licensed person or workspace, wait for each API call to finish before starting the next. This prevents race conditions that can cause errors when assigning primary versus secondary device status.
" }, "response": [ { "id": "c1180211-ee31-4b39-99ff-3702dff33366", "name": "OK", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"mac\": \"\",\n \"model\": \"\",\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"password\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"created\": \"\",\n \"id\": \"\",\n \"displayName\": \"\",\n \"placeId\": \"\",\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"orgId\": \"\",\n \"capabilities\": [\n \"xapi\",\n \"xapi\"\n ],\n \"permissions\": [\n \"xapi:readonly\",\n \"xapi:all\"\n ],\n \"connectionStatus\": \"activating\",\n \"product\": \"\",\n \"type\": \"\",\n \"tags\": [\n \"\",\n \"\"\n ],\n \"ip\": \"\",\n \"activeInterface\": \"wired\",\n \"mac\": \"\",\n \"primarySipUrl\": \"\",\n \"sipUrls\": [\n \"\",\n \"\"\n ],\n \"serial\": \"\",\n \"software\": \"\",\n \"upgradeChannel\": \"\",\n \"locationId\": \"\",\n \"workspaceLocationId\": \"\",\n \"errorCodes\": [\n \"\",\n \"\"\n ],\n \"firstSeen\": \"\",\n \"lastSeen\": \"\",\n \"managedBy\": \"PARTNER\",\n \"devicePlatform\": \"microsoftTeamsRoom\",\n \"plannedMaintenance\": {\n \"mode\": \"off\"\n }\n}", "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-c1180211-ee31-4b39-99ff-3702dff33366" }, { "id": "80bfc855-01e0-452f-8341-bbedd8d8a4c6", "name": "Bad Request: The request was invalid or cannot be otherwise served. An accompanying error message will explain further.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"mac\": \"\",\n \"model\": \"\",\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"password\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-80bfc855-01e0-452f-8341-bbedd8d8a4c6" }, { "id": "db9cf746-fc2b-4982-b0cb-1ad2c8343bdc", "name": "Unauthorized: Authentication credentials were missing or incorrect.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"mac\": \"\",\n \"model\": \"\",\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"password\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-db9cf746-fc2b-4982-b0cb-1ad2c8343bdc" }, { "id": "37c97f19-f237-4092-b07e-9fd9b7948c6e", "name": "Forbidden: The request is understood, but it has been refused or access is not allowed.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"mac\": \"\",\n \"model\": \"\",\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"password\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-37c97f19-f237-4092-b07e-9fd9b7948c6e" }, { "id": "9129af1f-e305-4ac0-a14d-cb405f3ce215", "name": "Not Found: The URI requested is invalid or the resource requested, such as a user, does not exist. Also returned when the requested format is not supported by the requested method.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"mac\": \"\",\n \"model\": \"\",\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"password\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-9129af1f-e305-4ac0-a14d-cb405f3ce215" }, { "id": "fdfd1fd6-0052-43b7-a63e-210be90f0465", "name": "Method Not Allowed: The request was made to a resource using an HTTP request method that is not supported.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"mac\": \"\",\n \"model\": \"\",\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"password\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ] } }, "status": "Method Not Allowed", "code": 405, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-fdfd1fd6-0052-43b7-a63e-210be90f0465" }, { "id": "1b93f08f-411e-4d87-85ed-b5ec67d0662f", "name": "Conflict: The request could not be processed because it conflicts with some established rule of the system. For example, a person may not be added to a room more than once.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"mac\": \"\",\n \"model\": \"\",\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"password\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ] } }, "status": "Conflict", "code": 409, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-1b93f08f-411e-4d87-85ed-b5ec67d0662f" }, { "id": "80ca0f46-5e25-4039-9b85-0f2f88d7f0a2", "name": "Gone: The requested resource is no longer available.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"mac\": \"\",\n \"model\": \"\",\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"password\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ] } }, "status": "Gone", "code": 410, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-80ca0f46-5e25-4039-9b85-0f2f88d7f0a2" }, { "id": "adfad9e5-c2cd-4a59-a945-582a13977110", "name": "Unsupported Media Type: The request was made to a resource without specifying a media type or used a media type that is not supported.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"mac\": \"\",\n \"model\": \"\",\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"password\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ] } }, "status": "Unsupported Media Type", "code": 415, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-adfad9e5-c2cd-4a59-a945-582a13977110" }, { "id": "2bd181ba-56ba-49ac-b69d-7478f963be0f", "name": "Locked: The requested resource is temporarily unavailable. A Retry-After header may be present that specifies how many seconds you need to wait before attempting the request again.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"mac\": \"\",\n \"model\": \"\",\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"password\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ] } }, "status": "Locked (WebDAV) (RFC 4918)", "code": 423, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-2bd181ba-56ba-49ac-b69d-7478f963be0f" }, { "id": "ff909fee-73ff-47b3-8edb-f631917c78b6", "name": "Precondition Required: File(s) cannot be scanned for malware and need to be force downloaded.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"mac\": \"\",\n \"model\": \"\",\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"password\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ] } }, "status": "Precondition Required", "code": 428, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-ff909fee-73ff-47b3-8edb-f631917c78b6" }, { "id": "48be747f-c35e-4f8f-ad6f-56b34b606878", "name": "Too Many Requests: Too many requests have been sent in a given amount of time and the request has been rate limited. A Retry-After header should be present that specifies how many seconds you need to wait before a successful request can be made.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"mac\": \"\",\n \"model\": \"\",\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"password\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ] } }, "status": "Too Many Requests", "code": 429, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-48be747f-c35e-4f8f-ad6f-56b34b606878" }, { "id": "bfce00ef-095f-478c-a3d4-f119ce0cfb0d", "name": "Internal Server Error: Something went wrong on the server. If the issue persists, feel free to contact the [Webex Developer Support team](/explore/support).", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"mac\": \"\",\n \"model\": \"\",\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"password\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-bfce00ef-095f-478c-a3d4-f119ce0cfb0d" }, { "id": "c0888272-de52-4324-a767-a2846847ceff", "name": "Bad Gateway: The server received an invalid response from an upstream server while processing the request. Try again later.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"mac\": \"\",\n \"model\": \"\",\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"password\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ] } }, "status": "Bad Gateway", "code": 502, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-c0888272-de52-4324-a767-a2846847ceff" }, { "id": "39b3ebcb-c0d2-49e5-804e-f73b0a5354a5", "name": "Service Unavailable: Server is overloaded with requests. Try again later.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"mac\": \"\",\n \"model\": \"\",\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"password\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ] } }, "status": "Service Unavailable", "code": 503, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-39b3ebcb-c0d2-49e5-804e-f73b0a5354a5" }, { "id": "418e85c5-befe-4dff-b166-12feb145deef", "name": "Gateway Timeout: An upstream server failed to respond on time. If your query uses max parameter, please try to reduce it.", "originalRequest": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"mac\": \"\",\n \"model\": \"\",\n \"workspaceId\": \"\",\n \"personId\": \"\",\n \"password\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/devices?orgId=", "host": [ "{{baseUrl}}" ], "path": [ "devices" ], "query": [ { "description": "The organization associated with the device. If left empty, the organization associated with the caller will be used.", "key": "orgId", "value": "" } ] } }, "status": "Gateway Timeout", "code": 504, "_postman_previewlanguage": "text", "header": [], "cookie": [], "responseTime": null, "body": null, "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-418e85c5-befe-4dff-b166-12feb145deef" } ], "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-007cf600-254d-47d3-af58-2e0a3909ee6e" } ], "id": "ff380aff-1f75-48f1-bf68-d41d54f1b596", "createdAt": "2026-07-28T11:09:26.000Z", "updatedAt": "2026-07-28T11:09:26.000Z", "uid": "35240-ff380aff-1f75-48f1-bf68-d41d54f1b596" } ], "variable": [ { "key": "baseUrl", "value": "/" } ] }