{"openapi":"3.0.0","info":{"title":"Rooms","description":"The Zoom Rooms REST APIs allow you to manage your Zoom Rooms.  For example, you can create new Zoom Rooms, read their current configuration, or make configuration changes.  The Zoom Rooms REST API for [Zoom Room Controls](https://developers.zoom.us/docs/zoom-rooms/)in particular allows you to perform limited active control of a Zoom Room, such as starting or leaving a meeting, changing the mute state, or restarting the Zoom Room, among other capabilities.","termsOfService":"https://zoom.us/docs/en-us/zoom_api_license_and_tou.html","contact":{"name":"Zoom Developers"},"version":"2"},"externalDocs":{"description":"Find out more about Swagger","url":"https://swagger.io"},"servers":[{"url":"https://api.zoom.us/v2"}],"paths":{"/rooms/controller/apps/config":{"post":{"tags":["Room Apps"],"summary":"Config Zoom Room Controller Apps","description":"Use this API to configure Zoom Room Controller installed Zoom Apps.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`,`room:master`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:write:zoom_apps:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"ConfigZoomRoomControllerApps","requestBody":{"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"app_id":{"type":"string","description":"Unique Identifier of the Zoom Apps. This can be retrieved from the response of Get Zoom Room Controller Apps API.","example":"hOAlFWpxTr6XQNNFj-gWKw"},"room_id":{"type":"string","description":"Unique Identifier of the Zoom Room. This can be retrieved from the response of List Zoom Rooms API.","example":"qMOLddnySIGGVycz8aX_JQ"},"configuration_type":{"maximum":1,"type":"integer","description":"Enum of configuration type, 0 means config username and password, 1 means config token","format":"int32","example":0,"enum":[0,1]},"username":{"type":"string","description":"Your ZRC apps connect url user name mutually exclusive with token field","example":"Dylan.Wang"},"password":{"type":"string","description":"Your ZRC apps connect url password mutually exclusive with token field","example":"Test123"},"token":{"type":"string","description":"Your ZRC apps connect token mutually exclusive with username/password","example":"Test-Token"},"url":{"type":"string","description":"Your ZRC apps connected url","example":"https://zoom.us/"},"support_unverified_url":{"type":"boolean","description":"Does the url field not support certificate verification,true will not verify the connection certificate. Default is false","example":false,"default":true},"allow_list_domains":{"type":"array","items":{"type":"object","properties":{"domain":{"type":"string","description":"Your ZRC apps allowed domains","example":"apple.com"},"support_unverified":{"type":"boolean","description":"Does the domain field not support certificate verification,true will not verify the connection certificate. Default is false","example":false,"default":true}},"description":"Your ZRC apps allowed domain list"}}},"description":"Zoom Room Controller Apps Config Item."}}}}},"responses":{"200":{"description":"**HTTP Status Code:** `200` **OK**\nZoom room controller apps configured successfully.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"0 means success","example":0,"enum":[0]}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `30051005` <br>\n Parameter verification failed. <br>\n"},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `30054003` <br>\n Zoom App ${app_id} or Zoom Room ${room_id} not found. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","room:master","zoom_rooms:write:zoom_apps:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["ZoomRooms:Edit","SubAccount:Read","SubAccount:Edit"],"x-macro-scopes":["room:write:admin","room:master"],"x-granular-scopes":["zoom_rooms:write:zoom_apps:admin"]}}},"/visitor/invitation":{"get":{"tags":["Visitor Management"],"summary":"Get a list of visitors by location ","description":"List the invitations under a Zoom user account. Visitor management is a software system used to manage the lifecycle of visitors.\n  \n \n**Prerequisite:**  \n \n* Users need to be assigned a visitor management license. \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `visitor_management:read`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `visitor_management:read:list_invitations`,`visitor_management:read:list_invitations:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"invitationList","parameters":[{"name":"invite_location_id","in":"query","description":"The location ID where the visitor is invited to.","required":false,"schema":{"type":"string","example":"wnFFoWRwTLeww81UuAeW4g"}},{"name":"from","in":"query","description":"The start time for visit time filtering.","required":false,"schema":{"type":"string","example":"2021-03-18T05:41:36Z"}},{"name":"to","in":"query","description":"The end time for visit time filtering.","required":false,"schema":{"type":"string","example":"2021-03-18T05:41:36Z"}},{"name":"data_scope","in":"query","description":"user: Only display the invitation records of this user.\naccount: When having admin privileges, display the invitation records only for the locations under this account where the admin has permissions.","required":false,"schema":{"type":"string","example":"user","default":"user","enum":["user","account"]}},{"name":"next_page_token","in":"query","description":"Use the next page token to paginate through large result sets. A next page token is returned whenever the set of available results exceeds the current page size. This token's expiration period is 15 minutes.","required":false,"schema":{"type":"string","example":"IAfJX3jsOLW7w3dokmFl84zOa0MAVGyMEB2"}},{"name":"page_size","in":"query","description":"The number of records returned within a single API call.","required":false,"schema":{"type":"integer","example":30}}],"responses":{"200":{"description":"Get invitation list successful.","content":{"application/json":{"schema":{"type":"object","properties":{"next_page_token":{"type":"string","description":"The next page token is used to paginate through large result sets. A next page token will be returned whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes.","example":"At6eWnFZ1FB3arCXnRxqHLXKhbDW18yz2i2"},"page_size":{"maximum":300,"type":"integer","description":"The number of records returned within a single API call.","example":30,"default":30},"total_records":{"type":"number","description":"Total records count.","example":200},"invitations":{"type":"array","description":"Invitation list.","items":{"type":"object","properties":{"invitation_id":{"type":"string","description":"Invitation ID.","example":"feYLmdxtQsqX3kx08ZqxOQ"},"address":{"type":"string","description":"Invitation address.","example":"New York"},"details":{"type":"string","description":"Invitation host details.","example":"Notice items"},"start_time":{"type":"string","description":"The visit's start time.","example":"2021-04-18T05:41:36Z"},"host_email":{"type":"string","description":"Host email.","example":"example@mail.com"},"host_name":{"type":"string","description":"Host name.","example":"Example host name"},"invite_location_id":{"type":"string","description":"Invitation location ID.","example":"FCTDHSgLTDGbeUY0VOXq0A"},"office_name":{"type":"string","description":"Office name.","example":"Example office"},"visitor_photo_url":{"type":"string","description":"The photo uploaded by visitor.","example":"https://file.zoom.us/file/example-url"},"check_in_time":{"type":"string","description":"Visitor check in time.","example":"2021-04-18T05:41:36Z"},"status":{"type":"string","description":"The invitation's status. \n* `WAITING_FOR_REGISTRATION` \n* `REGISTERED` \n* `SIGNED_IN` \n* `CANCELED` \n* `CHECK_OUT` \n* `NO_SHOW`","example":"WAITING_FOR_REGISTRATION","enum":["WAITING_FOR_REGISTRATION","REGISTERED","SIGNED_IN","CANCELED","CHECK_OUT","NO_SHOW"]},"time_zone":{"type":"string","description":"Invitation location time zone.","example":"Asia/Shanghai"},"visitor_email":{"type":"string","description":"Visitor email.","example":"jchill@example.com"},"visitor_name":{"type":"string","description":"Visitor name.","example":"Jill Chill"},"visitor_organization":{"type":"string","description":"Visitor organization name.","example":"Zoom"}}}}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `30051005` <br>\n Invalid `next_page_token` or `page_size`. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["visitor_management:read","visitor_management:read:list_invitations","visitor_management:read:list_invitations:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["visitor_management:read"],"x-granular-scopes":["visitor_management:read:list_invitations","visitor_management:read:list_invitations:admin"]}},"post":{"tags":["Visitor Management"],"summary":"Send an invitation","description":"Send a invitation to a visitor. Visitor management is a software system used to manage the visitors' lifecycle. \n  \n \n**Prerequisite:**  \n \n* Users need to be assigned a visitor management license. \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `visitor_management:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `visitor_management:write:invitation`,`visitor_management:write:invitation:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"createInvitation","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"visitor_email":{"type":"string","description":"The invited visitor's email address.","example":"visitor@example.com"},"visitor_name":{"type":"string","description":"The invited visitor's name.","example":"visitor.li"},"start_time":{"type":"string","description":"The start time of the visit.","example":"2021-03-18T05:41:36Z"},"invite_location_id":{"type":"string","description":"The location ID of the location that the visitor is invited to.","example":"wnFFoWRwTLeww81UuAeW4g"},"host_id":{"type":"string","description":"The user ID of the invitation host.","example":"I7zp-pYbTl22Z29H796Ixg"},"visitor_organization":{"type":"string","description":"The invited visitor's organization name.","example":"zoom"}}}}}},"responses":{"204":{"description":"Send invitation successful."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `30059712` <br>\n Visitor has been blocked. <br>\n**Error Code:** `30059710` <br>\n The account or location is not enabled for Visitor Management. <br>\n"},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n "},"408":{"description":"**HTTP Status Code:** `408` <br>\n Request Timeout  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["visitor_management:write:admin","visitor_management:write:invitation","visitor_management:write:invitation:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["visitor_management:write:admin"],"x-granular-scopes":["visitor_management:write:invitation","visitor_management:write:invitation:admin"]}}},"/visitor/invitation/{invitationId}":{"get":{"tags":["Visitor Management"],"summary":"Invitation details by invitationID","description":"Visitor management is a software system used to manage the lifecycle of visitors. Inviter use this API to get the invitation details. \n  \n \n**Prerequisite:**  \n \n* Users need to be assigned a visitor management license. \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `visitor_management:read`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `visitor_management:read:invitation_details`,`visitor_management:read:invitation_details:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"getInvitation","parameters":[{"name":"invitationId","in":"path","description":"The invitation ID.","required":true,"schema":{"type":"string","example":"qV4G5fBGTCqImT5yQg0Kg"}}],"responses":{"200":{"description":"Get invitation details by invitation ID.","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","properties":{"invitation_id":{"type":"string","description":"Invitation id","example":"feYLmdxtQsqX3kx08ZqxOQ"},"address":{"type":"string","description":"Invitation address","example":"New York"},"details":{"type":"string","description":"Invitation host details","example":"Notice items"},"start_time":{"type":"string","description":"The start time of the visit","example":"2021-03-18T05:41:36Z"},"host_email":{"type":"string","description":"Host email","example":"kim.luo@zoom.us"},"host_name":{"type":"string","description":"Host name","example":"Kim Luo"},"invite_location_id":{"type":"string","description":"Invitation location id","example":"FCTDHSgLTDGbeUY0VOXq0A"},"office_name":{"type":"string","description":"Office name","example":"test-carl-JA01"},"visitor_photo_url":{"type":"string","description":"The photo uploaded by visitor","example":"https://file.zoomdev.us/file/cFRTpF9IRICHDQZpi5wGcg?business=zr&jwt=eyJ6bV9za20iOiJ6bV9vMm0iLCJ0eXAiOiJKV1QiLCJrIjoiS3F3RGs4UHIiLCJhbGciOiJFUzI1NiJ9.eyJhdWQiOiJ6ZnMiLCJ0b2tlbklkIjoiYTBqUS1ROTVUTm1DLWEzOE5ialduQSIsImFwcE5hbWUiOiJ6ciIsImlzcyI6InpyIiwicGVybWlzc2lvbiI6IntcImFjdGlvblwiOlwicmVhZFwiLFwiZW50aXR5XCI6e1wiY291bnRcIjowLFwiZmlsZUlkXCI6XCJjRlJUcEY5SVJJQ0hEUVpwaTV3R2NnXCIsXCJtYXhTaXplXCI6MH19IiwiZXhwIjoxNzIzNTE3MTk2LCJ0b2tlblR5cGUiOiJwcmVzaWduVG9rZW4iLCJpYXQiOjE3MjM0MzA3OTZ9.0Uq4fZzTlaKAOL6UDF86N-dOVOAaetlAtwZMHWFenwbHEK5Ps436C4Zy-zGmX9LbaGGkFMyV2P9mbP4oWPXZhg"},"check_in_time":{"type":"string","description":"Visitor check in time","example":"2021-03-18T05:41:36Z"},"status":{"type":"string","description":"The invitation's status: \n* `WAITING_FOR_REGISTRATION` \n* `REGISTERED` \n* `SIGNED_IN` \n* `CANCELED` \n* `CHECK_OUT` \n* `NO_SHOW`","example":"WAITING_FOR_REGISTRATION","enum":["WAITING_FOR_REGISTRATION","REGISTERED","SIGNED_IN","CANCELED","CHECK_OUT","NO_SHOW"]},"time_zone":{"type":"string","description":"Invitation location time zone","example":"Asia/Shanghai"},"visitor_email":{"type":"string","description":"Visitor email","example":"carl.li@zoom.us"},"visitor_name":{"type":"string","description":"Visitor name","example":"Carl Li"},"visitor_organization":{"type":"string","description":"Visitor orgnization name","example":"Zoom"}}}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n "},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `30059702` <br>\n Can not find the invitation. <br>\n"},"408":{"description":"**HTTP Status Code:** `408` <br>\n Request Timeout  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["visitor_management:read","visitor_management:read:invitation_details","visitor_management:read:invitation_details:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["visitor_management:read"],"x-granular-scopes":["visitor_management:read:invitation_details","visitor_management:read:invitation_details:admin"]}},"delete":{"tags":["Visitor Management"],"summary":"Delete an Invitation ","description":"Visitor management is a software system used to manage the lifecycle of visitors. Inviter use this API to cancel or delete an invitation. \n  \n \n**Prerequisite:**  \n \n* Users need to be assigned a visitor management license. \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `visitor_management:write`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `visitor_management:delete:invitation`,`visitor_management:delete:invitation:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"deleteInvitation","parameters":[{"name":"invitationId","in":"path","description":"The invitation ID.","required":true,"schema":{"type":"string","example":"qV4G5fBGTCqImT5yQg0Kg"}},{"name":"cancel","in":"query","description":"True: cancel invitation; false: delete invitation.","required":false,"schema":{"type":"boolean","example":true}}],"responses":{"204":{"description":"Delete/Cancel invitation successful."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n "},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `30059708` <br>\n Can not find the invitation. <br>\n"},"408":{"description":"**HTTP Status Code:** `408` <br>\n Request Timeout  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["visitor_management:write","visitor_management:delete:invitation","visitor_management:delete:invitation:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["visitor_management:write"],"x-granular-scopes":["visitor_management:delete:invitation","visitor_management:delete:invitation:admin"]}},"patch":{"tags":["Visitor Management"],"summary":"Update an invitation","description":"Update a invitation. Visitor management is a software system used to manage the visitors' lifecycle.\n  \n \n**Prerequisite:**  \n \n* Users need to be assigned a visitor management license. \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `visitor_management:write`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `visitor_management:update:invitation`,`visitor_management:update:invitation:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"updateInvitation","parameters":[{"name":"invitationId","in":"path","description":"The invitation ID.","required":true,"schema":{"type":"string","example":"qV4G5fBGTCqImT5yQg0Kg"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"visitor_name":{"type":"string","description":"The invited visitor's name.","example":"visitor.li"},"start_time":{"type":"string","description":"The visit's start time.","example":"2021-03-18T05:41:36Z"},"invite_location_id":{"type":"string","description":"The location ID of the location that the visitor is invited to.","example":"wnFFoWRwTLeww81UuAeW4g"},"host_id":{"type":"string","description":"The invitation host's user ID.","example":"I7zp-pYbTl22Z29H796Ixg"},"visitor_organization":{"type":"string","description":"The invited visitor's organization name.","example":"zoom"},"visitor_email":{"type":"string","description":"The visitor email.","example":"carl.li@zom.us"}}}}}},"responses":{"204":{"description":"Update invitation successful."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `30059712` <br>\n Visitor has been blocked. <br>\n**Error Code:** `30059710` <br>\n The account or location is not enabled for Visitor Management. <br>\n"},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `30059707` <br>\n Can not find the invitation. <br>\n"},"408":{"description":"**HTTP Status Code:** `408` <br>\n Request Timeout  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["visitor_management:write","visitor_management:update:invitation","visitor_management:update:invitation:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["visitor_management:write"],"x-granular-scopes":["visitor_management:update:invitation","visitor_management:update:invitation:admin"]}}},"/visitor/invitation/{invitationId}/checkin":{"post":{"tags":["Visitor Management"],"summary":"Check in a visitor","description":"Check in an invitation. \n  \n \n**Prerequisite:**  \n \n* Users need to be assigned a visitor management license. \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `visitor_management:write`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `visitor_management:write:check_in`,`visitor_management:write:check_in:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"checkinVisitor","parameters":[{"name":"invitationId","in":"path","description":"The invitation ID.","required":true,"schema":{"type":"string","example":"qV4G5fBGTCqImT5yQg0Kg"}}],"responses":{"204":{"description":"Invitation check in successful."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `30059712` <br>\n The visitor has been blocked. <br>\n**Error Code:** `30059710` <br>\n The account or location is not enabled for Visitor Management. <br>\n"},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `30059713` <br>\n Can not find the invitation. <br>\n"},"408":{"description":"**HTTP Status Code:** `408` <br>\n Request Timeout  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["visitor_management:write","visitor_management:write:check_in","visitor_management:write:check_in:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["visitor_management:write"],"x-granular-scopes":["visitor_management:write:check_in","visitor_management:write:check_in:admin"]}}},"/workspaces":{"get":{"tags":["Workspaces"],"summary":"List workspaces","description":"List a location's workspaces.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read`,`workspace:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read:list_workspaces`,`workspace:read:list_workspaces:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"listWorkspaces","parameters":[{"name":"location_id","in":"query","description":"The location's ID.","required":true,"schema":{"type":"string","example":"49D7a0xPQvGQ2DCMZgSe7w"}},{"name":"workspace_name","in":"query","description":"The name of the workspace.","required":false,"schema":{"type":"string","example":"Test Desk"}},{"name":"workspace_type","in":"query","description":"The type of workspace. If empty, the default will return desk and room types.","required":false,"schema":{"type":"string","example":"commonWorkspace","enum":["commonWorkspace","desk","room"]}},{"name":"reserve_user","in":"query","description":"The user who wants to reserve the workspace. The default will be the user making the request.","required":false,"schema":{"type":"string","example":"zwKiV80hQ7CwRg9BEm0Bvw"}},{"name":"page_size","in":"query","description":"The number of records returned within a single API call.","required":false,"schema":{"type":"integer","example":30}},{"name":"next_page_token","in":"query","description":"Use the next page token to paginate through large result sets. A next page token is returned whenever the set of available results exceeds the current page size. This token's expiration period is 15 minutes.","required":false,"schema":{"type":"string","example":"IAfJX3jsOLW7w3dokmFl84zOa0MAVGyMEB2"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200`   \n \n Workspace list returned.","content":{"application/json":{"schema":{"type":"object","properties":{"next_page_token":{"type":"string","description":"The next page token used to paginate through large result sets. A next page token is returned whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes.","example":"At6eWnFZ1FB3arCXnRxqHLXKhbDW18yz2i2"},"page_size":{"maximum":300,"type":"integer","description":"The number of records returned within a single API call.","example":30,"default":30},"total_records":{"type":"integer","description":"The total number of all records available across pages.","example":20},"workspaces":{"maxItems":1000,"type":"array","description":"Information about the workspace.","items":{"type":"object","properties":{"id":{"type":"string","description":"The workspace's ID.","example":"qMOLddnySIGGVycz8aX_JQ"},"workspace_name":{"maxLength":64,"type":"string","description":"The workspace's name.","example":"My Room"},"workspace_type":{"type":"string","description":"The workspace's type: \n* `Desk`\n* `Room`\n* `CommonWorkspace`.","example":"desk","enum":["desk","room","commonWorkspace"]},"location_id":{"type":"string","description":"The location ID of the place where the Zoom Room was added.","example":"49D7a0xPQvGQ2DCMZgSe7w"},"capacity":{"type":"string","description":"The capacity of the workspace.","example":"30"},"construction_status":{"type":"boolean","description":"The construction status.","example":true},"room_images":{"maxItems":6,"type":"array","description":"The room images.","items":{"type":"string","description":"Room image URL.","example":"https://image.url"}},"requires_approval":{"type":"boolean","description":"Whether the workspace requires admin approval.","example":true},"asset_ids":{"type":"array","description":"Workspace asset IDs.","items":{"type":"string","description":"Workspace asset ID.","example":"acf7a8844f35426bb993b3db2c0501dd"}},"point_coordinate_x":{"maximum":0,"minimum":0,"type":"number","description":"The x-coordinate of a point picture on the floor map, such as a desk.","format":"double","example":721.614983},"point_coordinate_y":{"type":"number","description":"The y-coordinate of a point picture on the floor map, such as a desk.","format":"double","example":405.104484},"point_coordinate_radius":{"type":"integer","description":"The radius of a point picture on the floor map, such as a desk.","example":17},"polygon_coordinates":{"maxItems":50,"minItems":0,"type":"array","description":"The coordinates of a polygon picture on the floor map, such as rooms.","example":"","items":{"type":"object","properties":{"polygon_coordinate_x":{"type":"number","description":"The x-coordinate of an angle in a polygonal image on a floor plan, such as a room.","format":"double","example":233.22},"polygon_coordinate_y":{"type":"number","description":"The y-coordinate of an angle in a polygonal image on a floor plan, such as a room.","format":"double","example":347.12}}}}}}}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `2` <br>\n * ZR core service is disabled. Try again later. \n* ZR core system error. Try again later. <br>\n**Error Code:** `200` <br>\n * Zoom Workspace Reservation subscription was not found. Try again after purchasing a Zoom Workspace Reservation subscription. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:read","workspace:read:admin","workspace:read:list_workspaces","workspace:read:list_workspaces:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["WorkspacesManagement:Read"],"x-macro-scopes":["workspace:read","workspace:read:admin"],"x-granular-scopes":["workspace:read:list_workspaces","workspace:read:list_workspaces:admin"]}},"post":{"tags":["Workspaces"],"summary":"Create a workspace","description":"Creates workspaces.  \n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:write:workspace:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"createWorkspace","requestBody":{"content":{"application/json":{"schema":{"required":["location_id","workspace_name","workspace_type"],"type":"object","properties":{"location_id":{"type":"string","description":"The location's ID.","example":"49D7a0xPQvGQ2DCMZgSe7w"},"workspace_name":{"maxLength":64,"type":"string","description":"The workspace's name.","example":"My Room"},"workspace_type":{"type":"string","description":"The workspace's type: \n* `desk` \n* `room`","example":"desk","enum":["desk","room"]},"calendar_resource_id":{"type":"string","description":"The calendar resource's ID.","example":"rNQUpdDXySFGhVycz7aR-SR"}}}}}},"responses":{"201":{"description":"**HTTP Status Code:** `201`   \n \n Created.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"The workspace's ID.","example":"qMOLddnySIGGVycz8aX_JQ"}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `2` <br>\n * ZR core service is disabled. Try again later. \n* ZR core system error. Try again later. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:write:admin","workspace:write:workspace:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["workspace:write:admin"],"x-granular-scopes":["workspace:write:workspace:admin"]}}},"/workspaces/additional_informations":{"get":{"tags":["Workspaces"],"summary":"List workspace additional information with time range","description":"List a location's workspaces' additional information within a specified time range.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read:admin`,`workspace:read`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read:list_workspaces`,`workspace:read:list_workspaces:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"Getaworkspaceadditionalenhancements","parameters":[{"name":"from","in":"query","description":"The start date of the query.","required":true,"schema":{"type":"string","format":"date-time","example":"2021-03-18T05:41:36Z"}},{"name":"to","in":"query","description":"The end date and time of the query range. Can be up to 14 days in the future.","required":true,"schema":{"type":"string","format":"date-time","example":"2021-03-18T05:41:36Z"}},{"name":"reserve_user","in":"query","description":"The user who wants to reserve a workspace. Defaults to the user making the request.","required":false,"schema":{"type":"string","example":"zwKiV80hQ7CwRg9BEm0Bvw"}},{"name":"location_id","in":"query","description":"The location's ID.","required":true,"schema":{"type":"string","example":"49D7a0xPQvGQ2DCMZgSe7w"}},{"name":"workspace_type","in":"query","description":"The type of workspace to filter by. If empty, returns both desk and room types by default.","required":false,"schema":{"type":"string","example":"desk","enum":["desk","room"]}},{"name":"page_size","in":"query","description":"The number of records returned within a single API call.","required":false,"schema":{"type":"integer","example":30}},{"name":"next_page_token","in":"query","description":"Use the next page token to paginate through large result sets. A next page token is returned whenever the set of available results exceeds the current page size. This token's expiration period is 15 minutes.","required":false,"schema":{"type":"string","example":"IAfJX3jsOLW7w3dokmFl84zOa0MAVGyMEB2"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200`   \n \n Workspace list with additional information returned.","content":{"application/json":{"schema":{"type":"object","properties":{"next_page_token":{"type":"string","description":"The next page token used to paginate through large result sets. A next page token is returned whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes.","example":"At6eWnFZ1FB3arCXnRxqHLXKhbDW18yz2i2"},"page_size":{"maximum":300,"type":"integer","description":"The number of records returned within a single API call.","example":30,"default":30},"workspaces":{"maxItems":1000,"type":"array","description":"Information about the workspaces.","items":{"type":"object","properties":{"id":{"type":"string","description":"The workspace's ID.","example":"qMOLddnySIGGVycz8aX_JQ"},"workspace_status":{"type":"string","description":"The current status of the workspace.","example":"free"},"workspace_name":{"maxLength":64,"type":"string","description":"The workspace's name.","example":"My Room"},"workspace_type":{"type":"string","description":"The workspace's type: \n* `Desk`\n* `Room`\n* `CommonWorkspace`.","example":"desk","enum":["desk","room"]},"location_id":{"type":"string","description":"The location ID of the place where the Zoom Room was added.","example":"49D7a0xPQvGQ2DCMZgSe7w"},"capacity":{"type":"string","description":"The capacity of the workspace","example":"30"},"construction_status":{"type":"boolean","description":"The construction status","example":true},"room_images":{"type":"array","description":"The room images","items":{"type":"string","description":"URL of the workspace image.","example":"https://image.url"}},"requires_approval":{"type":"boolean","description":"Indicates whether the workspace requires admin approval for reservations.","example":true},"available":{"type":"boolean","description":"Indicates whether the workspace is available for the specified user during the given time range.","example":true},"reserve_permission":{"type":"boolean","description":"Indicates whether the specified user has permission to reserve this workspace.","example":true},"asset_ids":{"type":"array","description":"List of asset identifiers associated with the workspace.","items":{"type":"string","description":"The workspace asset ID","example":"acf7a8844f35426bb993b3db2c0501dd"}},"max_reserve_duration":{"type":"integer","description":"The workspace's amount of time that you can reserve in hours. ","example":8},"point_coordinate_x":{"type":"number","description":"The x-coordinate of the workspace's position on the floor map.","format":"double","example":721.614983},"point_coordinate_y":{"type":"number","description":"The y-coordinate of the workspace's position on the floor map.","format":"double","example":405.104484},"point_coordinate_radius":{"type":"integer","description":"The radius of the workspace's representation on the floor map.","example":17},"polygon_coordinates":{"maxItems":50,"minItems":0,"type":"array","description":"The coordinates defining the workspace's polygonal boundary on the floor map.","items":{"type":"object","properties":{"polygon_coordinate_x":{"type":"number","description":"The x-coordinate of a polygon vertex on the floor map.","format":"double","example":233.22},"polygon_coordinate_y":{"type":"number","description":"The y-coordinate of a polygon vertex on the floor map.","format":"double","example":347.12}}}}}}}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:read:admin","workspace:read","workspace:read:list_workspaces","workspace:read:list_workspaces:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["WorkspacesManagement:Read"],"x-macro-scopes":["workspace:read:admin","workspace:read"],"x-granular-scopes":["workspace:read:list_workspaces","workspace:read:list_workspaces:admin"]}}},"/workspaces/assets":{"get":{"tags":["Workspaces"],"summary":"Get all workspace assets","description":"List all workspace assets.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read:asset:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"Getallworkspaceassets","parameters":[{"name":"next_page_token","in":"query","description":"Use the next page token to paginate through large result sets. A next page token is returned whenever the set of available results exceeds the current page size.","required":false,"schema":{"type":"string","example":"n28bw3MswE5HKRqwrmxuR2aAoAcXZflOw72"}},{"name":"page_size","in":"query","description":"The number of records returned within a single API call.","required":false,"schema":{"type":"integer","example":10}}],"responses":{"200":{"description":"Workspace assets successfully returned.","content":{"application/json":{"schema":{"type":"object","properties":{"assets":{"maxItems":1000,"type":"array","description":"The list of assets being returned.","items":{"required":["asset_id","name"],"type":"object","properties":{"name":{"type":"string","description":"The asset's name.","example":"TV223"},"asset_id":{"type":"string","description":"Workspace asset ID.","example":"ab31d714b3644dc79681041709aeb4ab"}}}},"next_page_token":{"type":"string","description":"Token to retrieve the next page.","example":"n28bw3MswE5HKRqwrmxuR2aAoAcXZflOw72"},"page_size":{"type":"number","description":"The number of records returned within a single API call.","example":15}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `30054002` <br>\n User does not exist. <br>\n**Error Code:** `300520001` <br>\n Unknown error. <br>\n"},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:read:admin","workspace:read:asset:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["WorkspacesManagement:Read"],"x-macro-scopes":["workspace:read:admin"],"x-granular-scopes":["workspace:read:asset:admin"]}},"post":{"tags":["Workspaces"],"summary":"Create a workspace asset","description":"Create a new workspace asset.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:write:asset:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"AddaWorkspaceasset","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"The name of the asset that needs to be added.","example":"monitor"}}}}}},"responses":{"201":{"description":"Workspace asset created successfully. ","content":{"application/json":{"schema":{"type":"object","properties":{"asset_id":{"type":"string","description":"The ID of the newly created workspace asset.","example":"evnadfhayt23bakfhak12"}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `300520001` <br>\n Input validation error. <br>\n"},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:write:admin","workspace:write:asset:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["workspace:write:admin"],"x-granular-scopes":["workspace:write:asset:admin"]}}},"/workspaces/assets/{assetId}":{"get":{"tags":["Workspaces"],"summary":"Get a workspace asset","description":"Create a workspace asset based on the asset ID. \n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read:asset:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"get_workspace_asset","parameters":[{"name":"assetId","in":"path","description":"Unique ID that represents the workspace asset.","required":true,"schema":{"type":"string","example":"ab31d714b3644dc79681041709aeb4ab"}}],"responses":{"200":{"description":"Workspace asset returned successfully.","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Workspace asset name.","example":"Monitor"},"asset_id":{"type":"string","description":"Workspace asset ID.","example":"acf7a8844f35426bb993b3db2c0501dd"}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `30051005` <br>\n Missing required input : assetId. <br>\n**Error Code:** `300520001` <br>\n Unknown error. <br>\n"},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:read:admin","workspace:read:asset:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["workspace:read:admin"],"x-granular-scopes":["workspace:read:asset:admin"]}},"delete":{"tags":["Workspaces"],"summary":"Delete a workspace asset","description":"Delete a workspace asset by asset ID.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:delete:asset:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"DeleteaWorkspaceasset","parameters":[{"name":"assetId","in":"path","description":"A unique ID that represents the workspace asset. ","required":true,"schema":{"type":"string","example":"ab31d714b3644dc79681041709aeb4ab"}}],"responses":{"204":{"description":"Workspace asset deleted successfully."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `30051005` <br>\n Missing required input : assetId. <br>\n**Error Code:** `300520001` <br>\n Unknown error. <br>\n"},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:write:admin","workspace:delete:asset:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["workspace:write:admin"],"x-granular-scopes":["workspace:delete:asset:admin"]}},"patch":{"tags":["Workspaces"],"summary":"Edit a workspace asset","description":"Edit the workspace's asset based on asset ID. \n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:update:asset:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"PatchWorkspaceasset","parameters":[{"name":"assetId","in":"path","description":"The unique ID of an asset that needs to be edited.","required":true,"schema":{"type":"string","example":"ab31d714b3644dc79681041709aeb4ab"}}],"requestBody":{"description":"Edit the workspace asset. ","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"The asset's name.","example":"ultra wide gaming monitor"}}}}}},"responses":{"204":{"description":"Workspace asset edited successfully."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `30051005` <br>\n Missing required input : Name. <br>\n**Error Code:** `300520001` <br>\n Unknown error. <br>\n"},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:write:admin","workspace:update:asset:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["workspace:write:admin"],"x-granular-scopes":["workspace:update:asset:admin"]}}},"/workspaces/events":{"post":{"tags":["Workspaces"],"summary":"Check in/out of a reservation","description":"Use this API to check in to or out of a reservation. This API does not support Zoom Room Desk and Common Area Phone Desk. \n\n \n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:write:events`,`workspace:write:events:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"reservationEvent","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"method":{"type":"string","description":"The method that you would like to control.","example":"check_in","enum":["check_in","check_out"]},"params":{"type":"object","properties":{"workspace_id":{"type":"string","description":"The workspace's ID.","example":"qMOLddnySIGGVycz8aX_JQ"},"user_id":{"type":"string","description":"The user's ID.","example":"_0ctZtY0REqWalTmwvrdIw"},"reservation_id":{"type":"string","description":"The reservation's ID.","example":"ebrg2b87a6uu9c678qhvsiahsc"}},"description":"Use **workspace_id** &amp; **user_id** or just **reservation_id** to define which reservation to check in or check out."}}}}}},"responses":{"204":{"description":"**HTTP Status Code:** `204`   \n \n No Content."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `2` <br>\n * ZR core service is disabled. Try again later. \n* ZR core system error. Try again later. <br>\n**Error Code:** `200` <br>\n * Zoom Workspace Reservation subscription was not found. Try again after purchasing a Zoom Workspace Reservation subscription. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:write:admin","workspace:write:events","workspace:write:events:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["workspace:write:admin"],"x-granular-scopes":["workspace:write:events","workspace:write:events:admin"]}}},"/workspaces/floormap/files":{"post":{"tags":["Workspaces"],"summary":"Add or Update a Workspace floor map","description":"Use this API to Add or Update a Workspace floor map.  \n\n**Prerequisite:**   The caller must be a Zoom Workspace licensed user\n**Note:**   Base URL: `https://fileapi.zoom.us/v2/`\n* Rate limit: 20 requests per second per user or 2000 requests per second per IP address\n* The caller must support HTTP 30x redirects\n* The caller must retain the Authorization header when redirected to a different hostname\n* JPG/JPEG, 24-bit PNG, PDF\n* Recommended dimensions - 1920 x 1080 (landscape) for 16:9 aspect ratio displays\n* Maximum dimensions - 6000 x 4000 (landscape)\n* Your object size should no more than 10M\n\n  \n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:write:location`,`workspace:write:location:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`\n\n**Not supported in Gov cluster** ","operationId":"AddOrUpdateAWorkspaceFloorMap","requestBody":{"content":{"multipart/form-data":{"schema":{"required":["file","location_id"],"type":"object","properties":{"file":{"type":"string","description":"Upload image.\n* JPG/JPEG, 24-bit PNG, PDF.\n* Recommended dimensions - 1920 x 1080 (landscape) for 16:9 aspect ratio displays.\n* Maximum dimensions - 6000 x 4000 (landscape).","format":"binary","example":""},"location_id":{"type":"string","description":"Location ID of the place where the Zoom Room was added.","example":"ry6d7lrSR4qqxC11HQ30lc"}}}}}},"responses":{"201":{"description":"**HTTP Status Code:** `201` **OK**  \n \nWorkspace floor map added or updated successfully.","content":{"application/json":{"schema":{"type":"object","properties":{"file_id":{"type":"string","description":"The file ID.","example":"L38yKqXzT7SKinGI0jyFHA"}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  1. Floor map check failed\n2. Floor map exceed the pixel limit \n\n "},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  Location not found. \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:write:admin","workspace:write:location","workspace:write:location:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["WorkspacesManagement:Edit"],"x-macro-scopes":["workspace:write:admin"],"x-granular-scopes":["workspace:write:location","workspace:write:location:admin"]}}},"/workspaces/floors/{floorId}/reservations":{"get":{"tags":["Workspaces"],"summary":"Get a floor's reservations","description":"Retrieves a floor's reservations.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `dashboard:read:admin`,`workspace:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read:list_floor_workspace_reservations:admin`,`workspace:read:list_floor_workspace_reservations:master`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"Getafloor'sreservations","parameters":[{"name":"floorId","in":"path","description":"The floor's ID.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}},{"name":"from","in":"query","description":"The start date of the query.","required":true,"schema":{"type":"string","example":"2021-03-18T05:41:36Z"}},{"name":"to","in":"query","description":"The end date of the query. Can be up to 1 day.","required":true,"schema":{"type":"string","example":"2021-03-21T05:41:36Z"}},{"name":"workspace_type","in":"query","description":"Workspace type. `all` - Query rooms and desks. `desk` - Query desks. `room` - Query rooms.","required":false,"schema":{"type":"string","example":"all","default":"all","enum":["all","desk","room"]}},{"name":"enable_export_calendar_data","in":"query","description":"Enable calendar data export. `true` - Enables export. `false` - Disables export. Default is `false`.","required":false,"schema":{"type":"boolean","example":false}}],"responses":{"200":{"description":"Reservations returned.","content":{"application/json":{"schema":{"type":"object","properties":{"reservations":{"maxItems":10000,"type":"array","description":"List of reservations.","items":{"type":"object","properties":{"reservation_date":{"type":"string","description":"The reservation's start date in UTC.","example":"2025-03-16"},"source":{"type":"string","description":"The data source.","example":"Calendar","enum":["Calendar","Workspace Open API","Kiosk","Workspace Portal","Workspace App","Hot Desk","Scheduling Display","Mobile Phone","Outlook Add-in","Google Extension","Assigned desk","Zoom Calendar","N/A"]},"reservation_start_time":{"type":"string","description":"The reservation's start time in UTC, formatted in ISO 8601.","example":"2025-03-16T09:00:00Z"},"reservation_end_time":{"type":"string","description":"The reservation's end time in UTC, formatted in ISO 8601.","example":"2025-03-16T10:00:00Z"},"workspace_location":{"type":"string","description":"The location path of the workspace.","example":"Building A / Floor 1"},"workspace_name":{"type":"string","description":"The workspace's name.","example":"Desk-001"},"workspace_type":{"type":"string","description":"The workspace's type.","example":"Desk","enum":["Reservation Only Room","Desk","Zoom Room","N/A"]},"desk_device_type":{"type":"string","description":"The workspace's device type.","example":"Zoom Rooms","enum":["Zoom Rooms","Zoom Phone","N/A"]},"user_name":{"type":"string","description":"The name of the user who made the reservation.","example":"John Doe"},"user_email":{"type":"string","description":"The email address of the user who made the reservation.","example":"john.doe@example.com"},"user_department":{"type":"string","description":"The department of the user who made the reservation.","example":"Engineering"},"checkin_time":{"type":"string","description":"The check-in time in UTC, formatted in ISO 8601.","example":"2025-03-16T09:05:00Z"},"checkout_time":{"type":"string","description":"The check-out time in UTC, formatted in ISO 8601.","example":"2025-03-16T09:55:00Z"},"reservation_book_time":{"type":"string","description":"The reservation's booking time in UTC, formatted in ISO 8601.","example":"2025-03-15T14:00:00Z"},"assets":{"type":"string","description":"The workspace's assets.","example":"Monitor, Keyboard"},"capacity":{"type":"string","description":"The capacity of the workspace. For Zoom Rooms, `N/A` indicates no configuration. For desks, `N/A` indicates the absence of this concept.","example":"1"},"neighborhood_group":{"type":"string","description":"The reservation's neighborhood group name.","example":"Zone A"}},"description":"Information about the reservation."}}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `30059011` <br>\n Invalid parameters. <br>\n"},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n "}},"security":[{"openapi_oauth":["dashboard:read:admin","workspace:read:admin","workspace:read:list_floor_workspace_reservations:admin","workspace:read:list_floor_workspace_reservations:master"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["WorkspacesManagement:Read","DashboardWR:Read"],"x-macro-scopes":["dashboard:read:admin","workspace:read:admin"],"x-granular-scopes":["workspace:read:list_floor_workspace_reservations:admin","workspace:read:list_floor_workspace_reservations:master"]}}},"/workspaces/locations/{locationId}/floor_map":{"get":{"tags":["Workspaces"],"summary":"Get a workspace location floor map","description":"Get a location's floor map.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read`,`workspace:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read:location`,`workspace:read:location:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"Getlocationfloormap","parameters":[{"name":"locationId","in":"path","description":"Location ID of the background in.","required":true,"schema":{"type":"string","example":"ry6d7lrSR4qqxC11HQ30lc"}}],"responses":{"200":{"description":"Get a location's floor map.","content":{"application/json":{"schema":{"type":"object","properties":{"background_map_url":{"type":"string","description":"The URL to retrieve the background map. The token expires in 1 day.","example":"https://file.zoom.us/file/asdwqegthr?business=zr&jwt=srgsrtert"},"background_map_width":{"type":"integer","description":"The background width.","example":800},"background_map_height":{"type":"integer","description":"The background height.","example":600},"canvas_width":{"type":"integer","description":"The canvas width used to display the background map.","example":1272},"canvas_height":{"type":"integer","description":"The canvas height used to display the background map.","example":720},"point_size":{"type":"integer","description":"The default size of point picture on floor map.","example":10}}}}}},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n **Error Code:** `30059620` <br>\n Access restricted. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `30051005` <br>\n Location not found. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:read","workspace:read:admin","workspace:read:location","workspace:read:location:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["workspace:read","workspace:read:admin"],"x-granular-scopes":["workspace:read:location","workspace:read:location:admin"]}}},"/workspaces/locations/{locationId}/neighborhoods":{"get":{"tags":["Workspaces"],"summary":"List neighborhoods","description":"List a floor's neighborhoods with optional neighborhood, workspace, user, or group filters.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read:neighborhood:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"ListNeighborhoods","parameters":[{"name":"locationId","in":"path","description":"The floor location's ID.","required":true,"schema":{"type":"string","example":"49D7a0xPQvGQ2DCMZgSe7w"}},{"name":"neighborhood_ids","in":"query","description":"Neighborhood IDs.","required":false,"schema":{"type":"array","example":["acf7a8844f35426bb993b3db2c0501dd"],"items":{"type":"string"}}},{"name":"workspace_ids","in":"query","description":"Workspace IDs. Return neighborhoods that contain any of the specified workspaces.","required":false,"schema":{"type":"array","example":["qMOLddnySIGGVycz8aX_JQ"],"items":{"type":"string"}}},{"name":"user_ids","in":"query","description":"User IDs. Return neighborhoods that allow any of the specified users.","required":false,"schema":{"type":"array","example":["zwKiV80hQ7CwRg9BEm0Bvw"],"items":{"type":"string"}}},{"name":"group_ids","in":"query","description":"User group IDs. Return neighborhoods that allow any of the specified user groups.","required":false,"schema":{"type":"array","example":["xGm7n9PTQGe5fT0S9sR2Dw"],"items":{"type":"string"}}}],"responses":{"200":{"description":"**HTTP Status Code:** `200`   \n \n Neighborhood list returned.","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"array","description":"Information about the neighborhoods.","items":{"type":"object","properties":{"neighborhood_id":{"type":"string","description":"The neighborhood's ID.","example":"acf7a8844f35426bb993b3db2c0501dd"},"location_id":{"type":"string","description":"The floor location's ID.","example":"49D7a0xPQvGQ2DCMZgSe7w"},"name":{"type":"string","description":"The neighborhood's name.","example":"Engineering Neighborhood"},"workspace_ids":{"type":"array","description":"Workspace IDs in the neighborhood.","items":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}},"allow_user_ids":{"type":"array","description":"User IDs allowed to use the neighborhood.","items":{"type":"string","example":"zwKiV80hQ7CwRg9BEm0Bvw"}},"allow_user_group_ids":{"type":"array","description":"User group IDs allowed to use the neighborhood.","items":{"type":"string","example":"xGm7n9PTQGe5fT0S9sR2Dw"}},"enabled_custom_work_time":{"type":"boolean","description":"Whether custom work time is enabled for the neighborhood.","example":true},"hide_group_border":{"type":"boolean","description":"Whether to hide the neighborhood border on the floor map.","example":false},"restrict_member_assigned":{"type":"boolean","description":"Whether members are restricted to assigned workspaces in the neighborhood.","example":false},"work_time_rule":{"type":"object","properties":{"rule_type":{"type":"integer","description":"The work time rule type. `0` means weekly.","example":0,"enum":[0]},"time_zone":{"type":"string","description":"The time zone used by the work time rule.","example":"America/Los_Angeles"},"rule_start_time":{"type":"string","description":"The rule start time in the configured time zone.","example":"09:00:00"},"rule_end_time":{"type":"string","description":"The rule end time in the configured time zone.","example":"17:00:00"},"rule_days":{"type":"array","description":"Weekdays included in the rule.","items":{"type":"string","example":"MONDAY","enum":["SUNDAY","MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY"]}}},"description":"The neighborhood's custom work time rule. Returned when custom work time is enabled."}}}}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n "},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:read:admin","workspace:read:neighborhood:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["WorkspacesManagement:Read"],"x-macro-scopes":["workspace:read:admin"],"x-granular-scopes":["workspace:read:neighborhood:admin"]}},"delete":{"tags":["Workspaces"],"summary":"Delete neighborhoods","description":"Delete one or more neighborhoods from a floor.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:delete:neighborhood:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"DeleteNeighborhoods","parameters":[{"name":"locationId","in":"path","description":"The floor location's ID.","required":true,"schema":{"type":"string","example":"49D7a0xPQvGQ2DCMZgSe7w"}},{"name":"neighborhood_ids","in":"query","description":"Neighborhood IDs. If any neighbor does not exist, the deletion operation will stop.","required":true,"schema":{"maxItems":50,"minItems":1,"type":"array","example":["acf7a8844f35426bb993b3db2c0501dd"],"items":{"type":"string"}}}],"responses":{"204":{"description":"**HTTP Status Code:** `204`   \n \n Neighborhoods deleted."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n "},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:write:admin","workspace:delete:neighborhood:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["WorkspacesManagement:Edit"],"x-macro-scopes":["workspace:write:admin"],"x-granular-scopes":["workspace:delete:neighborhood:admin"]}}},"/workspaces/locations/{locationId}/neighborhoods/{neighborhoodId}":{"get":{"tags":["Workspaces"],"summary":"Get a neighborhood","description":"Get a neighborhood by ID.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read:neighborhood:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"GetNeighborhood","parameters":[{"name":"locationId","in":"path","description":"The floor location's ID.","required":true,"schema":{"type":"string","example":"49D7a0xPQvGQ2DCMZgSe7w"}},{"name":"neighborhoodId","in":"path","description":"The neighborhood's ID.","required":true,"schema":{"type":"string","example":"acf7a8844f35426bb993b3db2c0501dd"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200`   \n \n Neighborhood returned.","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","properties":{"neighborhood_id":{"type":"string","description":"The neighborhood's ID.","example":"acf7a8844f35426bb993b3db2c0501dd"},"location_id":{"type":"string","description":"The floor location's ID.","example":"49D7a0xPQvGQ2DCMZgSe7w"},"name":{"type":"string","description":"The neighborhood's name.","example":"Engineering Neighborhood"},"workspace_ids":{"type":"array","description":"Workspace IDs in the neighborhood.","items":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}},"allow_user_ids":{"type":"array","description":"User IDs allowed to use the neighborhood.","items":{"type":"string","example":"zwKiV80hQ7CwRg9BEm0Bvw"}},"allow_user_group_ids":{"type":"array","description":"User group IDs allowed to use the neighborhood.","items":{"type":"string","example":"xGm7n9PTQGe5fT0S9sR2Dw"}},"enabled_custom_work_time":{"type":"boolean","description":"Whether custom work time is enabled for the neighborhood.","example":true},"hide_group_border":{"type":"boolean","description":"Whether to hide the neighborhood border on the floor map.","example":false},"restrict_member_assigned":{"type":"boolean","description":"Whether members are restricted to assigned workspaces in the neighborhood.","example":false},"work_time_rule":{"type":"object","properties":{"rule_type":{"type":"integer","description":"The work time rule type. `0` means weekly.","example":0,"enum":[0]},"time_zone":{"type":"string","description":"The time zone used by the work time rule.","example":"America/Los_Angeles"},"rule_start_time":{"type":"string","description":"The rule start time in the configured time zone.","example":"09:00:00"},"rule_end_time":{"type":"string","description":"The rule end time in the configured time zone.","example":"17:00:00"},"rule_days":{"type":"array","description":"Weekdays included in the rule.","items":{"type":"string","example":"MONDAY","enum":["SUNDAY","MONDAY","TUESDAY","WEDNESDAY","THURSDAY","FRIDAY","SATURDAY"]}}},"description":"The neighborhood's custom work time rule. Returned when custom work time is enabled."}},"description":"Information about the neighborhood."}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n "},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:read:admin","workspace:read:neighborhood:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["WorkspacesManagement:Read"],"x-macro-scopes":["workspace:read:admin"],"x-granular-scopes":["workspace:read:neighborhood:admin"]}}},"/workspaces/questionnaires_summary":{"get":{"tags":["Workspaces"],"summary":"Get questionnaire answer summary","description":"Retrieves a summary of questionnaire answers for specified locations within a date range.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read:workspace_reservation_questionnaire_response:admin`,`workspace:read:workspace_reservation_questionnaire_response:master`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `HEAVY`","operationId":"Getworkspacequestionnaireresponses","parameters":[{"name":"from","in":"query","description":"The start date and time of the query range.","required":true,"schema":{"type":"string","format":"date-time","example":"2021-03-18T05:41:36Z"}},{"name":"to","in":"query","description":"The end date and time of the query range. Can be up to 7 days after the start date.","required":true,"schema":{"type":"string","format":"date-time","example":"2021-03-18T05:41:36Z"}},{"name":"location_ids","in":"query","description":"The location IDs for which to query questionnaire responses.","required":true,"schema":{"maxItems":50,"minItems":1,"type":"array","example":["49D7a0xPQvGQ2DCMZgSe7w"],"items":{"type":"string"}}},{"name":"subject","in":"query","description":"The questionnaire's subject.","required":true,"schema":{"type":"string","example":"reservation","enum":["reservation","pre_checkin"]}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` <br>\n OK","content":{"application/json":{"schema":{"type":"object","properties":{"questionnaire_response":{"maxItems":20,"type":"array","description":"An array of questionnaire responses.","items":{"required":["id","list","subject","title"],"type":"object","properties":{"id":{"type":"string","description":"The questionnaire's ID.","example":"Fl75C43YTmS_IpMzYLipJw"},"title":{"type":"string","description":"The questionnaire's title.","example":"Reservation Questionnaire"},"subject":{"type":"string","description":"The questionnaire's subject.","example":"reservation"},"list":{"maxItems":50,"type":"array","description":"The list of questions.","items":{"required":["question_id","required","title","type"],"type":"object","properties":{"question_id":{"type":"string","description":"The question's ID.","example":"0ds1NFeDQ1WfWlgVK-7OMQ"},"title":{"type":"string","description":"The question's title.","example":"question single example"},"type":{"type":"string","description":"The question's type.","example":"single","enum":["single","multiple","short","long","number"]},"required":{"type":"boolean","description":"Indicates whether this question requires an answer.","example":false},"options_summary":{"maxItems":10,"type":"array","description":"A summary of the question's options and their selection counts.","items":{"type":"object","properties":{"option_id":{"type":"string","description":"The question option's ID.","example":"UClQqM1qT_q-bZQ0Xti7Vw"},"text":{"type":"string","description":"The question option's text.","example":"Yes"},"count":{"type":"integer","description":"The number of times this option was selected.","example":1}}}},"text_summary":{"type":"array","description":"An array of text responses for text-based questions.","items":{"type":"string","description":"A text response.","example":"text answer"}},"number_summary":{"type":"integer","description":"A summary of numeric question answers.","example":100}}}}}}}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n "},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:read:admin","workspace:read:workspace_reservation_questionnaire_response:admin","workspace:read:workspace_reservation_questionnaire_response:master"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["WorkspacesManagement:Read"],"x-macro-scopes":["workspace:read:admin"],"x-granular-scopes":["workspace:read:workspace_reservation_questionnaire_response:admin","workspace:read:workspace_reservation_questionnaire_response:master"]}}},"/workspaces/released_workspaces_by_timeout":{"get":{"tags":["Workspaces"],"summary":"List released workspaces by timeout","description":"Lists workspaces that were released due to missing check-in or checkout information. The maximum query time interval is one month.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read:admin`,`room:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:read:list_release_infos:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"getWorksapceReservationReleaseInof","parameters":[{"name":"from","in":"query","description":"The start time of the query corresponding to the room reservation start time. The timezone is UTC.","required":true,"schema":{"type":"string","example":"2025-05-31"}},{"name":"to","in":"query","description":"The end time of the query corresponding to the room reservation end time. The timezone is UTC.","required":true,"schema":{"type":"string","example":"2025-06-02"}},{"name":"location_id","in":"query","description":"The location ID for the queried location.","required":true,"schema":{"type":"string","example":"RWpLdGEAQeiXQ6JAwLCO1g"}},{"name":"workspace_type","in":"query","description":"Workspace type.\n\n`all` - Query rooms and desks.\n`desk` - Query desks.\n`room` - Query rooms.","required":true,"schema":{"type":"string","example":"all","enum":["all","desk","room"]}},{"name":"snapshot_date","in":"query","description":"Location snapshot time. Uses UTC time. The `snapshot_date` must be between the `start_date` and `end_date`.","required":true,"schema":{"type":"string","example":"2025-06-02"}},{"name":"page_size","in":"query","description":"The number of records returned within a single API call.","required":false,"schema":{"type":"integer","example":30}},{"name":"next_page_token","in":"query","description":"Use the next page token to paginate through large result sets. A next page token is returned whenever the set of available results exceeds the current page size. This token's expiration period is 15 minutes.","required":false,"schema":{"type":"string","example":"IAfJX3jsOLW7w3dokmFl84zOa0MAVGyMEB2"}}],"responses":{"200":{"description":"Successfully retrieved the release information list.","content":{"application/json":{"schema":{"type":"object","properties":{"next_page_token":{"type":"string","description":"The next page token used to paginate through large result sets. A next page token is returned whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes.","example":"At6eWnFZ1FB3arCXnRxqHLXKhbDW18yz2i2"},"page_size":{"maximum":300,"type":"integer","description":"The number of records returned within a single API call.","example":30,"default":30},"total_records":{"type":"integer","description":"The total number of all records available across pages.","example":20},"release_events":{"maxItems":300,"minItems":0,"type":"array","description":"Release information for workspace reservations.","items":{"required":["event_id","recurring_meeting","reservation_end_time","reservation_start_time","timezone","workspace_id","workspace_name","workspace_type"],"type":"object","properties":{"event_id":{"type":"string","description":"The event ID.","example":"qMOLddnySIGGVycz8aX_JQ"},"workspace_id":{"type":"string","description":"The workspace ID.","example":"qMOLddnySIGGVycz8aX_JQ"},"location_id":{"type":"string","description":"The location ID for the queried location.","example":"6wXGGQvwQb2hpnHekQxMsw"},"workspace_name":{"type":"string","description":"The workspace name.","example":"My Room"},"workspace_type":{"type":"string","description":"The workspace type.","example":"all","enum":["all","desk","room"]},"user_name":{"type":"string","description":"The Zoom username for the workspace reservation.","example":"san zhang"},"user_email":{"type":"string","description":"The user email for the workspace reservation.","example":"jchill@example.com"},"timezone":{"type":"string","description":"The reservation timezone.","example":"Asia/Shanghai"},"reservation_start_time":{"type":"string","description":"The reservation start time in UTC.","example":"2021-03-18T05:00:36Z"},"reservation_end_time":{"type":"string","description":"The reservation end time in UTC.","example":"2021-03-18T05:30:36Z"},"recurring_meeting":{"type":"boolean","description":"Whether this is a recurring meeting.","example":true},"checkin_time":{"type":"string","description":"The check-in time in UTC, or 'No check-in' if no check-in occurred.","example":"2021-03-18T05:00:36Z"},"checkout_time":{"type":"string","description":"The checkout time in UTC, or 'Auto-released' if automatically released.","example":"2021-03-18 T05:30:36Z"},"release_flag":{"type":"boolean","description":"Whether this meeting was released before the reservation end time.","example":true},"release_time":{"type":"string","description":"The time when the meeting was released in UTC.","example":"2021-03-18T05:30:36Z"},"release_reason":{"type":"string","description":"The reason why the room was released.\n\n* `Cancellation` - This event was deleted.\n* `No check in/auto release` - The event was automatically released due to no check-in within the specified time.\n* `User check out` - The user checked out.","example":"Cancellation","enum":["Cancellation","No check in/auto release","User check out"]},"release_location":{"type":"string","description":"If released, how or where the meeting was released.","example":"Scheduling Display","enum":["Zoom Rooms","Zoom Rooms Controller","Scheduling Display","Open Rest API","Zoom Rooms Whiteboard","Scheduling Displays On ZR","Workspace Portal","Desk","Personal Room Rooms","Scan QR Code","Chatbot","Auto Action","AIC","Mobile Client","Zoom Client","Zoom Apps","Plugin","Visitor"]},"cons_times_no_check_in":{"type":"integer","description":"The number of consecutive times with no check-in for recurring meetings.","example":2},"room_email":{"type":"string","description":"The email address bound to the room.","example":"jchill@example.com"}}}}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n "},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:read:admin","room:read:admin","zoom_rooms:read:list_release_infos:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["workspace:read:admin","room:read:admin"],"x-granular-scopes":["zoom_rooms:read:list_release_infos:admin"]}}},"/workspaces/reservations":{"get":{"tags":["Workspaces"],"summary":"List workspace reservations by locations","description":"List workspace reservations by location.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read`,`workspace:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read:list_reservations:admin`,`workspace:read:list_reservations:master`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `HEAVY`","operationId":"Getworkspacereservationsinlocations","parameters":[{"name":"from","in":"query","description":"The start date and time of the query. \n\nThis date can be up to 90 days (approximately 3 months) in the past or 180 days (approximately 6 months) in the future.","required":true,"schema":{"type":"string","example":"2026-03-18T05:41:36Z"}},{"name":"to","in":"query","description":"The end date and time of the query. \n\nThis date can be up to 90 days (approximately 3 months) in the past or 180 days (approximately 6 months) in the future. \n\nIt must be greater than the `from` date and time. \n\nThe range formed by the `from` and `to` parameters cannot exceed 7 days.","required":true,"schema":{"type":"string","example":"2026-03-20T05:41:36Z"}},{"name":"location_ids","in":"query","description":"The location IDs for which to query workspace reservations.","required":true,"schema":{"maxItems":50,"type":"array","example":["49D7a0xPQvGQ2DCMZgSe7w"],"items":{"type":"string"}}},{"name":"page_size","in":"query","description":"The number of records returned within a single API call.","required":false,"schema":{"maximum":1000,"type":"integer","example":30}},{"name":"next_page_token","in":"query","description":"Use the next page token to paginate through large result sets. A next page token is returned whenever the set of available results exceeds the current page size. This token's expiration period is 15 minutes.","required":false,"schema":{"type":"string","example":"IAfJX3jsOLW7w3dokmFl84zOa0MAVGyMEB2"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` <br>\n Reservations returned.\n\n ","content":{"application/json":{"schema":{"type":"object","properties":{"from":{"type":"string","description":"The queried start date and time.","example":"2026-03-18T05:41:36Z"},"to":{"type":"string","description":"The queried end date and time.","example":"2026-03-20T05:41:36Z"},"reservations":{"maxItems":1000,"type":"array","description":"A list of reservations.","items":{"type":"object","properties":{"id":{"type":"string","description":"The reservation's ID.","example":"ebrg2b87a6uu9c678qhvsiahsc"},"start_time":{"type":"string","description":"The reservation's start time.","format":"date-time","example":"2021-03-18T05:41:36Z"},"end_time":{"type":"string","description":"The reservation's end time.","format":"date-time","example":"2021-03-18T05:41:36Z"},"timezone":{"type":"string","description":"The reservation's time zone.","example":"Asia/Shanghai"},"topic":{"type":"string","description":"The reservation's topic.","example":"My Personal Meeting Room"},"user_id":{"type":"string","description":"The Zoom user ID of the workspace reservation.","example":"KDcuGIm1QgePTO8WbOqwIQ"},"status":{"type":"string","description":"The workspace reservation's status.","example":"reserved","enum":["reserved","checked_in","checked_out"]},"location_id":{"type":"string","description":"The location ID where the workspace was added.","example":"49D7a0xPQvGQ2DCMZgSe7w"},"workspace_id":{"type":"string","description":"The workspace's ID.","example":"qMOLddnySIGGVycz8aX_JQ"}},"description":"Information about the reservation."}},"page_size":{"maximum":300,"type":"integer","description":"The number of records returned within a single API call.","example":30,"default":30},"next_page_token":{"type":"string","description":"The next page token used to paginate through large result sets. A next page token is returned whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes.","example":"At6eWnFZ1FB3arCXnRxqHLXKhbDW18yz2i2"}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `30059011` <br>\n Location ID does not exist. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:read","workspace:read:admin","workspace:read:list_reservations:admin","workspace:read:list_reservations:master"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["WorkspacesManagement:Read"],"x-macro-scopes":["workspace:read","workspace:read:admin"],"x-granular-scopes":["workspace:read:list_reservations:admin","workspace:read:list_reservations:master"]}}},"/workspaces/settings":{"patch":{"tags":["Workspaces"],"summary":"Update workspace settings","description":"Updates workspace settings.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:write`,`workspace:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:update:setting:admin`,`workspace:update:setting:master`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"updateWorkspaceSettings","requestBody":{"content":{"application/json":{"schema":{"maxItems":20,"type":"array","description":"Setting levels to change.","items":{"required":["setting_level","setting_level_id","settings"],"type":"object","properties":{"setting_level":{"type":"string","description":"The workspace's setting level.","example":"account","enum":["account","location","desk"]},"setting_level_id":{"type":"string","description":"The workspace's setting level ID.","example":"49D7a0xPQvGQ2DCMZgSe7w"},"settings":{"maxItems":20,"type":"array","description":"Settings to change.","items":{"required":["setting_type","setting_value"],"type":"object","properties":{"setting_type":{"type":"string","description":"The workspace's setting type.","example":"enable_auto_check_in","enum":["add_asset","remove_asset","reserve_for_visitors","restrict_reservation_in_person_only","time_zone","under_construction","display_occupancy_status","required_approve","enable_workspace_check_in_and_out","allow_pre_check_in_time","no_check_in_auto_release_time","enable_auto_release","enable_limit_duration","max_duration","reservation_scheduling_increment","capacity","workspace_permission"]},"setting_value":{"type":"string","description":"The workspace setting's value. Could be true, false, number, or ID.\n\n### `workspace_permission`\n\nWhen `setting_type` is `workspace_permission`, `setting_value` must be a **JSON-escaped string**.\n\nOriginal JSON parameters:\n\n| Field | Type | Required | Description |\n| --- | --- | --- | --- |\n| `allow_user_ids` | `string[]` | No* | User IDs allowed to access the target node. |\n| `allow_user_group_ids` | `string[]` | No* | User group IDs allowed to access the target node. |\n\n\\* At least one of `allow_user_ids` or `allow_user_group_ids` must be provided as a non-empty array.\n\n\nOriginal JSON example:\n\n```json\n{\n  \"allow_user_ids\": [\"user_id_1\", \"user_id_2\"],\n  \"allow_user_group_ids\": [\"group_id_1\"]\n}","example":"true"}}}}}}}}}},"responses":{"204":{"description":"**HTTP Status Code:** `204`   \n \n No Content."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:write","workspace:write:admin","workspace:update:setting:admin","workspace:update:setting:master"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["WorkspacesManagement:Edit"],"x-macro-scopes":["workspace:write","workspace:write:admin"],"x-granular-scopes":["workspace:update:setting:admin","workspace:update:setting:master"]}}},"/workspaces/settings/photos":{"post":{"tags":["Workspaces"],"summary":"Add a workspace photo","description":"Use this API to add a workspace photo.\n\n**Note:**\n* Please use `https://fileapi.zoom.us` instead of `https://api.zoom.us`, the full path is `https://fileapi.zoom.us/v2/workspaces/settings/photos`.\n* Supported file formats: \"PNG\", \"JPG\", \"JPEG\", \"GIF\".\n* The maximum size of file is 15MB.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:write:workspace:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`\n\n**Not supported in Gov cluster** ","operationId":"AddaWorkspacephoto","requestBody":{"content":{"multipart/form-data":{"schema":{"required":["file","workspace_id"],"type":"object","properties":{"file":{"type":"string","description":"Upload an image file. Must be less than 15MB and support \"PNG\", \"JPG\", \"JPEG\", \"GIF\" formats.","example":"The upload file"},"workspace_id":{"type":"string","description":"Workspace's ID","example":"49D7a0xPQvGQ2DCMZgSe7w"}}}}}},"responses":{"201":{"description":"**HTTP Status Code:** `201` **OK**  \n \nWorkspace photo added successfully.","content":{"application/json":{"schema":{"type":"object","properties":{"file_id":{"type":"string","description":"File ID of the workspace photo","example":"L38yKqXzT7SKinGI0jyFHA"}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n "},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:write:admin","workspace:write:workspace:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["WorkspacesManagement:Edit"],"x-macro-scopes":["workspace:write:admin"],"x-granular-scopes":["workspace:write:workspace:admin"]}},"delete":{"tags":["Workspaces"],"summary":"Delete workspace photos","description":"Deletes workspace photos.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:delete:photo:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`\n\n**Not supported in Gov cluster** ","operationId":"DeleteaWorkspacephoto","parameters":[{"name":"workspace_id","in":"query","description":"Workspace's ID.","required":true,"schema":{"type":"string","example":"49D7a0xPQvGQ2DCMZgSe7w"}},{"name":"file_ids","in":"query","description":"File IDs to be deleted. \nThe file ID is extracted from the last segment of each URL in the room_images array field returned by the \"List workspace additional information with time range\" API.","required":true,"schema":{"maxItems":6,"minItems":1,"type":"array","example":["L38yKqXzT7SKinGI0jyFHA","N5hXzkRWQwmcuOSFSAdi3F"],"items":{"type":"string"}}}],"responses":{"204":{"description":"Workspace photos deleted successfully."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n "},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:write:admin","workspace:delete:photo:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["WorkspacesManagement:Edit"],"x-macro-scopes":["workspace:write:admin"],"x-granular-scopes":["workspace:delete:photo:admin"]}}},"/workspaces/usage":{"get":{"tags":["Workspaces"],"summary":"Get a location's hot desk usage","description":"Creates a location's [hot desk](https://en.wikipedia.org/wiki/Hot_desking) usage information.  \n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read:admin`,`workspace:read`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read:usage`,`workspace:read:usage:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"getHotDeskUsage","parameters":[{"name":"location_id","in":"query","description":"The location's ID.","required":true,"schema":{"type":"string","example":"49D7a0xPQvGQ2DCMZgSe7w"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200`   \n \n Hot desk usage information returned.","content":{"application/json":{"schema":{"type":"object","properties":{"desk_usage":{"type":"object","properties":{"in_use":{"type":"integer","description":"The number of desks in use.","example":2},"not_in_use":{"type":"integer","description":"The number of desks not in use.","example":1}},"description":"Information about the workspace desk usage."},"room_usage":{"type":"object","properties":{"in_use":{"type":"integer","description":"The number of workspaces in use.","example":1},"not_in_use":{"type":"integer","description":"The number of workspaces not in use.","example":1}},"description":"Information about the workspace room usage."},"total_usage":{"type":"object","properties":{"in_use":{"type":"integer","description":"The total number in use.","example":1},"not_in_use":{"type":"integer","description":"The total number not in use.","example":1}},"description":"Information about the total workspace usage."}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `2` <br>\n * ZR core service is disabled. Try again later. \n* ZR core system error. Try again later. <br>\n**Error Code:** `200` <br>\n * Zoom Workspace Reservation subscription was not found. Try again after purchasing a Zoom Workspace Reservation subscription. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:read:admin","workspace:read","workspace:read:usage","workspace:read:usage:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["workspace:read:admin","workspace:read"],"x-granular-scopes":["workspace:read:usage","workspace:read:usage:admin"]}}},"/workspaces/users/{userId}/calendar/settings":{"get":{"tags":["Workspaces"],"summary":"Get  Workspace Calendar Free/Busy Event","description":"List workspace calendar free or busy event settings.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read:workspace:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"GetWorkspaceCalendarFree/BusyEvent","parameters":[{"name":"userId","in":"path","description":"The user ID of the user whose setting needs to be retrieved.","required":false,"schema":{"type":"string","example":"rZXNXVlVSTaSZDTJvLcBew"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200`    Workspace calendar settings returned.","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","properties":{"room_status":{"type":"string","example":"free"},"desk_status":{"type":"string","example":"free"}}}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `300510002` <br>\n User not found. <br>\n**Error Code:** `2` <br>\n * ZR core service is disabled. Try again later. * ZR core system error. Try again later. <br>\n**Error Code:** `200` <br>\n * Zoom Workspace Reservation subscription was not found. Try again after purchasing a Zoom Workspace Reservation subscription.<br><br> <br>\n"},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `30051014` <br>\n Missing User ID. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:read:admin","workspace:read:workspace:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["WorkspacesManagement:Read"],"x-macro-scopes":["workspace:read:admin"],"x-granular-scopes":["workspace:read:workspace:admin"]}},"post":{"tags":["Workspaces"],"summary":"Set Workspace Calendar Free/Busy Event","description":"Set calendar free or busy event.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:write:workspace:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"SetCalendarFree/BusyEvent","parameters":[{"name":"userId","in":"path","description":"The unique identifier for a user whose workspace calendar settings needs to be updated. ","required":false,"schema":{"type":"string","example":"akdjfarjejewjUfskd"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"room_status":{"type":"string","description":"This represents the users calendar status for room reservation. ","example":"free","enum":["free","busy"]},"desk_status":{"type":"string","description":"This represents the users calendar status for desk reservation. ","example":"busy","enum":["free","busy"]}}}}}},"responses":{"204":{"description":"**HTTP Status Code:** `204` **"},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `300510003` <br>\n Invalid input for field room_status. <br>\n**Error Code:** `300510002` <br>\n User Not Found. <br>\n**Error Code:** `2` <br>\n * ZR core service is disabled. Try again later. * ZR core system error. Try again later. <br>\n**Error Code:** `200` <br>\n Zoom Workspace Reservation subscription was not found. Try again after purchasing a Zoom Workspace Reservation subscription.<br><br> <br>\n**Error Code:** `300510004` <br>\n Invalid input for field desk_status. <br>\n"},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `30051014` <br>\n Missing User ID. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:write:admin","workspace:write:workspace:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["WorkspacesManagement:Edit"],"x-macro-scopes":["workspace:write:admin"],"x-granular-scopes":["workspace:write:workspace:admin"]}}},"/workspaces/users/{userId}/reservations":{"get":{"tags":["Workspaces"],"summary":"Get a user's workspace's reservations","description":"Retrieves a user's workspace's reservations. \n\n \n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read:list_reservations:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"userListReservations","parameters":[{"name":"userId","in":"path","description":"The user ID.","required":true,"schema":{"type":"string","example":"KDcuGIm1QgePTO8WbOqwIQ"}},{"name":"from","in":"query","description":"The start date of the query.","required":true,"schema":{"type":"string","format":"date-time","example":"2021-03-18T05:41:36Z"}},{"name":"to","in":"query","description":"The end date of the query. Can be up to 14 days.","required":true,"schema":{"type":"string","format":"date-time","example":"2021-03-18T05:41:36Z"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200`   \n \nReservations returned.","content":{"application/json":{"schema":{"type":"object","properties":{"reservations":{"maxItems":1000,"type":"array","description":"List of reservations.","items":{"type":"object","properties":{"end_time":{"type":"string","description":"End time of the reservation.","format":"date-time","example":"2021-03-18T05:41:36Z"},"id":{"type":"string","description":"The reservation's ID.","example":"ebrg2b87a6uu9c678qhvsiahsc"},"start_time":{"type":"string","description":"Start time of the reservation.","format":"date-time","example":"2021-03-18T05:41:36Z"},"timezone":{"type":"string","description":"Timezone of the reserved workspace.","example":"Asia/Shanghai"},"topic":{"type":"string","description":"The reservation's topic.","example":"My Personal Meeting Room"},"user_id":{"type":"string","description":"User who reserved the workspace.","example":"KDcuGIm1QgePTO8WbOqwIQ"},"status":{"type":"string","description":"Status of the workspace.","example":"reserved","enum":["reserved","checked_in","checked_out"]},"workspace_id":{"type":"string","description":"The workspace's ID.","example":"qMOLddnySIGGVycz8aX_JQ"},"location_id":{"type":"string","description":"The location's ID.","example":"49D7a0xPQvGQ2DCMZgSe7w"}},"description":"Information about the reservation."}}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n "},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:read:admin","workspace:read:list_reservations:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["WorkspacesManagement:Read"],"x-macro-scopes":["workspace:read:admin"],"x-granular-scopes":["workspace:read:list_reservations:admin"]}}},"/workspaces/{locationId}/background":{"delete":{"tags":["Workspaces"],"summary":"Delete Workspace floor map","description":"Use this API to delete a workspace floor map.  \n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:write:location`,`workspace:write:location:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`\n\n**Not supported in Gov cluster** ","operationId":"DeleteWorkspaceFloorMap","parameters":[{"name":"locationId","in":"path","description":"Location ID of the place where the Zoom Room was added.","required":true,"schema":{"type":"string","example":"ry6d7lrSR4qqxC11HQ30lc"}},{"name":"remove_child","in":"query","description":"Whether workspace shapes and wayfinding need to be removed, false by default.","required":false,"schema":{"type":"boolean","example":false}}],"responses":{"204":{"description":"**HTTP Status Code:** `204` **OK**  \n\nWorkspace floor map deleted successfully."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  1. Floor map check failed\n2. Floor map exceed the pixel limit \n\n **Error Code:** `30051005` <br>\n Illegal Access. <br>\n"},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  Location not found. \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:write:admin","workspace:write:location","workspace:write:location:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["WorkspacesManagement:Edit"],"x-macro-scopes":["workspace:write:admin"],"x-granular-scopes":["workspace:write:location","workspace:write:location:admin"]}}},"/workspaces/{workspaceId}":{"get":{"tags":["Workspaces"],"summary":"Get a workspace","description":"Creates workspace detail.  \n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read:list_workspaces`,`workspace:read:list_workspaces:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"getWorkspace","parameters":[{"name":"workspaceId","in":"path","description":"The workspace's ID.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200`   \n \n Workspace returned.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"The workspace's ID.","example":"qMOLddnySIGGVycz8aX_JQ"},"workspace_name":{"maxLength":64,"type":"string","description":"The workspace's name.","example":"My Room"},"workspace_display_name":{"maxLength":64,"type":"string","description":"The workspace's display name.","example":"My Room"},"workspace_type":{"type":"string","description":"The workspace's type: \n* `desk` \n* `room`","example":"desk","enum":["desk","room"]},"workspace_passcode":{"type":"string","description":"The workspace's passcode.","example":"123xyz"},"activation_code":{"type":"string","description":"The workspace's activation code.","example":"3009-7012-8956-5005"},"calendar_resource_id":{"type":"string","description":"The calendar resource's ID.","example":"rNQUpdDXySFGhVycz7aR-SR"},"location_id":{"type":"string","description":"Location ID of the place where the Zoom Room was added.","example":"49D7a0xPQvGQ2DCMZgSe7w"},"supportAssignment":{"type":"boolean","description":"Whether the workspace support assignment","example":false}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `2` <br>\n * ZR core service is disabled. Try again later. \n* ZR core system error. Try again later. <br>\n**Error Code:** `8204` <br>\n * Workspace not found. <br>\n"},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:read:admin","workspace:read:list_workspaces","workspace:read:list_workspaces:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["WorkspacesManagement:Read"],"x-macro-scopes":["workspace:read:admin"],"x-granular-scopes":["workspace:read:list_workspaces","workspace:read:list_workspaces:admin"]}},"delete":{"tags":["Workspaces"],"summary":"Delete a workspace","description":"Deletes workspace detail.  \n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:delete:workspace:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"deleteWorkspace","parameters":[{"name":"workspaceId","in":"path","description":"The workspace's ID.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}}],"responses":{"204":{"description":"**HTTP Status Code:** `204`   \n \n No Content."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `2` <br>\n * ZR core service is disabled. Try again later. \n* ZR core system error. Try again later. <br>\n**Error Code:** `8204` <br>\n * Workspace not found. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:write:admin","workspace:delete:workspace:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["workspace:write:admin"],"x-granular-scopes":["workspace:delete:workspace:admin"]}},"patch":{"tags":["Workspaces"],"summary":"Update a workspace","description":"Updates workspace detail.  \n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:update:workspace:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"updateWorkspace","parameters":[{"name":"workspaceId","in":"path","description":"The workspace's ID.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"workspace_name":{"maxLength":64,"type":"string","description":"The workspace's name.","example":"My Room"},"workspace_display_name":{"maxLength":64,"type":"string","description":"The workspace's display name.","example":"My Room"},"workspace_passcode":{"type":"string","description":"The workspace's passcode","example":"123xyz"},"calendar_resource_id":{"type":"string","description":"The calendar resource's ID.","example":"rNQUpdDXySFGhVycz7aR-SR"}}}}}},"responses":{"204":{"description":"**HTTP Status Code:** `204`   \n \n No Content."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `2` <br>\n * ZR core service is disabled. Try again later. \n* ZR core system error. Try again later. <br>\n**Error Code:** `8204` <br>\n * Workspace not found. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:write:admin","workspace:update:workspace:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["workspace:write:admin"],"x-granular-scopes":["workspace:update:workspace:admin"]}}},"/workspaces/{workspaceId}/assignment":{"get":{"tags":["Workspaces"],"summary":"Get a desk assignment","description":"Get a desk assignment.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read:admin`,`workspace:read`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read:assignment`,`workspace:read:assignment:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"Getadeskassignment","parameters":[{"name":"workspaceId","in":"path","description":"The workspace's ID.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}}],"responses":{"200":{"description":"Desk assignment returned.","content":{"application/json":{"schema":{"type":"object","properties":{"assign_type":{"type":"string","description":"Assign type:\n* permanent\n\nNote: More assign type support in future release.","example":"permanent","enum":["permanent"]},"permanent_assignment":{"type":"object","properties":{"account_id":{"type":"string","description":"The belong's account ID of assigned user.","example":"bhmIXpdYRcCK6BB3VhMq6w"},"user_id":{"type":"string","description":"The ID of assigned user.","example":"oyLyxW48QeC3uBBFY2CF3A"},"user_email":{"type":"string","description":"The email of assigned user.","example":"example@zoom.us"}},"description":"Permanent assignment information. Only use for `assign_type` = `permanent`"}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `300520006` <br>\n The workspace not support assignment. <br>\n**Error Code:** `300520007` <br>\n Unsupported assign type. <br>\n**Error Code:** `300520008` <br>\n Workspace assignment feature is turned off. <br>\n**Error Code:** `300520009` <br>\n Access restricted. <br>\n"},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `300520005` <br>\n Workspace not found. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:read:admin","workspace:read","workspace:read:assignment","workspace:read:assignment:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["WorkspacesManagement:Read"],"x-macro-scopes":["workspace:read:admin","workspace:read"],"x-granular-scopes":["workspace:read:assignment","workspace:read:assignment:admin"]}},"put":{"tags":["Workspaces"],"summary":"Set a desk assignment","description":"Set a desk assignment.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:write:assignment:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"setADeskAssignment","parameters":[{"name":"workspaceId","in":"path","description":"The workspace's ID.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}}],"requestBody":{"content":{"application/json":{"schema":{"required":["assign_type"],"type":"object","properties":{"assign_type":{"type":"string","description":"Assign type:\n* permanent\n\nNote: More assign type support in future release.","example":"permanent","enum":["permanent"]},"permanent_assignment":{"type":"object","properties":{"account_id":{"type":"string","example":"bhmIXpdYRcCK6BB3VhMq6w"},"user_id":{"type":"string","example":"oyLyxW48QeC3uBBFY2CF3A"}},"description":"Permanent assignment information. Only use for `assign_type` = `permanent`"}}}}}},"responses":{"204":{"description":"Desk assignment successfully."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `300520001` <br>\n Missing required input. <br>\n**Error Code:** `300520006` <br>\n The workspace not support assignment. <br>\n**Error Code:** `300520007` <br>\n Unsupported assign type. <br>\n**Error Code:** `300520008` <br>\n Workspace assignment feature is turned off. <br>\n**Error Code:** `300520009` <br>\n Access restricted. <br>\n"},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `300520005` <br>\n Workspace not found. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:write:admin","workspace:write:assignment:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["WorkspacesManagement:Edit"],"x-macro-scopes":["workspace:write:admin"],"x-granular-scopes":["workspace:write:assignment:admin"]}},"delete":{"tags":["Workspaces"],"summary":"Delete a desk assignment","description":"Deletes a desk assignment.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:delete:assignment:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"Deleteadeskassignment","parameters":[{"name":"workspaceId","in":"path","description":"The workspace's ID.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}}],"responses":{"204":{"description":"Desk assignment deleted successfully."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `300520006` <br>\n The workspace not support assignment. <br>\n**Error Code:** `300520007` <br>\n Unsupported assign type. <br>\n**Error Code:** `300520008` <br>\n Workspace assignment feature is turned off. <br>\n**Error Code:** `300520009` <br>\n Access restricted. <br>\n"},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `300520005` <br>\n Workspace not found. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:write:admin","workspace:delete:assignment:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["WorkspacesManagement:Edit"],"x-macro-scopes":["workspace:write:admin"],"x-granular-scopes":["workspace:delete:assignment:admin"]}}},"/workspaces/{workspaceId}/qr_code":{"get":{"tags":["Workspaces"],"summary":"Get a workspace QR code","description":"Use this API to get the workspace QR code. \n\n \n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read:qr:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"getWorkspaceQRCode","parameters":[{"name":"workspaceId","in":"path","description":"The workspace's ID.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}},{"name":"type","in":"query","description":"The type of URL of QR code that you would like to retrieve.\n\n`check_in`: Check-in QR code URL.\n\n`unified`: Unified QR code URL.","required":false,"schema":{"type":"string","example":"check_in","default":"check_in","enum":["check_in","unified"]}},{"name":"ttl","in":"query","description":"The expiry time of the URL in seconds.","required":false,"schema":{"type":"integer","example":3600,"default":2592000}}],"responses":{"200":{"description":"**HTTP Status Code:** `200`   \n \nQR code returned.","content":{"application/json":{"schema":{"type":"object","properties":{"qr_code":{"type":"string","description":"The URL to the workspace QR code.","format":"uri","example":"https://example.com/qr_code"},"expire_in":{"type":"integer","description":"The number of seconds the QR code is valid for before it expires.","format":"int64","example":10}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request \n\n **Error Code:** `200` <br>\n Zoom Workspace Reservation subscription was not found. Try again after purchasing a Zoom Workspace Reservation subscription.<br><br> <br>\n**Error Code:** `300` <br>\n Invalid TTL value for QR code URL.<br><br> <br>\n**Error Code:** `8205` <br>\n Workspace is not configured onto a map.<br><br> <br>\n**Error Code:** `8206` <br>\n Workspace does not support unified QR code.<br><br> <br>\n**Error Code:** `8207` <br>\n Workspace does not support checkin QR code.  <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found \n\n **Error Code:** `8204` <br>\n Workspace does not exist. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:read:admin","workspace:read:qr:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["WorkspacesManagement:Read"],"x-macro-scopes":["workspace:read:admin"],"x-granular-scopes":["workspace:read:qr:admin"]}}},"/workspaces/{workspaceId}/reservations":{"get":{"tags":["Workspaces"],"summary":"Get a workspace's reservations","description":"Retrieves a workspace's reservations. \n\n \n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read:admin`,`workspace:read`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read:list_reservations`,`workspace:read:list_reservations:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"listReservations","parameters":[{"name":"workspaceId","in":"path","description":"The workspace's ID.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}},{"name":"from","in":"query","description":"The start date of the query.","required":false,"schema":{"type":"string","format":"date-time","example":"2021-03-18T05:41:36Z"}},{"name":"to","in":"query","description":"The end date of the query. Can be up to 14 days in the future.","required":false,"schema":{"type":"string","format":"date-time","example":"2021-03-18T05:41:36Z"}},{"name":"user_id","in":"query","description":"The ID of the user for whom to create a workspace reservation.","required":false,"schema":{"type":"string","example":"KDcuGIm1QgePTO8WbOqwIQ"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200`   \n \nReservations returned.","content":{"application/json":{"schema":{"type":"object","properties":{"from":{"type":"string","description":"The queried start date and time.","format":"date-time","example":"2021-03-18T05:41:36Z"},"reservations":{"type":"array","description":"List of reservations.","items":{"type":"object","properties":{"end_time":{"type":"string","description":"The reservation's end time.","format":"date-time","example":"2021-03-18T05:41:36Z"},"id":{"type":"string","description":"The reservation's ID.","example":"ebrg2b87a6uu9c678qhvsiahsc"},"start_time":{"type":"string","description":"The reservation's start time.","format":"date-time","example":"2021-03-18T05:41:36Z"},"timezone":{"type":"string","description":"The reservation's timezone.","example":"Asia/Shanghai"},"topic":{"type":"string","description":"The reservation's topic.","example":"My Personal Meeting Room"},"user_id":{"type":"string","description":"Zoom user ID of the workspace reservation.","example":"KDcuGIm1QgePTO8WbOqwIQ"},"status":{"type":"string","description":"The workspace reservation's status.","example":"reserved","enum":["reserved","checked_in","checked_out"]}},"description":"Information about the reservation."}},"to":{"type":"string","description":"The queried end date and time.","format":"date-time","example":"2021-03-18T05:41:36Z"}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request \n\n **Error Code:** `2` <br>\n * ZR core service is disabled. Try again later. \n* ZR core system error. Try again later. <br>\n**Error Code:** `200` <br>\n * Zoom Workspace Reservation subscription was not found. Try again after purchasing a Zoom Workspace Reservation subscription. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found \n\n **Error Code:** `1001` <br>\n User does not exist: {userId} <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:read:admin","workspace:read","workspace:read:list_reservations","workspace:read:list_reservations:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["WorkspacesManagement:Read"],"x-macro-scopes":["workspace:read:admin","workspace:read"],"x-granular-scopes":["workspace:read:list_reservations","workspace:read:list_reservations:admin"]}},"post":{"tags":["Workspaces"],"summary":"Create a reservation","description":"Creates a workspace reservation.\n\nWhen creating a linked Zoom **meeting**, include the `meeting` object. To schedule a **new** meeting using the host's **Personal Meeting ID (PMI)**, set `meeting.use_pmi` to `true`. Do not set `use_pmi` when selecting an existing meeting via `meeting.meeting_uuid`. PMI may be restricted by account settings.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:write`,`workspace:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:write:reservation`,`workspace:write:reservation:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"createReservation","parameters":[{"name":"workspaceId","in":"path","description":"The workspace's ID.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}},{"name":"check_in","in":"query","description":"Check in this reservation after successful creation.","required":false,"schema":{"type":"boolean","example":false,"default":false}}],"requestBody":{"content":{"application/json":{"schema":{"oneOf":[{"required":["end_time","start_time","topic"],"type":"object","properties":{"topic":{"type":"string","description":"The reservation's topic.","example":"My Personal Meeting Room"},"meeting":{"type":"object","properties":{"end_to_end_encrypted":{"type":"boolean","description":"Whether to enable end-to-end encryption (E2EE). When enabled, the encryption key is stored on the local device and cannot be obtained by anyone else. Enabling E2EE also [disables certain features](https://support.zoom.us/hc/en-us/articles/360048660871), such as cloud recording, live streaming, and allowing participants to join before the host.","example":true},"password":{"maxLength":10,"type":"string","description":"The meeting's passcode, up to a maximum of 10 characters. This value can only contain the following characters: \n\n `a`-`z` `A`-`Z` `0`-`9` `@` `-` `_` `*` \n\n **Note:** If the account owner or administrator has configured a [minimum passcode requirement setting](https://support.zoom.us/hc/en-us/articles/360033559832-Meeting-and-webinar-passwords#h_a427384b-e383-4f80-864d-794bf0a37604), this value must meet those requirements. You can view password requirements by calling the [**Get user settings**](/docs/api-reference/zoom-api/methods#operation/userSettings) API or the [**Get account settings**](/docs/api-reference/zoom-api/ma#operation/accountSettings) API.","example":"9832583261"},"waiting_room":{"type":"boolean","description":"Whether participants are placed in the [**Waiting Room**](https://support.zoom.us/hc/en-us/articles/115000332726-Waiting-Room) when they join a meeting.","example":true},"use_pmi":{"type":"boolean","description":"Whether to schedule the **new** linked Zoom meeting using the host user's **Personal Meeting ID (PMI)**. Omit this field or set it to `false` to create a standard scheduled meeting with a generated meeting ID. Do not set to `true` when `meeting_uuid` is present (existing meeting). Do not use with recurring reservations.","example":false,"default":false},"meeting_uuid":{"type":"string","description":"The unique meeting identifier for an **existing** meeting to attach to this reservation. Double-encode the UUID when using it for API calls if the UUID begins with a `/` or contains `//` in it. Do not use together with `use_pmi` set to `true`.","example":"aDYlohsHRtCd4ii1uC2+hA=="}},"description":"The reservation's meeting settings. You must provide this information if the requested workspace's `type` is the `room` value."},"reserve_for":{"type":"string","description":"The ID of the user for whom to create a workspace reservation.","example":"KDcuGIm1QgePTO8WbOqwIQ"},"start_time":{"type":"string","description":"The reservation's start time.","format":"date-time","example":"2021-03-18T05:41:36Z"},"end_time":{"type":"string","description":"The reservation's end time.","format":"date-time","example":"2021-03-18T05:41:36Z"}}},{"required":["end_time_local","start_time_local","topic"],"type":"object","properties":{"topic":{"type":"string","description":"The reservation's topic.","example":"My Personal Meeting Room"},"meeting":{"type":"object","properties":{"end_to_end_encrypted":{"type":"boolean","description":"Whether to enable end-to-end encryption (E2EE). When enabled, the encryption key is stored on the local device and cannot be obtained by anyone else. Enabling E2EE also [disables certain features](https://support.zoom.us/hc/en-us/articles/360048660871), such as cloud recording, live streaming, and allowing participants to join before the host.","example":true},"password":{"maxLength":10,"type":"string","description":"The meeting's passcode, up to a maximum of 10 characters. This value can only contain the following characters: \n\n `a`-`z` `A`-`Z` `0`-`9` `@` `-` `_` `*` \n\n **Note:** If the account owner or administrator has configured a [minimum passcode requirement setting](https://support.zoom.us/hc/en-us/articles/360033559832-Meeting-and-webinar-passwords#h_a427384b-e383-4f80-864d-794bf0a37604), this value must meet those requirements. You can view password requirements by calling the [**Get user settings**](/docs/api-reference/zoom-api/methods#operation/userSettings) API or the [**Get account settings**](/docs/api-reference/zoom-api/ma#operation/accountSettings) API.","example":"9832583261"},"waiting_room":{"type":"boolean","description":"Whether participants are placed in the [**Waiting Room**](https://support.zoom.us/hc/en-us/articles/115000332726-Waiting-Room) when they join a meeting.","example":true},"use_pmi":{"type":"boolean","description":"Whether to schedule the **new** linked Zoom meeting using the host user's **Personal Meeting ID (PMI)**. Omit this field or set it to `false` to create a standard scheduled meeting with a generated meeting ID. Do not set to `true` when `meeting_uuid` is present (existing meeting). Do not use with recurring reservations.","example":false,"default":false},"meeting_uuid":{"type":"string","description":"The unique meeting identifier for an **existing** meeting to attach to this reservation. Double-encode the UUID when using it for API calls if the UUID begins with a `/` or contains `//` in it. Do not use together with `use_pmi` set to `true`.","example":"aDYlohsHRtCd4ii1uC2+hA=="}},"description":"The reservation's meeting settings. You must provide this information if the requested workspace's `type` is the `room` value."},"reserve_for":{"type":"string","description":"The ID of the user for whom to create a workspace reservation.","example":"KDcuGIm1QgePTO8WbOqwIQ"},"start_time_local":{"type":"string","description":"The reservation's start time. The time zone will be your workspace time zone.","format":"date-time"},"end_time_local":{"type":"string","description":"The reservation's end time. The time zone will be your workspace time zone.","format":"date-time"}}}]}}}},"responses":{"201":{"description":"**HTTP Status Code:** `201` <br>\n Reservation created.\n\n ","content":{"application/json":{"schema":{"type":"object","properties":{"reservation_id ":{"type":"string","description":"The reservation's ID.","example":"ebrg2b87a6uu9c678qhvsiahsc"},"status":{"type":"string","description":"The workspace reservation's status.","example":"checked_in","enum":["reserved","checked_in","checked_out"]}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `2` <br>\n * ZR core service is disabled. Try again later. \n* ZR core system error. Try again later. <br>\n**Error Code:** `300` <br>\n Invalid date and time range. <br>\n**Error Code:** `8201` <br>\n Failed to reserve workspace. <br>\n**Error Code:** `200` <br>\n * Zoom Workspace Reservation subscription was not found. Try again after purchasing a Zoom Workspace Reservation subscription. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `1001` <br>\n * User does not exist: {userId}. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:write","workspace:write:admin","workspace:write:reservation","workspace:write:reservation:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["WorkspacesManagement:Edit"],"x-macro-scopes":["workspace:write","workspace:write:admin"],"x-granular-scopes":["workspace:write:reservation","workspace:write:reservation:admin"]}}},"/workspaces/{workspaceId}/reservations/{reservationId}":{"get":{"tags":["Workspaces"],"summary":"Get a workspace reservation by reservationId","description":"Retrieves a workspace reservation ID.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read`,`workspace:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read:reservation`,`workspace:read:reservation:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"GETGetaworkspacereservationbyreservationID","parameters":[{"name":"workspaceId","in":"path","description":"Workspace ID.","required":true,"schema":{"type":"string","example":"12344"}},{"name":"reservationId","in":"path","description":"Reservation ID.","required":true,"schema":{"type":"string","example":"1223443"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200`    Reservations returned.","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object","properties":{"topic":{"type":"string","description":"Topic of the reservation.","example":"Yuki-devintt{{8*8}}'s Reservation"},"timezone":{"type":"string","description":"Timezone of the reserved workspace.","example":"UTC"},"id":{"type":"string","description":"The Reservation's ID","example":"dh1fjff72ffe7v139kn3hlfvl0"},"user_id":{"type":"string","description":"User who reserved the workspace.","example":"rZXNXVlVSTaSZDTJvLcBew"},"start_time":{"type":"string","description":"Start time of the reservation.","example":"2023-10-16T19:30:00Z"},"end_time":{"type":"string","description":"End time of the reservation.","example":"2023-10-17T00:00:00Z"},"status":{"type":"string","description":"Status of the workspace.","example":"reserved","enum":["reserved","checked_in","checked_out"]}},"description":"Data returned. "}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `2` <br>\n * ZR core service is disabled. Try again later. * ZR core system error. Try again later. <br>\n**Error Code:** `200` <br>\n * Zoom Workspace Reservation subscription was not found. Try again after purchasing a Zoom Workspace Reservation subscription. <br>\n**Error Code:** `30093007` <br>\n Calendar event does not exist. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `1001` <br>\n User does not exist: {userId} <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:read","workspace:read:admin","workspace:read:reservation","workspace:read:reservation:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["WorkspacesManagement:Read"],"x-macro-scopes":["workspace:read","workspace:read:admin"],"x-granular-scopes":["workspace:read:reservation","workspace:read:reservation:admin"]}},"delete":{"tags":["Workspaces"],"summary":"Delete a reservation","description":"Deletes a reservation.  \n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:write`,`workspace:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:delete:reservation`,`workspace:delete:reservation:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"deleteReservation","parameters":[{"name":"workspaceId","in":"path","description":"The workspace's ID.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}},{"name":"reservationId","in":"path","description":"The reservation's ID.","required":true,"schema":{"type":"string","example":"ebrg2b87a6uu9c678qhvsiahsc"}}],"responses":{"202":{"description":"**HTTP Status Code:** `202`   \n \n Accepted."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `2` <br>\n * ZR core service is disabled. Try again later. \n* ZR core system error. Try again later. <br>\n**Error Code:** `200` <br>\n * Zoom Workspace Reservation subscription was not found. Try again after purchasing a Zoom Workspace Reservation subscription. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `8202` <br>\n * Workspace Reservation does not exist. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:write","workspace:write:admin","workspace:delete:reservation","workspace:delete:reservation:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["workspace:write","workspace:write:admin"],"x-granular-scopes":["workspace:delete:reservation","workspace:delete:reservation:admin"]}},"patch":{"tags":["Workspaces"],"summary":"Update a reservation","description":"Updates a reservation. This API supports maintaining workspace reservation event of the next `6` months. The `start_time` and `end_time` time range of a single workspace reservation event can be a minimum of `15` minutes and a maximum of `24` hours.  \n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:write`,`workspace:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:update:reservation`,`workspace:update:reservation:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"updateReservation","parameters":[{"name":"workspaceId","in":"path","description":"The workspace's ID.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}},{"name":"reservationId","in":"path","description":"The reservation's ID.","required":true,"schema":{"type":"string","example":"ebrg2b87a6uu9c678qhvsiahsc"}}],"requestBody":{"content":{"application/json":{"schema":{"required":["end_time","start_time","topic"],"type":"object","properties":{"end_time":{"type":"string","description":"The reservation's end time.","format":"date-time","example":"2021-03-18T05:41:36Z"},"start_time":{"type":"string","description":"The reservation's start time.","format":"date-time","example":"2021-03-18T05:41:36Z"},"topic":{"type":"string","description":"The reservation's topic.","example":"My Personal Meeting Room"}}}}}},"responses":{"202":{"description":"**HTTP Status Code:** `202`   \n \n Accepted."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `2` <br>\n * ZR core service is disabled. Try again later. \n* ZR core system error. Try again later. <br>\n**Error Code:** `300` <br>\n Invalid date and time range. <br>\n**Error Code:** `200` <br>\n * Zoom Workspace Reservation subscription was not found. Try again after purchasing a Zoom Workspace Reservation subscription. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `8202` <br>\n * Workspace Reservation does not exist. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:write","workspace:write:admin","workspace:update:reservation","workspace:update:reservation:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["workspace:write","workspace:write:admin"],"x-granular-scopes":["workspace:update:reservation","workspace:update:reservation:admin"]}}},"/workspaces/{workspaceId}/reservations/{reservationId}/questionnaires":{"get":{"tags":["Workspaces"],"summary":"List workspace reservation questionnaires","description":"List workspace reservation questionnaires.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `workspace:read:reservation:admin`,`workspace:read:reservation:master`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"Listworkspacereservationquestionnaires","parameters":[{"name":"workspaceId","in":"path","description":" The workspace's ID.","required":true,"schema":{"type":"string","example":"qMdnyGGVycz8aX_JQ"}},{"name":"reservationId","in":"path","description":" The reservation's ID.","required":true,"schema":{"type":"string","example":"ebrg2b87a6uu9c678qhvsiahsc"}},{"name":"subject","in":"query","description":"The questionnaire's subject.","required":true,"schema":{"type":"string","example":"reservation","enum":["reservation","pre_checkin"]}}],"responses":{"200":{"description":"**HTTP Status Code:** `200`    Questionnaires returned.","content":{"application/json":{"schema":{"required":["fill_time","questionnaire_response","reservation_id","user_display_name","workspace_id","workspace_name"],"type":"object","properties":{"reservation_id":{"type":"string","description":"The reservation's ID.","example":"dxpwbc2fi8tzz7d012rwx9u8c0"},"user_display_name":{"type":"string","description":"The user's display name.","example":"Admin Example"},"workspace_id":{"type":"string","description":"The workspace's ID.","example":"SJjU1CcGSs2L7odn6PanQw"},"workspace_name":{"type":"string","description":"The workspace's name.","example":"Reserve Desk-01"},"fill_time":{"type":"string","description":"The time that fill questionnaires ID.","example":"1707848572310"},"questionnaire_response":{"maxItems":20,"type":"array","description":"The questionnaires' responses","items":{"required":["id","list","subject","title"],"type":"object","properties":{"id":{"type":"string","description":"The questionnaire's ID.","example":"Fl75C43YTmS_IpMzYLipJw"},"title":{"type":"string","description":"The questionnaire's title.","example":"Reservation Questionnaire"},"subject":{"type":"string","description":"The questionnaire's subject.","example":"reservation"},"list":{"maxItems":50,"type":"array","description":"Question list","items":{"required":["question_id","reply","required","title","type"],"type":"object","properties":{"question_id":{"type":"string","description":"The question's ID.","example":"0ds1NFeDQ1WfWlgVK-7OMQ"},"title":{"type":"string","description":"The question's title.","example":"question single example"},"type":{"type":"string","description":"The question's type.","example":"single","enum":["single","multiple","short","long"]},"required":{"type":"boolean","description":"Is this question required to answer.","example":false},"options":{"maxItems":10,"type":"array","description":"The question's options.","items":{"type":"object","properties":{"option_id":{"type":"string","description":"The question's option ID.","example":"UClQqM1qT_q-bZQ0Xti7Vw"},"text":{"type":"string","description":"The question's option text.","example":"Yes"}}}},"reply":{"type":"string","description":"The reply content or option ids.","example":"UClQqM1qT_q-bZQ0Xti7Vw"}}}}}}}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `300520011` <br>\n Subject value not support. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `300520005` <br>\n Workspace not found. <br>\n**Error Code:** `300520010` <br>\n Reservation not found. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["workspace:read:admin","workspace:read:reservation:admin","workspace:read:reservation:master"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["WorkspacesManagement:Read"],"x-macro-scopes":["workspace:read:admin"],"x-granular-scopes":["workspace:read:reservation:admin","workspace:read:reservation:master"]}}},"/rooms":{"get":{"tags":["Zoom Rooms"],"summary":"List Zoom Rooms","description":"Zoom Rooms is a software-based room system that provides an integrated experience for audio conferencing, wireless screen sharing and video conferencing. Use this API to list all the existing [Zoom Rooms](https://support.zoom.us/hc/en-us/articles/207483343-Getting-Started-with-Zoom-Rooms) in a Zoom account.  \n   \n \n**Prerequisites:**  \n \n* Pro or a higher plan with [Zoom Room](https://zoom.us/zoomrooms) license.  \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:read:list_rooms:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"listZoomRooms","parameters":[{"name":"status","in":"query","description":"The status of the Zoom Room.","required":false,"schema":{"type":"string","example":"Offline","enum":["Offline","Available","InMeeting","UnderConstruction"]}},{"name":"tag_ids","in":"query","description":"The room tag IDs associated with the Zoom Room. Use commas (,) to separate between them. It's 'OR' logic if query for multiple tags.","required":false,"schema":{"type":"string","example":"90bdda6c226f4f10a4b9a34be8d69f30,12345a6c226f4f10a4b9a34be8d69f30"}},{"name":"type","in":"query","description":"The type of Zoom Rooms .","required":false,"schema":{"type":"string","example":"ZoomRoom","enum":["Kiosk","ZoomRoom","StandaloneWhiteboard","SchedulingDisplayOnly","DigitalSignageOnly","PersonalZoomRoom"]}},{"name":"unassigned_rooms","in":"query","description":"Use this query parameter with a value of `true` if you would like to see Zoom Rooms in your account that have not been assigned to anyone yet.","required":false,"schema":{"type":"boolean","example":true,"default":false}},{"name":"page_size","in":"query","description":"The number of records returned within a single API call.","required":false,"schema":{"maximum":300,"type":"integer","example":30,"default":30}},{"name":"next_page_token","in":"query","description":"Use the next page token to paginate through large result sets. A next page token is returned whenever the set of available results exceeds the current page size. This token's expiration period is 15 minutes.","required":false,"schema":{"type":"string","example":"IAfJX3jsOLW7w3dokmFl84zOa0MAVGyMEB2"}},{"name":"location_id","in":"query","description":"The parent location ID of the Zoom Room.","required":false,"schema":{"type":"string","example":"49D7a0xPQvGQ2DCMZgSe7w"}},{"name":"query_name","in":"query","description":"The name of a Zoom Room. If you do not call this parameter, the API will return all of the account's Zoom Rooms.","required":false,"schema":{"type":"string","example":"My Zoom Room name"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` **OK**  \n \nA list of Zoom Rooms returned successfully.","content":{"application/json":{"schema":{"type":"object","properties":{"next_page_token":{"type":"string","description":"The next page token is used to paginate through large result sets. A next page token will be returned whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes.","example":"At6eWnFZ1FB3arCXnRxqHLXKhbDW18yz2i2"},"page_size":{"type":"integer","description":"The number of records returned within a single API call.","example":20},"rooms":{"type":"array","description":"List of existing Zoom Rooms.","items":{"type":"object","properties":{"activation_code":{"type":"string","description":"The code used to complete the setup of the Zoom Room.","example":"1315-2376-2198-7926"},"id":{"type":"string","description":"The Zoom Room ID.","example":"qMOLddnySIGGVycz8aX_JQ"},"location_id":{"type":"string","description":"Unique Identifier of the [location](/docs/api-reference/zoom-api/methods#operation/listZRLocations) of the room.","example":"49D7a0xPQvGQ2DCMZgSe7w"},"name":{"type":"string","description":"Name of the Zoom Room.","example":"My Personal Meeting Room"},"room_id":{"type":"string","description":"The Zoom Room ID. Use this ID for the **Dashboard Zoom Room APIs**.","example":"qMOLddnySIGGVycz8aX_JQ"},"status":{"type":"string","description":"Status of the Zoom Room.","example":"Offline","enum":["Offline","Available","InMeeting","UnderConstruction"]},"tag_ids":{"type":"array","description":"The list of room tag ID associated with the Zoom Room.","items":{"type":"string","description":"The room tag ID associated with the Zoom Room.","example":"90bdda6c226f4f10a4b9a34be8d69f30"}}}}}}}}}},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:read:admin","zoom_rooms:read:list_rooms:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["ZoomRooms:Read"],"x-macro-scopes":["room:read:admin"],"x-granular-scopes":["zoom_rooms:read:list_rooms:admin"]}},"post":{"tags":["Zoom Rooms"],"summary":"Add a Zoom Room","description":"Use this API to [add a Zoom Room](https://support.zoom.us/hc/en-us/articles/202822279-Add-Zoom-Rooms-on-Web-Portal) to a Zoom account.  \n   \n \n**Prerequisites:**  \n \n* Pro or a higher plan with [Zoom Room](https://zoom.us/zoomrooms) license.  \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:write:room:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"addARoom","requestBody":{"content":{"application/json":{"schema":{"required":["name","type"],"type":"object","properties":{"location_id":{"type":"string","description":"**Optional**  \n Location ID of the lowest level location in the [location hierarchy](https://support.zoom.us/hc/en-us/articles/115000342983-Zoom-Rooms-Location-Hierarchy) where the Zoom Room is to be added. For instance if the structure of the location hierarchy is set up as &ldquo;country, states, city, campus, building, floor&rdquo;, a room can only be added under the floor level location. \n\nThis ID can be retrieved from the [**List Zoom Room locations**](/docs/api-reference/zoom-api/methods#operation/listZRLocations) API.","example":"49D7a0xPQvGQ2DCMZgSe7w"},"name":{"type":"string","description":"Name of the Zoom Room.","example":"My Personal Meeting Room"},"type":{"type":"string","description":"Type of the Zoom Room. ","example":"ZoomRoom","enum":["Kiosk","ZoomRoom","StandaloneWhiteboard","SchedulingDisplayOnly","DigitalSignageOnly","PersonalZoomRoom"]},"calendar_resource_id":{"type":"string","description":"The calendar resource's ID.","example":"u7GQ3q_zQbqJnNp02-oMjQ"},"tag_ids":{"type":"array","description":"The tag IDs that will be associated with the Zoom Room.","example":["90bdda6c226f4f10a4b9a34be8d69f30","1234ds6c226f4f10a4b9a34be8d69f30"],"items":{"type":"string","description":"Unique UUID that identifies the room tag.","example":"90bdda6c226f4f10a4b9a34be8d69f30"}},"user_id":{"type":"string","description":"The user ID of the user assigned to a Personal Zoom Room.  Note: this field will only be accepted when the zoom_room_type is PersonalZoomRoom.","example":"Ih3wZpAjTlitZcAhuYRbxg"},"pro_device":{"type":"boolean","description":"If enabled, the Personal Zoom Room will consume a Zoom Rooms license and have access to \"Pro\" features.  Note: this field will only be present for Personal Zoom Rooms.","example":true}}}}}},"responses":{"201":{"description":"**HTTP Status Code:** `201` **Created**  \n \nZoom Room added successfully.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"The Zoom Room ID.","example":"qMOLddnySIGGVycz8aX_JQ"},"location_id":{"type":"string","description":"Location ID of the location where the Zoom Room was added.","example":"49D7a0xPQvGQ2DCMZgSe7w"},"name":{"type":"string","description":"Name of the Zoom Room.","example":"My Personal Meeting Room"},"room_id":{"type":"string","description":"The Zoom Room ID. Use this ID for the **Dashboard Zoom Room APIs**.","example":"qMOLddnySIGGVycz8aX_JQ"},"tags":{"type":"array","description":"The room tags associated with this Zoom Room.","items":{"type":"object","properties":{"tag_name":{"type":"string","description":"The tag name associated with this Zoom Room.","example":"private room"},"tag_id":{"type":"string","description":"The room tag ID associated with the Zoom Room.","example":"90bdda6c226f4f10a4b9a34be8d69f30"}},"description":"room tag name"}},"type":{"type":"string","description":"Type of the Zoom Room.","example":"ZoomRoom","enum":["Kiosk","ZoomRoom","StandaloneWhiteboard","SchedulingDisplayOnly","DigitalSignageOnly","PersonalZoomRoom"]},"calendar_resource_id":{"type":"string","description":"The calendar resource's ID.","example":"u7GQ3q_zQbqJnNp02-oMjQ"},"user_id":{"type":"string","description":"The user ID of the user assigned to a Personal Zoom Room.  Note: this field will only be accepted when the zoom_room_type is PersonalZoomRoom.","example":"Ih3wZpAjTlitZcAhuYRbxg"},"pro_device":{"type":"boolean","description":"If enabled, the Personal Zoom Room will consume a Zoom Rooms license and have access to \"Pro\" features.  Note: this field will only be present for Personal Zoom Rooms.","example":true}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `200` <br>\n Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription.<br>\nAt least one normal Zoom Rooms required.<br><br> <br>\n**Error Code:** `300` <br>\n Invalid parent location ID: {location_id}.<br> <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `4801` <br>\n Location not found: {location_id}.<br><br>. <br>\n**Error Code:** `4060` <br>\n Calendar resource does not exist: {resourceId}.<br><br> <br>\n**Error Code:** `8306` <br>\n Tag ID does not exist: [{tagId1}, {tagId2}]. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:write:room:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["ZoomRooms:Edit"],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:write:room:admin"]}}},"/rooms/digital_signage":{"get":{"tags":["Zoom Rooms"],"summary":"List digital signage contents","description":"Use this API to return information about a Zoom account's [Zoom Rooms digital signage content](https://support.zoom.us/hc/en-us/articles/360000030683-Zoom-Rooms-digital-signage). You can also view this content in the **Room Management** section's [**Digital Signage Content**](https://zoom.us/digitalsignage#/) tab in the Zoom web portal. \n\n**Prerequisites:** \n* A Pro or a higher account with Zoom Rooms. \n* Existing content in the **Digital Signage Content** tab.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:read:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `Medium`","operationId":"listDigitalSignageContent","parameters":[{"name":"type","in":"query","description":"Specify the type of digital signage resource. The value can be one of the following:\n* `content`: Returns information about content files.\n* `folder`: Returns information about the folder where the content files are located.","required":false,"schema":{"type":"string","example":"content"}},{"name":"folder_id","in":"query","description":"Unique identifier of the folder where the content is located. Provide this field if you would like to filter the response by contents that are only available in a specific folder.","required":false,"schema":{"type":"string","example":"LHMmOOYaRiOA5m5WZjXVPA"}},{"name":"page_size","in":"query","description":"The number of records returned within a single API call.","required":false,"schema":{"maximum":300,"type":"integer","example":30,"default":30}},{"name":"next_page_token","in":"query","description":"Use the next page token to paginate through large result sets. A next page token is returned whenever the set of available results exceeds the current page size. This token's expiration period is 15 minutes.","required":false,"schema":{"type":"string","example":"IAfJX3jsOLW7w3dokmFl84zOa0MAVGyMEB2"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` **OK**  \n \nList returned.","content":{"application/json":{"schema":{"type":"object","properties":{"contents":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier of the content or the folder. ","example":"LHMmOOYaRiOA5m5WZjXVPA"},"name":{"type":"string","description":"Name of the content file or the folder.","example":"content name"}}}},"next_page_token":{"type":"string","description":"The next page token is used to paginate through large result sets. A next page token will be returned whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes.","example":"At6eWnFZ1FB3arCXnRxqHLXKhbDW18yz2i2"},"page_size":{"type":"integer","description":"The number of records returned within a single API call.","example":20}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request\n\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:read:admin"],"openapi_authorization":[]}],"x-extensions":{"x-macro-scopes":["room:read:admin"]}}},"/rooms/events":{"patch":{"tags":["Zoom Rooms"],"summary":"Update E911 digital signage","description":"Display or hide E911 emergency alert text content from [Zoom Rooms digital signage](https://support.zoom.us/hc/en-us/articles/360000030683-Zoom-Rooms-digital-signage).\n\n**Prerequisites:**  \n \n* [Zoom Rooms](https://zoom.us/zoomrooms/software) 5.3.0 or higher\n* Zoom Rooms digital signage must be [enabled](https://support.zoom.us/hc/en-us/articles/360000030683-Zoom-Rooms-Digital-Signage#h_767fbb33-82a8-45a8-8392-a1bfa9687edd)\n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:update:room_controls:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"manageE911signage","requestBody":{"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"method":{"type":"string","description":"To display the emergency content on the Zoom Rooms digital signage display, set the value of this field to be `zoomroom.emergency_alert_displayed`.","example":"zoomroom.emergency_alert_displayed","enum":["zoomroom.emergency_alert_displayed"]},"params":{"type":"object","properties":{"content":{"type":"string","description":"Provide the content to be displayed. ","example":"diaplay content"},"target_ids":{"maxItems":10,"minItems":1,"type":"array","description":"Provide one of the following IDs associated with the Zoom Room.  \n \n\n* `accountId`: Account ID of the Zoom account.  \n  Provide account ID as the value of this field to display the alert content on all Zoom Rooms' displays in the account.  \n   \n \n* `locationId`: Location ID. Get the value of this field by calling the [**List Zoom Rooms locations**](/docs/api-reference/zoom-api/methods#operation/listZRLocations) API. \n Provide location ID as the value of this field to display the alert content on all Zoom Rooms' displays listed in the specified location.  \n   \n \n* `roomId`: the Zoom Room ID. Get the value of this field by calling the [**List Zoom Rooms**](/docs/api-reference/zoom-api/methods#operation/listZoomRooms) API. Provide room ID as the value of this field to display the alert content on a specific Zoom Rooms' display.","items":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}},"target_type":{"type":"string","description":"Provide one of the following values for this field that is associated to the value you entered in the `target_ids` field.   \n \n* `account`\n* `location`\n* `room`","example":"account","enum":["account","location","room"]}}}},"description":"Provide this request body to set and display the emergency alert content. "},{"type":"object","properties":{"method":{"type":"string","description":"To remove the emergency content from the Zoom Rooms digital signage display, set the value of this field to be `zoomroom.emergency_alert_removed`.","example":"zoomroom.emergency_alert_removed","enum":["zoomroom.emergency_alert_removed"]},"params":{"type":"object","properties":{"event_id":{"type":"string","description":"Unique identifier of the event. ","example":"qjou65kp9q2q6vdg73jqk540hg"},"target_ids":{"maxItems":10,"minItems":1,"type":"array","description":"Provide one of the following IDs associated with the Zoom Room.  \n \n\n* `accountId`: Account ID of the Zoom account.  \n  Provide account ID as the value of this field to remove the alert content from all Zoom Rooms' displays in the account.  \n   \n \n* `locationId`: Location ID. Get the value of this field by calling the [**List Zoom Rooms locations**](/docs/api-reference/zoom-api/methods#operation/listZRLocations) API. \n Provide location ID as the value of this field to remove the alert content from all Zoom Rooms' displays listed in the specified location.  \n   \n \n* `roomId`: the Zoom Room ID. Get the value of this field by calling the [**List Zoom Rooms**](/docs/api-reference/zoom-api/methods#operation/listZoomRooms) API. Provide room ID as the value of this field to remove the alert content from a specific Zoom Rooms' display.","items":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}},"target_type":{"type":"string","description":"Provide one of the following values for this field that is associated to the value you entered in the `target_ids` field.   \n \n* `account`\n* `location`\n* `room`","example":"account","enum":["account","location","room"]},"force_remove":{"type":"boolean","description":"If set to true, the Zoom Room, Location or Account will remove the current emergency alert message, even if the corresponding event_id is not supplied.","example":false}}}},"description":"Provide this request body to remove the emergency alert content. Note that there won't be a response body for this request."}]}}}},"responses":{"202":{"description":"**HTTP Status Code:** `202`  **Accepted**  \n \nList processed successfully."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `300` <br>\n Event id is required.<br>\nInvalid value submitted for Target Ids. Provide a valid Target Id associated with the Target type. <br>\n"},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  \n\n **Error Code:** `200` <br>\n Access restricted. <br><br> <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:update:room_controls:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:update:room_controls:admin"]}}},"/rooms/{id}/events":{"patch":{"tags":["Zoom Rooms"],"summary":"Use Zoom Room controls","description":"Controls [Zoom Rooms](https://support.zoom.us/hc/en-us/articles/207483343), including: \n* Room check-in and check-out.\n* Video and audio mute on and off.\n* Incoming meeting request accept or decline.\n* Meeting join, leave, or end.\n* Room restart.\n* Cancellation.\n* Switch between available cameras, speakers or microphones during a meeting.\n* Start or stop screen sharing.\n* Perform speaker volume changes during a meeting.\n\n\n\n**Prerequisites:**\n* [Zoom Rooms](https://support.zoom.us/hc/en-us/articles/207483343-Getting-started-with-Zoom-Rooms#:~:text=Zoom%20Rooms%20is%20a%20software,or%20from%20their%20mobile%20device) must have been set up for use for the account and must be online. \n* You must have access to the Calendar Integration APIs (either Microsoft Exchange or Google Calendar APIs) to get calendar information associated with the room.\n\n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:update:room_control:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"ZoomRoomsControls","parameters":[{"name":"id","in":"path","description":"The room ID.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}}],"requestBody":{"content":{"application/json":{"schema":{"oneOf":[{"required":["method"],"type":"object","properties":{"method":{"type":"string","description":"The Zoom Rooms check-in feature that helps maximize your room utilization. This API can either **check in** and confirm that you are using the room reservation or **check out** of the room so that the room is released from the scheduled meeting and made available for others to use.","example":"zoomroom.check_in","enum":["zoomroom.check_in"]},"params":{"type":"object","properties":{"calendar_id":{"type":"string","description":"The `id` field included in the [`calendarList` resource](https://developers.google.com/calendar/v3/reference/calendarList#resource). This field is only required if using Google Calendar for the event associated with the Zoom Room. Retrieve the value for this field by calling Google's [`CalendarList:list` API](https://developers.google.com/calendar/v3/reference/events/list). Applies to `zoomroom.check_in` and `zoomroom.check_out`.","example":"mycalendar@example.com"},"change_key":{"type":"string","description":"Represent the specific version of the calendar item. Retrieve it using Microsoft's [FindItem Operation](https://docs.microsoft.com/en-us/exchange/client-developer/web-service-reference/finditem-operation). It refers to the `ChangeKey` field of the `ItemId` element included in the operation response. This field is required only for Microsoft Exchange or Office 365 calendar. Applies to `zoomroom.check_in` and `zoomroom.check_out`.","example":"test_change_key"},"event_id":{"type":"string","description":"**Required** The unique identifier of the calendar event associated with the Zoom Room.\n\n If using Microsoft Exchange for the calendar integration, retrieve the value of this field using Microsoft's [`FindItem` Operation](https://docs.microsoft.com/en-us/exchange/client-developer/web-service-reference/finditem-operation). The value is the `Id` field of the `ItemId` element included in the operation response.\n\n If using the Google calendar integration for this event, call Google's [`Events:list` API](https://developers.google.com/calendar/v3/reference/events/list) to retrieve the value. The value is the `id` field in the [events resource](https://developers.google.com/calendar/v3/reference/events#resource). Applies to `zoomroom.check_in` and `zoomroom.check_out`.","example":"ebrg2b87a6uu9c678qhvsiahsc"},"resource_email":{"type":"string","description":"The [resource mailbox](https://support.microsoft.com/en-us/help/10063/creating-and-managing-resource-mailboxes-in-office-365) associated with the calendar. This field is only required for Microsoft Exchange / Office 365 Calendar. Applies to `zoomroom.check_in` and `zoomroom.check_out`.","format":"email","example":"zroom1@example.com"}}}}},{"required":["method"],"type":"object","properties":{"method":{"type":"string","description":"The Zoom Rooms check-in feature helps maximize your room utilization. Use this API to either **check in** and confirm that you are utilizing the room reservation or to **check out** of the room so that the room is released from the scheduled meeting and made available for others to use.","example":"zoomroom.check_out","enum":["zoomroom.check_out"]},"params":{"type":"object","properties":{"calendar_id":{"type":"string","description":"The `id` field included in the [calendarList resource](https://developers.google.com/calendar/v3/reference/calendarList#resource). This field is only required if Google Calendar is being used for the event associated with the Zoom Room. The value for this field can be retrieved by calling Google's [CalendarList:list API](https://developers.google.com/calendar/v3/reference/events/list). Applies to `zoomroom.check_in` and `zoomroom.check_out`.","example":"mycalendar@example.com"},"change_key":{"type":"string","description":"Represents the specific version of the calendar item. Retrieve it using Microsoft's [FindItem Operation](https://docs.microsoft.com/en-us/exchange/client-developer/web-service-reference/finditem-operation). It refers to the `ChangeKey` field of the `ItemId` element included in the operation response. This field is required only for Microsoft Exchange or Office 365 calendar. Applies to `zoomroom.check_in` and `zoomroom.check_out`.","example":"test_change_key"},"event_id":{"type":"string","description":"**Required** The unique identifier of the calendar event associated with the Zoom Room.\n\n If using Microsoft Exchange for the calendar integration, retrieve the value of this field using Microsoft's [FindItem Operation](https://docs.microsoft.com/en-us/exchange/client-developer/web-service-reference/finditem-operation). The value is the `Id` field of the `ItemId` element included in the operation response.\n\n If using the Google calendar integration for this event, call Google's [Events:list API](https://developers.google.com/calendar/v3/reference/events/list) to retrieve the value. The value is the `id` field in the [events resource](https://developers.google.com/calendar/v3/reference/events#resource). Applies to `zoomroom.check_in` and `zoomroom.check_out`.","example":"ebrg2b87a6uu9c678qhvsiahsc"},"resource_email":{"type":"string","description":"The [resource mailbox](https://support.microsoft.com/en-us/help/10063/creating-and-managing-resource-mailboxes-in-office-365) associated with the calendar. This field is only required for Microsoft Exchange / Office 365 Calendar. Applies to `zoomroom.check_in` and `zoomroom.check_out`.","format":"email","example":"zroom1@example.com"}}}}},{"required":["method"],"type":"object","properties":{"method":{"type":"string","description":"Mute the Zoom Rooms client.","example":"zoomroom.mute","enum":["zoomroom.mute"]}}},{"required":["method"],"type":"object","properties":{"method":{"type":"string","description":"Unmute the Zoom Rooms client.","example":"zoomroom.unmute","enum":["zoomroom.unmute"]}}},{"required":["method"],"type":"object","properties":{"method":{"type":"string","description":"Accept a meeting through the Zoom Rooms client.","example":"zoomroom.meeting_accept","enum":["zoomroom.meeting_accept"]}}},{"required":["method"],"type":"object","properties":{"method":{"type":"string","description":"Decline a meeting through the Zoom Rooms client.","example":"zoomroom.meeting_decline","enum":["zoomroom.meeting_decline"]}}},{"required":["method"],"type":"object","properties":{"method":{"type":"string","description":"Restart the Zoom Room client.","example":"zoomroom.restart","enum":["zoomroom.restart"]}}},{"required":["method"],"type":"object","properties":{"method":{"type":"string","description":"Leave a meeting in progress through the Zoom Rooms client.","example":"zoomroom.meeting_leave","enum":["zoomroom.meeting_leave"]}}},{"required":["method"],"type":"object","properties":{"method":{"type":"string","description":"Join a Zoom meeting from the Zoom Rooms client.","example":"zoomroom.meeting_join","enum":["zoomroom.meeting_join"]},"params":{"type":"object","properties":{"meeting_number":{"type":"string","description":"**Required** The meeting number. If this field has a value, join the meeting identified by this number. If this field does not have a value, start an [instant meeting](https://support.zoom.us/hc/en-us/articles/201362533-Instant-meetings-vs-scheduled-meetings). Applies to `zoomroom.meeting_join`.","example":"2022052323"},"passcode":{"type":"string","description":"The passcode to join the meeting.","example":"A123456"},"force_accept":{"type":"boolean","description":"Whether to force a user to immediately join the meeting. If true, forces the user to leave any current meetings and immediately join the meeting passed in the `meeting_number` value (or instant meeting, if there is no value). ","example":false},"make_zoom_room_host":{"type":"boolean","description":"Default: false.  If set to true, the Zoom Room will join this single meeting with the host role, if it joins before the meeting host and other participants, equivalent to the Zoom Rooms configuration setting [Make Zoom Rooms the host if it joins before meeting host and other participants](https://support.zoom.com/hc/en/article?id=zm_kb&sysparm_article=KB0060489)","example":false}}}}},{"required":["method"],"type":"object","properties":{"method":{"type":"string","description":"Invite a contact to use the Zoom Rooms client.","example":"zoomroom.meeting_invite","enum":["zoomroom.meeting_invite"]},"params":{"type":"object","properties":{"user_ids":{"type":"array","description":"(Required) A comma-separated list of callee user IDs, up to a maximum of 10 callees.","example":["30R7kT7bTIKSNUFEuH_Qlg"],"items":{"type":"string","description":"The user ID.","example":"30R7kT7bTIKSNUFEuH_Qlg"}}}}}},{"required":["method"],"type":"object","properties":{"method":{"type":"string","description":"Cancel a meeting via the Zoom Rooms client.","example":"zoomroom.meeting_cancel","enum":["zoomroom.meeting_cancel"]},"params":{"type":"object","properties":{"meeting_topic":{"type":"string","description":"**Required** The meeting topic, up to 200 characters.","example":"My zoom topic"},"start_time":{"type":"string","description":"**Required** The meeting's start time in ISO date-time format. If you use this value with the timezone, you must also pass the timezone field.","example":"2022-05-20T12:00:00Z"},"duration":{"type":"integer","description":"The scheduled meeting duration in minutes.","example":60},"timezone":{"type":"string","description":"The meeting's [timezone](https://developers.zoom.us/docs/api/rest/other-references/abbreviation-lists/#timezones). Optional if the `start_time` value includes a timezone offset. Applies to `zoomroom.meeting_cancel` and `zoomroom.meeting_schedule`.","example":"America/Los_Angeles"}}}}},{"required":["method"],"type":"object","properties":{"method":{"type":"string","description":"End a meeting in progress hosted by the Zoom Rooms client.","example":"zoomroom.meeting_end","enum":["zoomroom.meeting_end"]}}},{"required":["method"],"type":"object","properties":{"method":{"type":"string","description":"Schedule a meeting using the Zoom Rooms client.","example":"zoomroom.meeting_schedule","enum":["zoomroom.meeting_schedule"]},"params":{"type":"object","properties":{"passcode":{"type":"string","description":"The passcode to join the meeting.","example":"A123456"},"meeting_topic":{"type":"string","description":"**Required** The meeting topic, up to 200 characters.","example":"My zoom topic"},"start_time":{"type":"string","description":"**Required** The meeting's start time in ISO date-time format. If you use this value with the timezone, you must also pass the timezone field.","example":"2022-05-20T12:00:00Z"},"duration":{"type":"integer","description":"The scheduled meeting duration in minutes. Required for `zoomroom.meeting_cancel` and `zoomroom.meeting_schedule`.","example":60},"timezone":{"type":"string","description":"The meeting's [timezone](https://developers.zoom.us/docs/api/rest/other-references/abbreviation-lists/#timezones). Optional if the `start_time` value includes a timezone offset.","example":"America/Los_Angeles"},"settings":{"type":"object","properties":{"join_before_host":{"type":"boolean","description":"Whether to allow meeting participants to join before the meeting's host. Used only for scheduled or recurring meetings.","example":false}},"description":"The meeting settings. Applies to`zoomroom.meeting_schedule`."}}}}},{"required":["method"],"type":"object","properties":{"method":{"type":"string","description":"Join a third-party meeting.","example":"zoomroom.thirdparty_meeting_join","enum":["zoomroom.thirdparty_meeting_join"]},"params":{"type":"object","properties":{"event_id":{"type":"string","description":"The event ID of the event to be started.  Join the meeting through the event in the calendar. It is required for schedule meeting, but not for ad hoc meetings.  When using this field, other fields will all default to null.","example":"ebrg2b87a6uu9c678qhvsiahsc"},"passcode":{"type":"string","description":"The passcode for joining a third-party meeting. This field is not mandatory, it can be filled in when the meeting really has a passcode. It is required when join_type is meeting_id, and meeting_source_type is MS_TEAMS.","example":"A123456"},"join_type":{"type":"string","description":"The specific method of joining a conference. This field is only applicable to ad hoc conferences and is required. \n* `url` &mdash; Joining a meeting through the Teams/Meet joining URL.\n* `meeting_id` &mdash; Joining the meeting through the meeting ID and passcode of MS_TEAMS/GOOGLE_MEET.","example":"url","enum":["url","meeting_id","sip"]},"meeting_source_type":{"type":"string","description":"The type of third-party meeting that is specifically joined. Only required when `join_type` is `url` or `meeting_id`. \n* `MS_TEAMS` &mdash; MS teams meeting. \n*  `GOOGLE_MEET` &mdash; Google Meet meeting. ","example":"MS_TEAMS","enum":["MS_TEAMS","GOOGLE_MEET"]},"join_url":{"type":"string","description":"The URL for joining a Teams/Meet meeting. It needs to be filled only when `join_type` is url, and `meeting_source_type` is MS_TEAMS/GOOGLE_MEET.","example":"url"},"sip_address":{"type":"string","description":"The full SIP address to join the third-party meeting. If the SIP conference has a passcode, the passcode must be spliced according to the rules of the SIP provider. It is required only when `join_type` is `sip`.","example":"sip url"},"third_party_meeting_id":{"type":"string","description":"The meeting id of the third-party meeting. It is required only when `join_type` is `meeting_id`, and `meeting_source_type` is `MS_TEAMS`/`GOOGLE_MEET`.","example":"12324423"}}}}},{"required":["method"],"type":"object","properties":{"method":{"type":"string","description":"Start a Zoom Room alert.","example":"zoomroom.alarm_start","enum":["zoomroom.alarm_start"]}}},{"required":["method"],"type":"object","properties":{"method":{"type":"string","description":"Stop a Zoom Room alert.","example":"zoomroom.alarm_stop","enum":["zoomroom.alarm_stop"]}}},{"required":["method"],"type":"object","properties":{"method":{"type":"string","description":"Mute the Zoom Rooms client's camera(s).","example":"zoomroom.video_mute","enum":["zoomroom.video_mute"]}}},{"required":["method"],"type":"object","properties":{"method":{"type":"string","description":"Unmute the Zoom Rooms client's camera(s).","example":"zoomroom.video_unmute","enum":["zoomroom.video_unmute"]}}},{"required":["method"],"type":"object","properties":{"method":{"type":"string","description":"Switch the camera used by the Zoom Rooms client during a meeting.  This API has no effect if the Zoom Rooms client is not in a meeting.","example":"zoomroom.switch_camera","enum":["zoomroom.switch_camera"]},"params":{"type":"object","properties":{"cameraId":{"type":"string","description":"**Required** The new camera ID for the Zoom Rooms client to use.  Retrieve [Zoom Room device information](https://developers.zoom.us/docs/api/rest/reference/zoom-rooms/methods/#operation/listZRDevices) to find the available camera device IDs. This API has no effect if an invalid device ID is specified.","example":"{0.0.1.00000000}.{eff76542-ac52-4c78-bd90-67f968bab16f}"}},"example":""}}},{"required":["method"],"type":"object","properties":{"method":{"type":"string","description":"Switch the microphone used by the Zoom Rooms client during a meeting.  This API has no effect if the Zoom Rooms client is not in a meeting.","example":"zoomroom.switch_microphone","enum":["zoomroom.switch_microphone"]},"params":{"type":"object","properties":{"microphoneId":{"type":"string","description":"**Required** The new microphone ID for the Zoom Rooms client to use.  Retrieve [Zoom Room device information](https://developers.zoom.us/docs/api/rest/reference/zoom-rooms/methods/#operation/listZRDevices) to find the available microphone device IDs.  This API has no effect if an invalid device ID is specified.","example":"{0.0.1.00000000}.{eff76542-ac52-4c78-bd90-67f968bab16f}"}},"example":"microphoneId"}}},{"required":["method"],"type":"object","properties":{"method":{"type":"string","description":"Switch the speaker used by the Zoom Rooms client during a meeting.  This API has no effect if the Zoom Rooms client is not in a meeting.","example":"zoomroom.switch_speaker","enum":["zoomroom.switch_speaker"]},"params":{"type":"object","properties":{"speakerId":{"type":"string","description":"**Required** The new speaker ID for the Zoom Rooms client to use.  Retrieve [Zoom Room device information](https://developers.zoom.us/docs/api/rest/reference/zoom-rooms/methods/#operation/listZRDevices) to find the available speaker device IDs.  This API has no effect if an invalid device ID is specified.","example":"{0.0.1.00000000}.{eff76542-ac52-4c78-bd90-67f968bab16f}"}}}}},{"required":["method"],"type":"object","properties":{"method":{"type":"string","description":"Start sharing content on the Zoom Rooms client.","example":"zoomroom.share_content_start","enum":["zoomroom.share_content_start"]}}},{"required":["method"],"type":"object","properties":{"method":{"type":"string","description":"Stop sharing content on the Zoom Rooms client.","example":"zoomroom.share_content_stop","enum":["zoomroom.share_content_stop"]}}},{"required":["method"],"type":"object","properties":{"method":{"type":"string","description":"Change the speaker volume of the Zoom Rooms client.  This API has no effect if used when the Zoom Room is not in a meeting.","example":"zoomroom.volume_level","enum":["zoomroom.volume_level"]},"params":{"type":"object","properties":{"volume_level":{"type":"integer","description":"**Required** The new speaker volume level for the Zoom Rooms client to use.  Acceptable values range from 0-100.  This API has no effect if an invalid device ID is specified.","example":0}}}}}]}}}},"responses":{"202":{"description":"**HTTP Status Code:** `202` **Accepted**  \n \nRequest processed successfully."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `300` <br>\n * Zoom Room is offline. Please ensure that the Zoom Room is online before checking in or checking out. *Invalid parameters.* Device does not exist: {cameraId or speakerId or microphoneId}. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `1012` <br>\n Room does not exist: {roomId}. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:update:room_control:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:update:room_control:admin"]}}},"/rooms/{id}/settings":{"get":{"tags":["Zoom Rooms"],"summary":"Get Zoom Room settings","description":"Get information on meeting, alert, digital signage or scheduling display settings applied to a specific Zoom Room. By default, only **Meeting Settings** are returned. To view only **Alert Settings**, specify `alert` as the value of the `setting_type` query parameter.   \n**Prerequisites:**   *Zoom Room licenses* Owner or Admin privileges on the Zoom Account.   \n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:read:room_settings:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"getZRSettings","parameters":[{"name":"id","in":"path","description":"Unique Identifier of the Zoom Room.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}},{"name":"setting_type","in":"query","description":"The type of setting that you would like to retrieve.\n\n`alert`: Alert settings of the Zoom Room.\n\n`meeting`: Meeting settings of the Zoom Room.\n\n`signage`: Digital Signage settings of the Zoom Room.\n\n`scheduling_display`: Scheduling Display settings of the Zoom Room.","required":true,"schema":{"type":"string","example":"meeting","default":"meeting"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` **OK**  \n \nZoom Room settings returned successfully.","content":{"application/json":{"schema":{"oneOf":[{"title":"index0","type":"object","properties":{"meeting_security":{"type":"object","properties":{"encryption_type":{"type":"string","description":"Choose between enhanced encryption and [end-to-end encryption](https://support.zoom.us/hc/en-us/articles/360048660871) when starting or a meeting. When using end-to-end encryption, several features (e.g. cloud recording, phone/SIP/H.323 dial-in) will be **automatically disabled**.   \n   \n The value of this field can be one of the following:  \n \n`enhanced_encryption`: Enhanced encryption. Encryption is stored in the cloud if you enable this option.   \n \n\n`e2ee`: [End-to-end encryption](https://support.zoom.us/hc/en-us/articles/360048660871). The encryption key is stored in your local device and can not be obtained by anyone else. Enabling this setting also **disables** the following features: join before host, cloud recording, streaming, live transcription, breakout rooms, polling, 1:1 private chat, and meeting reactions.","example":"e2ee","enum":["enhanced_encryption","e2ee"]},"end_to_end_encrypted_meetings":{"type":"boolean","description":"Allow use of end-to-end encryption for meetings. If set to `true`, you can specify the encryption type in `encryption_type` field.","example":true},"auto_security":{"type":"boolean","description":"Whether to require that all meetings are secured with one security option. Require that all meetings are secured with one of the following security options: a passcode, Waiting Room, or &quot;Only authenticated users can join meetings&quot;. If no security option is enabled, Zoom will secure all meetings with Waiting Room.","example":true},"waiting_room":{"type":"boolean","description":"When participants join a meeting, place them in a waiting room and require the host to admit them individually. Enabling the waiting room automatically disables the setting for allowing participants to join before host.","example":true},"meeting_password":{"type":"boolean","description":"A passcode will be generated when scheduling a meeting and participants require the passcode to join the meeting. The Personal Meeting ID (PMI) meetings are not included.","example":true},"require_password_for_scheduled_meeting":{"type":"boolean","description":"Require a passcode for meetings which have already been scheduled","example":true},"rmi_password":{"type":"boolean","description":"All Room Meeting ID meetings that users can join via client, or room systems will be passcode-protected.","example":true},"password_for_rmi":{"type":"string","description":"A passcode will be generated when joining a room meeting with  Room Personal Meeting ID. ","example":"true"},"phone_password":{"type":"boolean","description":"A numeric passcode will be required for participants joining by phone if your meeting has a passcode. For meeting with an alphanumeric passcode, a numeric version will be generated.","example":true}}},"zoom_rooms":{"type":"object","properties":{"allow_multiple_content_sharing":{"type":"boolean","description":"Enable multiple participants to [share content simultaneously](https://support.zoom.us/hc/en-us/articles/360017767812-Sharing-Multiple-Screens-in-a-Zoom-Room) by default.","example":true},"remote_support":{"type":"boolean","description":"Whether to enable the [**Remote support**](https://support.zoom.us/hc/en-us/articles/360060951012-Enabling-remote-support) setting. This value defaults to `false`. By enabling this setting, the setting `allow_multiple_content_sharing` will not work.","example":true,"default":false},"audio_device_daily_auto_test":{"type":"boolean","description":"Enable [automated audio test](https://support.zoom.us/hc/en-us/articles/360000319683-Zoom-Rooms-Daily-Audio-Testing) to ensure high quality audio.","example":true},"auto_direct_sharing":{"type":"boolean","description":"Enable participants in a Zoom Room to share their laptop screen on the Zoom Room TV without entering a meeting ID or sharing code.","example":true},"auto_start_scheduled_meeting":{"type":"boolean","description":"Automatically start scheduled meetings according to the start time listed on the calendar associated with the room. A meeting alert will appear 10 minutes prior to the scheduled time on the TV.","example":true},"auto_stop_scheduled_meeting":{"type":"boolean","description":"Automatically stop the meeting at the end time as scheduled and listed in the calendar associated with the room. ","example":true},"count_attendees_number_in_room":{"type":"boolean","description":"Use facial detection technology to [determine and display the attendees count](https://support.zoom.us/hc/en-us/articles/360031027111-Count-Attendees-in-Zoom-Rooms) after meetings on Dashboard.\n","example":true},"display_feedback_survey":{"type":"boolean","description":"Display a [survey](https://support.zoom.us/hc/en-us/articles/214193146-End-of-Meeting-Attendee-Feedback) at the end of each meeting regarding the audio and video quality on the Zoom Rooms Controller.","example":true},"display_meeting_list":{"type":"boolean","description":" Show the same information on the TV that is shown on the controller.","example":true},"display_top_banner":{"type":"boolean","description":"Allow to display room name, time and sharing key on the top portion of TV.","example":true},"encrypt_shared_screen_content":{"type":"boolean","description":"Encrypt screen and content shared in meetings.","example":true},"hide_id_for_private_meeting":{"type":"boolean","description":"If enabled, the meeting host and meeting ID (in addition to the meeting topic) are hidden from the Zoom Rooms display for private meetings. This affects meetings that were originally scheduled as private, as well as public meetings that were transformed to private.","example":true},"hide_share_instruction":{"type":"boolean","description":"Hide share instructions from TV.","example":true},"send_whiteboard_to_internal_contact_only":{"type":"boolean","description":"Restrict[ sending Whiteboard sessions](https://support.zoom.us/hc/en-us/articles/115004797286-Using-the-Whiteboard-in-Zoom-Rooms-for-Touch#h_781274b3-5237-4320-8826-be2120b00e21) to contacts or internal users only.","example":true},"show_alert_before_meeting":{"type":"boolean","description":"If enabled, the upcoming meeting alert message will be shown on the TV display. The value of the `upcoming_meeting_alert` field should be set to `true` to use this field. ","example":true},"show_call_history_in_room":{"type":"boolean","description":"Allow users to see call history of joined meetings and phone calls from the Zoom Rooms controller.\n","example":true},"show_contact_list_on_controller":{"type":"boolean","description":"If enabled, you can invite participants from the contact list during a meeting or when starting a meeting","example":true},"make_room_alternative_host":{"type":"boolean","description":"If enabled, a Zoom Room automatically becomes the host when it joins an internal meeting before the host and other participants.","example":true},"hide_user_personal_information":{"type":"boolean","description":"If enabled, all personal information in contact details page will be hidden.","example":true},"bypass_meeting_password":{"type":"boolean","description":"If enabled, users do not need to manually enter the meeting passcode when a Zoom Room joins a scheduled meeting on its meeting list. ","example":true},"show_non_video_participants":{"type":"boolean","description":"If enabled, meeting participants that are audio only or have their video turned off will also be shown on the Zoom Rooms display by default.","example":true},"start_airplay_manually":{"type":"boolean","description":"Require the AirPlay service to be [started by an administrator](https://support.zoom.us/hc/en-us/articles/204726885-Screen-Share-Using-Airplay-Mirroring#h_a342ad38-4e46-47a8-a1d9-cded3b144b39) rather than always being available.","example":true},"start_airplay_mirroring":{"type":"boolean","description":"Allow users to share content via Apple Screen Mirroring (called Airplay on iOS 11 or earlier) in Zoom Rooms","example":true},"support_join_3rd_party_meeting":{"type":"boolean","description":"Integrate with Skype for Business, GoToMeeting, or WebEx and show the meeting dial-in button on the meeting list tab for Zoom Rooms Controllers.","example":true},"transform_meeting_to_private":{"type":"boolean","description":"If enabled, all meetings in this room will be treated as [private meetings](https://support.zoom.us/hc/en-us/articles/115001051063-Zoom-Rooms-Private-Meetings), and the Zoom Room will display &quot;Your Name's Meeting&quot; instead of the real meeting topic.","example":true},"upcoming_meeting_alert":{"type":"boolean","description":"If enabled, a reminder will display 10 minutes prior to the next scheduled meeting on the controller.","example":true},"weekly_system_restart":{"type":"boolean","description":"[Restart](https://support.zoom.us/hc/en-us/articles/205418949-Zoom-Rooms-Weekly-System-Restart) the Zoom Rooms computer and controller once a week.","example":true},"entry_exit_chime":{"type":"string","description":"The sound that plays when participants join or leave a meeting: \n* `host` &mdash; Chime when host joins or leaves a meeting. \n* `all` &mdash; Chime when any participant joins or leaves a meeting. \n* `none` &mdash; Do not chime.","example":"all","enum":["host","all","none"]},"record_play_own_voice":{"type":"boolean","description":"When a participant joins by telephone, whether recording and playing the participant's own voice is enabled.","example":true},"incoming_meeting_request":{"type":"object","properties":{"automatically_accept_incoming_meeting_request":{"type":"boolean","description":"If enabled, the Zoom Room will automatically accept incoming meeting requests (calls), such as being invited to a meeting in progress","example":true},"automatically_unmute":{"type":"boolean","description":"If enabled, the Zoom Room will automatically unmute after it automatically accepts the incoming meeting request and joins the meeting","example":true}}},"automatically_accept_far_end_camera_control_request":{"type":"boolean","description":"If enabled, the Zoom Room will automatically accept incoming far end camera control (FECC) requests from other Zoom clients received during a Zoom meeting","example":true},"zr_always_display_name_label_in_meeting":{"type":"boolean","description":"When \"Always display participant name labels in meetings\" is enabled, participant name labels should be shown in all meetings (even in 1:1 meetings) attended by a Zoom Room.  When it is disabled, the current behavior should be preserved.","example":false}}}}},{"title":"index1","type":"object","properties":{"client_alert":{"type":"object","properties":{"detect_bluetooth_microphone_error_alert":{"type":"boolean","description":"Display an alert message when an issue is detected with a bluetooth microphone.","example":true},"detect_bluetooth_speaker_error_alert":{"type":"boolean","description":"Display an alert message when an issue is detected with a bluetooth speaker.","example":true},"detect_camera_error_alert":{"type":"boolean","description":"Display an alert message when an issue is detected with a camera.","example":true},"detect_microphone_error_alert":{"type":"boolean","description":"Display an alert message when an issue is detected with microphone.","example":true},"detect_speaker_error_alert":{"type":"boolean","description":"Display an alert message when an issue is detected with a speaker.","example":true},"cpu_usage_high_detected_notification_on_zr_display":{"type":"boolean","description":"Display a notification message on the Zoom Room display when CPU usage is above 90%.","example":true},"network_unstable_detected_notification_on_zr_display":{"type":"boolean","description":"Display a notification message on the Zoom Room display low bandwidth network is detected","example":true}},"description":"The Client Alert Settings section includes alerts that display on the TV screen of the Zoom Room. Disable these settings if you have deliberately disconnected one or more peripheral devices or have never enabled them. "},"digital_signage":{"type":"object","properties":{"banner":{"type":"object","properties":{"banner_room_name":{"type":"boolean","description":"Display or hide banner room name.","example":true},"banner_sharing_key":{"type":"boolean","description":"Display or hide banner sharing key.","example":true},"banner_time":{"type":"boolean","description":"Display or hide time in the banner.","example":true}},"description":"Specifies the elements that you want to display in the top banner."},"display_period":{"type":"object","properties":{"start_displaying_content":{"type":"integer","description":"Start displaying digital signage content after certain duration after the meeting ends. The value of this field indicates the duration in minutes.","example":1},"stop_displaying_content":{"type":"integer","description":"Stop displaying content {certain_duration} before a meeting is scheduled to begin. The value of this field indicates the duration in minutes.","example":1}},"description":"Display period object lets you define the number of minutes before or after the scheduled meeting time you would like the content to display."},"enable_digital_signage":{"type":"boolean","description":"[Indicates whether digital signage is on or off,](https://support.zoom.us/hc/en-us/articles/360000030683-Zoom-Rooms-digital-signage#h_767fbb33-82a8-45a8-8392-a1bfa9687edd).   \n \n`true`: enable  \n  `false`: disable","example":true},"layout":{"type":"string","description":"Set the [layout](https://support.zoom.us/hc/en-us/articles/360000030683-Zoom-Rooms-digital-signage#h_4e25ddf3-8f97-4957-8f8b-99725f940fa7). The value of this field can be either `standard` or `video_content`.\n\n`standard`: Standard Center  \n \n`video_content`: Video + Content","example":"standard"},"mute":{"type":"boolean","description":"Sound of all contents will be muted if the value of this field is set to `true`.","example":true},"play_list":{"maxItems":2,"type":"array","description":"Content list.","items":{"type":"object","properties":{"action":{"type":"string","description":"Specify an action for the content list. The value can be one of the following:  \n \n`add`: Add another content list.  \n \n`update`: Update existing content list.  \n \n`delete`: Delete content list.\n","example":"update","enum":["add","update","delete"]},"contents":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"content_id":{"type":"string","description":"Content Id.","example":"blKfsfQ-QSW7V_LPjZrIdg"},"duration":{"type":"integer","description":"Duration for how long the content will be displayed.","example":65},"id":{"type":"string","example":"blKfsfQ-QSW7V_LPjZrIdg"},"name":{"type":"string","description":"Name of the content.","example":"content name"},"order":{"type":"integer","description":"Order of the content in the display.","example":1}},"description":"Content list."}},"end_time":{"type":"string","description":"Specify the display end time for the content list in GMT.","example":"2021-03-18T05:41:36Z"},"id":{"type":"string","description":"Unique identifier of the content list. This field is only required if you would like to remove or update the content list.","example":"blKfsfQ-QSW7V_LPjZrIdg"},"name":{"type":"string","description":"Name of the content list.","example":"content list"},"start_time":{"type":"string","description":"Specify the display start time for the content list in GMT.","example":"2021-03-18T05:41:36Z"}}}}}},"notification":{"type":"object","properties":{"audio_meet_usability_threshold":{"type":"boolean","description":"Send an alert when the audio echo test result meets usability threshold.","example":true},"audio_not_meet_usability_threshold":{"type":"boolean","description":"Send an alert when the audio echo test result does not meet usability threshold.","example":true},"battery_is_charging":{"type":"boolean","description":"Send an alert when the battery starts charging.","example":true},"battery_low_and_not_charging":{"type":"boolean","description":"Send an alert when the battery of the controller or the scheduling display is low (at 20%) and is not being charged.","example":true},"battery_percentage":{"type":"string","description":"Specify a percentage so that an alert is sent when the battery is less than the {battery_percentage} that you specified.","example":"90"},"controller_scheduling_disconnected":{"type":"boolean","description":"Send an alert when the connection to the Controller or Scheduling Display cannot be detected.","example":true},"controller_scheduling_reconnected":{"type":"boolean","description":"Send an alert when the Controller or Scheduling Display can be detected again.","example":true},"cpu_usage_high_detected":{"type":"boolean","description":"Send an alert when CPU usage is above 90%.","example":true},"mic_speaker_camera_disconnected":{"type":"boolean","description":"Send an alert when the mic, speaker or camera is disconnected in the Zoom Room.","example":true},"mic_speaker_camera_reconnected":{"type":"boolean","description":"Send an alert when the mic, speaker or camera is reconnected.","example":true},"network_unstable_detected":{"type":"boolean","description":"Send an alert when low bandwidth network is detected","example":true},"sip_registration_failed":{"type":"boolean","description":"Send an alert when SIP registration stops working. ","example":true},"sip_registration_re_enabled":{"type":"boolean","description":"Send an alert after the SIP registration is re-enabled.","example":true},"zoom_room_come_back_online":{"type":"boolean","description":"Send an alert when the Zoom Room is online after previously being offline.","example":true},"zoom_room_display_disconnected":{"type":"boolean","description":"Send an alert when the TV display is disconnected","example":true},"zoom_room_offline":{"type":"boolean","description":"Send an alert when the machine hosting the Zoom Room application has a network issue or cannot connect with the Controller.","example":true},"zoom_room_calendar_resource_is_inaccessible":{"type":"boolean","description":"Send a notification when the calendar resource of a Zoom Room configured with calendar integration is inaccessible.","example":true}},"description":"[Notifications Settings](https://support.zoom.us/hc/en-us/articles/205394099-Zoom-Room-Alerts#h_b430b5f2-5150-4522-9c96-c77f22ab70bc) includes the circumstances in which the room sends an email alert to the support team to notify them of a potentially urgent issue. These issues can affect the operation of the room, but do not display on the TV screen. The email alert is sent to the email address specified in the Notification Email Recipients section. "},"scheduling_display":{"type":"object","properties":{"instant_room_reservation":{"type":"boolean","description":"If enabled, the Zoom Room Scheduling Display will allow a user to perform an instant room reservation on the device.","example":true},"reserve_other_rooms":{"type":"object","properties":{"allow_to_reserve_other_rooms":{"type":"boolean","description":"If enabled, the Zoom Room Scheduling Display will allow a user to perform instant room reservations of other rooms on the device.","example":true},"location_types":{"type":"string","description":"The Zoom Room Scheduling Display will allow a user to find other rooms to reserve in the same parent Zoom Rooms Location Hierarchy Location as this device, and higher Location levels if so configured. Use the API [Get Zoom Room Location Structure](https://developers.zoom.us/docs/api/rest/reference/zoom-rooms/methods/#operation/getZRLocationStructure) to determine valid Location levels.","example":"floor","enum":["city","campus","building","floor"]}},"description":"Contains settings that allows Zoom Room Scheduling Display to reserve other Zoom Rooms."},"set_scheduling_display_background_image_to_zoom_room_background":{"type":"boolean","description":"If enabled, the Zoom Room Scheduling Display will use the same background image as the Zoom Room. Note: Some Zoom Rooms Scheduling displays use a different display aspect ratio than standard 16:9; the background image will be scaled to fit the Scheduling Display's display, with any excess cropped.","example":true},"home_screen_theme":{"type":"string","description":"The Zoom Room Scheduling Display UI theme.","example":"compact","enum":["standard","compact"]},"home_screen_qr_code_url":{"type":"string","description":"If the Zoom Rooms Scheduling Display home screen theme is \"compact\", a space is reserved for a QR code to be displayed. You may optionally provide a URL which Zoom will use to automatically generate the corresponding QR code image. If you provide a URL that exceeds 100 characters in total length, Zoom will automatically use the Zoom URL shortening service to generate a shortened URL that will redirect to your actual URL; the URL is shortened to increase QR code scan reliability. This setting has no effect if the home screen theme is \"standard\".","example":"https://example.com"},"home_screen_qr_code_supporting_text":{"type":"string","description":"If the Zoom Rooms Scheduling Display home screen theme is \"compact\", a space is reserved for additional text to appear adjacent to the space reserved for a QR code. This setting has no effect if the home screen theme is \"standard\".","example":"Scan to reserve"}},"description":"Scheduling Display Settings section includes performing Zoom Room reservations and setting the home screen theme on the Scheduling Display device."}}}]}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `200` <br>\n Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription.<br>\nAccess restricted. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `1012` <br>\n Room not found:{roomId}. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:read:admin","zoom_rooms:read:room_settings:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["ZoomRooms:Read"],"x-macro-scopes":["room:read:admin"],"x-granular-scopes":["zoom_rooms:read:room_settings:admin"]}},"patch":{"tags":["Zoom Rooms"],"summary":"Update Zoom Room settings","description":"Update meeting, alert, digital signage or scheduling display settings applied to a specific Zoom Room. To update **Alert Settings**, specify `alert` as the value of the `setting_type` query parameter. To update **Meeting Settings**, specify `meeting` as the value of the `setting_type` query parameter.   **Prerequisites:**   * Zoom Room licenses.* Owner or Admin privileges on the Zoom Account.   \n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:update:room_settings:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"updateZRSettings","parameters":[{"name":"id","in":"path","description":"Unique Identifier of the Zoom Room.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}},{"name":"setting_type","in":"query","description":"The type of setting that you would like to update.\n\n`alert`: Alert settings of the Zoom Room.\n\n`meeting`: Meeting settings of the Zoom Room.\n\n`signage`: Digital Signage settings of the Zoom Room.\n\n`scheduling_display`: Scheduling Display settings of the Zoom Room.","required":false,"schema":{"type":"string","example":"alert"}}],"requestBody":{"content":{"application/json":{"schema":{"oneOf":[{"title":"index0","type":"object","properties":{"meeting_security":{"type":"object","properties":{"encryption_type":{"type":"string","description":"Choose between enhanced encryption and [end-to-end encryption](https://support.zoom.us/hc/en-us/articles/360048660871) when starting or a meeting. When using end-to-end encryption, several features (e.g. cloud recording, phone/SIP/H.323 dial-in) will be **automatically disabled**.   \n   \n The value of this field can be one of the following:  \n \n`enhanced_encryption`: Enhanced encryption. Encryption is stored in the cloud if you enable this option.   \n \n\n`e2ee`: [End-to-end encryption](https://support.zoom.us/hc/en-us/articles/360048660871). The encryption key is stored in your local device and can not be obtained by anyone else. Enabling this setting also **disables** the following features: join before host, cloud recording, streaming, live transcription, breakout rooms, polling, 1:1 private chat, and meeting reactions.","example":"e2ee","enum":["enhanced_encryption","e2ee"]},"end_to_end_encrypted_meetings":{"type":"boolean","description":"Allow use of end-to-end encryption for meetings. If set to `true`, you can specify the encryption type in `encryption_type` field.","example":true},"auto_security":{"type":"boolean","description":"Whether to require that all meetings are secured with one security option. Require that all meetings are secured with one of the following security options: a passcode, Waiting Room, or &quot;Only authenticated users can join meetings&quot;. If no security option is enabled, Zoom will secure all meetings with Waiting Room.","example":true}}},"zoom_rooms":{"type":"object","properties":{"allow_multiple_content_sharing":{"type":"boolean","description":"Enable multiple participants to [share content simultaneously](https://support.zoom.us/hc/en-us/articles/360017767812-Sharing-Multiple-Screens-in-a-Zoom-Room) by default.","example":true},"remote_support":{"type":"boolean","description":"Whether to enable the [**Remote support**](https://support.zoom.us/hc/en-us/articles/360060951012-Enabling-remote-support) setting. This value defaults to `false`. By enabling this setting, the setting `allow_multiple_content_sharing` will not work.","example":true,"default":false},"audio_device_daily_auto_test":{"type":"boolean","description":"Enable [automated audio test](https://support.zoom.us/hc/en-us/articles/360000319683-Zoom-Rooms-Daily-Audio-Testing) to ensure high quality audio.","example":true},"auto_direct_sharing":{"type":"boolean","description":"Enable participants in a Zoom Room to share their laptop screen on the Zoom Room TV without entering a meeting ID or sharing code.","example":true},"auto_start_scheduled_meeting":{"type":"boolean","description":"Automatically start scheduled meetings according to the start time listed on the calendar associated with the room. A meeting alert will appear 10 minutes prior to the scheduled time on the TV.","example":true},"auto_stop_scheduled_meeting":{"type":"boolean","description":"Automatically stop the meeting at the end time as scheduled and listed in the calendar associated with the room. ","example":true},"count_attendees_number_in_room":{"type":"boolean","description":"Use facial detection technology to [determine and display the attendees count](https://support.zoom.us/hc/en-us/articles/360031027111-Count-Attendees-in-Zoom-Rooms) after meetings on Dashboard.\n","example":true},"display_feedback_survey":{"type":"boolean","description":"Display a [survey](https://support.zoom.us/hc/en-us/articles/214193146-End-of-Meeting-Attendee-Feedback) at the end of each meeting regarding the audio and video quality on the Zoom Rooms Controller.","example":true},"display_meeting_list":{"type":"boolean","description":" Show the same information on the TV that is shown on the controller.","example":true},"display_top_banner":{"type":"boolean","description":"Allow to display room name, time and sharing key on the top portion of TV.","example":true},"encrypt_shared_screen_content":{"type":"boolean","description":"Encrypt screen and content shared in meetings.","example":true},"hide_id_for_private_meeting":{"type":"boolean","description":"If enabled, the meeting host and meeting ID (in addition to the meeting topic) are hidden from the Zoom Rooms display for private meetings. This affects meetings that were originally scheduled as private, as well as public meetings that were transformed to private.","example":true},"hide_share_instruction":{"type":"boolean","description":"Hide share instructions from TV.","example":true},"send_whiteboard_to_internal_contact_only":{"type":"boolean","description":"Restrict[ sending Whiteboard sessions](https://support.zoom.us/hc/en-us/articles/115004797286-Using-the-Whiteboard-in-Zoom-Rooms-for-Touch#h_781274b3-5237-4320-8826-be2120b00e21) to contacts or internal users only.","example":true},"show_alert_before_meeting":{"type":"boolean","description":"If enabled, the upcoming meeting alert message will be shown on the TV display. The value of the `upcoming_meeting_alert` field should be set to `true` to use this field. ","example":true},"show_call_history_in_room":{"type":"boolean","description":"Allow users to see call history of joined meetings and phone calls from the Zoom Rooms controller.\n","example":true},"show_contact_list_on_controller":{"type":"boolean","description":"If enabled, you can invite participants from the contact list during a meeting or when starting a meeting","example":true},"make_room_alternative_host":{"type":"boolean","description":"If enabled, a Zoom Room automatically becomes the host when it joins an internal meeting before the host and other participants.","example":true},"hide_user_personal_information":{"type":"boolean","description":"If enabled, all personal information in contact details page will be hidden.","example":true},"bypass_meeting_password":{"type":"boolean","description":"If enabled, users do not need to manually enter the meeting passcode when a Zoom Room joins a scheduled meeting on its meeting list. ","example":true},"show_non_video_participants":{"type":"boolean","description":"If enabled, meeting participants that are audio only or have their video turned off will also be shown on the Zoom Room display by default.","example":true},"start_airplay_manually":{"type":"boolean","description":"Require the AirPlay service to be [started by an administrator](https://support.zoom.us/hc/en-us/articles/204726885-Screen-Share-Using-Airplay-Mirroring#h_a342ad38-4e46-47a8-a1d9-cded3b144b39) rather than always being available.","example":true},"start_airplay_mirroring":{"type":"boolean","description":"Allow users to share content via Apple Screen Mirroring (called Airplay on iOS 11 or earlier) in Zoom Rooms","example":true},"support_join_3rd_party_meeting":{"type":"boolean","description":"Integrate with Skype for Business, GoToMeeting, or WebEx and show the meeting dial-in button on the meeting list tab for Zoom Rooms Controllers.","example":true},"transform_meeting_to_private":{"type":"boolean","description":"If enabled, all meetings in this room will be treated as [private meetings](https://support.zoom.us/hc/en-us/articles/115001051063-Zoom-Rooms-Private-Meetings), and the Zoom Room will display &quot;Your Name's Meeting&quot; instead of the real meeting topic.","example":true},"upcoming_meeting_alert":{"type":"boolean","description":"If enabled, a reminder will display 10 minutes prior to the next scheduled meeting on the controller.","example":true},"weekly_system_restart":{"type":"boolean","description":"[Restart](https://support.zoom.us/hc/en-us/articles/205418949-Zoom-Rooms-Weekly-System-Restart) the Zoom Rooms computer and controller once a week.","example":true},"entry_exit_chime":{"type":"string","description":"The sound that plays when participants join or leave a meeting: \n* `host` &mdash; Chime when host joins or leaves a meeting. \n* `all` &mdash; Chime when any participant joins or leaves a meeting. \n* `none` &mdash; Do not chime.","example":"all","enum":["host","all","none"]},"record_play_own_voice":{"type":"boolean","description":"When a participant joins by telephone, whether recording and playing the participant's own voice is enabled.","example":true},"incoming_meeting_request":{"type":"object","properties":{"automatically_accept_incoming_meeting_request":{"type":"boolean","description":"If enabled, the Zoom Room will automatically accept incoming meeting requests (calls), such as being invited to a meeting in progress","example":true},"automatically_unmute":{"type":"boolean","description":"If enabled, the Zoom Room will automatically unmute after it automatically accepts the incoming meeting request and joins the meeting","example":true}}},"automatically_accept_far_end_camera_control_request":{"type":"boolean","description":"If enabled, the Zoom Room will automatically accept incoming far end camera control (FECC) requests from other Zoom clients received during a Zoom meeting","example":true}}}}},{"title":"index1","type":"object","properties":{"client_alert":{"type":"object","properties":{"detect_bluetooth_microphone_error_alert":{"type":"boolean","description":"Display an alert message when an issue is detected with a bluetooth microphone.","example":true},"detect_bluetooth_speaker_error_alert":{"type":"boolean","description":"Display an alert message when an issue is detected with a bluetooth speaker.","example":true},"detect_camera_error_alert":{"type":"boolean","description":"Display an alert message when an issue is detected with a camera.","example":true},"detect_microphone_error_alert":{"type":"boolean","description":"Display an alert message when an issue is detected with microphone.","example":true},"detect_speaker_error_alert":{"type":"boolean","description":"Display an alert message when an issue is detected with a speaker.","example":true},"cpu_usage_high_detected_notification_on_zr_display":{"type":"boolean","description":"Display a notification message on the Zoom Room display when CPU usage is above 90%.","example":true},"network_unstable_detected_notification_on_zr_display":{"type":"boolean","description":"Display a notification message on the Zoom Room display low bandwidth network is detected","example":true}},"description":"The Client Alert Settings section includes alerts that display on the TV screen of the Zoom Room. Disable these settings if you have deliberately disconnected one or more peripheral devices or have never enabled them. "},"digital_signage":{"type":"object","properties":{"banner":{"type":"object","properties":{"banner_room_name":{"type":"boolean","example":true},"banner_sharing_key":{"type":"boolean","example":true},"banner_time":{"type":"boolean","example":true}}},"display_period":{"type":"object","properties":{"start_displaying_content":{"type":"integer","description":"Start displaying digital signage content after certain duration after the meeting ends. Specify the value of the duration in minutes in this field.","example":1},"stop_displaying_content":{"type":"integer","description":"Stop displaying content {certain_duration} before a meeting is scheduled to begin. Specify the value of duration in minutes in this field.","example":1}},"description":"Display period object lets you define the number of minutes before or after the scheduled meeting time you would like the content to display."},"enable_digital_signage":{"type":"boolean","description":"[Enable or disable digital signage](https://support.zoom.us/hc/en-us/articles/360000030683-Zoom-Rooms-digital-signage#h_767fbb33-82a8-45a8-8392-a1bfa9687edd).   \n \n`true`: enable  \n  `false`: disable","example":true},"layout":{"type":"string","description":"Set the [layout](https://support.zoom.us/hc/en-us/articles/360000030683-Zoom-Rooms-digital-signage#h_4e25ddf3-8f97-4957-8f8b-99725f940fa7). The value of this field can be either `standard` or `video_content`.\n\n`standard`: Standard Center  \n \n`video_content`: Video + Content","example":"standard"},"mute":{"type":"boolean","description":"Sound of all contents will be muted if the value of this field is set to `true`.","example":true},"play_list":{"maxItems":2,"type":"array","description":"Content list.","items":{"type":"object","properties":{"action":{"type":"string","description":"Specify an action for the content list. The value can be one of the following:  \n \n`add`: Add another content list.  \n \n`update`: Update existing content list.  \n \n`delete`: Delete content list.\n","example":"update","enum":["add","update","delete"]},"contents":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"action":{"type":"string","description":"Specify an action for the content in the content list. The value can be one of the following:  \n \n`add`: Add another content to the content list.  \n \n`update`: Update existing content's information in the content list.  \n \n`delete`: Delete content from the content list.\n\n","example":"update"},"content_id":{"type":"string","description":"Content Id.","example":"blKfsfQ-QSW7V_LPjZrIdg"},"duration":{"type":"integer","description":"By default each content is display for 5 seconds. Using this field, specify how long you would like to display the content.","example":65},"id":{"type":"string","description":"Unique identifier of the content. This field is only required if you would like to remove or update the content information.","example":"blKfsfQ-QSW7V_LPjZrIdg"},"name":{"type":"string","description":"Name of the content.","example":"content name"},"order":{"type":"integer","description":"Order of the content in the display.","example":1}},"description":"Content list."}},"end_time":{"type":"string","description":"Specify the display end time for the content list in GMT.","example":"2021-03-18T05:41:36Z"},"id":{"type":"string","description":"Unique identifier of the content list. This field is only required if you would like to remove or update the content list.","example":"blKfsfQ-QSW7V_LPjZrIdg"},"name":{"type":"string","description":"Name of the content list.","example":"content list"},"start_time":{"type":"string","description":"Specify the display start time for the content list in GMT.","example":"2021-03-18T05:41:36Z"}}}}}},"notification":{"type":"object","properties":{"audio_meet_usability_threshold":{"type":"boolean","description":"Send an alert when the audio echo test result meets usability threshold.","example":true},"audio_not_meet_usability_threshold":{"type":"boolean","description":"Send an alert when the audio echo test result does not meet usability threshold.","example":true},"battery_is_charging":{"type":"boolean","description":"Send an alert when the battery starts charging.","example":true},"battery_low_and_not_charging":{"type":"boolean","description":"Send an alert when the battery of the controller or the scheduling display is low (at 20%) and is not being charged.","example":true},"battery_percentage":{"type":"string","description":"Specify a percentage so that an alert is sent when the battery is less than the {battery_percentage} that you specified.","example":"90"},"controller_scheduling_disconnected":{"type":"boolean","description":"Send an alert when the connection to the Controller or Scheduling Display cannot be detected.","example":true},"controller_scheduling_reconnected":{"type":"boolean","description":"Send an alert when the Controller or Scheduling Display can be detected again.","example":true},"cpu_usage_high_detected":{"type":"boolean","description":"Send an alert when CPU usage is above 90%.","example":true},"mic_speaker_camera_disconnected":{"type":"boolean","description":"Send an alert when the mic, speaker or camera is disconnected in the Zoom Room.","example":true},"mic_speaker_camera_reconnected":{"type":"boolean","description":"Send an alert when the mic, speaker or camera is reconnected.","example":true},"network_unstable_detected":{"type":"boolean","description":"Send an alert when low bandwidth network is detected","example":true},"sip_registration_failed":{"type":"boolean","description":"Send an alert when SIP registration stops working. ","example":true},"sip_registration_re_enabled":{"type":"boolean","description":"Send an alert after the SIP registration is re-enabled.","example":true},"zoom_room_come_back_online":{"type":"boolean","description":"Send an alert when the Zoom Room is online after previously being offline.","example":true},"zoom_room_display_disconnected":{"type":"boolean","description":"Send an alert when the TV display is disconnected","example":true},"zoom_room_offline":{"type":"boolean","description":"Send an alert when the machine hosting the Zoom Room application has a network issue or cannot connect with the Controller.","example":true}},"description":"[Notifications Settings](https://support.zoom.us/hc/en-us/articles/205394099-Zoom-Room-Alerts#h_b430b5f2-5150-4522-9c96-c77f22ab70bc) includes the circumstances in which the room sends an email alert to the support team to notify them of a potentially urgent issue. These issues can affect the operation of the room, but do not display on the TV screen. The email alert is sent to the email address specified in the Notification Email Recipients section. "},"scheduling_display":{"type":"object","properties":{"instant_room_reservation":{"type":"boolean","description":"If enabled, the Zoom Room Scheduling Display will allow a user to perform an instant room reservation on the device.","example":true},"reserve_other_rooms":{"type":"object","properties":{"allow_to_reserve_other_rooms":{"type":"boolean","description":"If enabled, the Zoom Room Scheduling Display will allow a user to perform instant room reservations of other rooms on the device.","example":true},"location_types":{"type":"string","description":"The Zoom Room Scheduling Display will allow a user to find other rooms to reserve in the same parent Zoom Rooms Location Hierarchy Location as this device, and higher Location levels if so configured. Use the API [Get Zoom Room Location Structure](https://developers.zoom.us/docs/api/rest/reference/zoom-rooms/methods/#operation/getZRLocationStructure) to determine valid Location levels.","example":"floor","enum":["city","campus","building","floor"]}},"description":"Contains settings that allows Zoom Room Scheduling Display to reserve other Zoom Rooms."},"set_scheduling_display_background_image_to_zoom_room_background":{"type":"boolean","description":"If enabled, the Zoom Room Scheduling Display will use the same background image as the Zoom Room. Note: Some Zoom Rooms Scheduling displays use a different display aspect ratio than standard 16:9; the background image will be scaled to fit the Scheduling Display's display, with any excess cropped.","example":true},"home_screen_theme":{"type":"string","description":"The Zoom Room Scheduling Display UI theme.","example":"compact","enum":["standard","compact"]},"home_screen_qr_code_url":{"type":"string","description":"If the Zoom Rooms Scheduling Display home screen theme is \"compact\", a space is reserved for a QR code to be displayed. You may optionally provide a URL which Zoom will use to automatically generate the corresponding QR code image. If you provide a URL that exceeds 100 characters in total length, Zoom will automatically use the Zoom URL shortening service to generate a shortened URL that will redirect to your actual URL; the URL is shortened to increase QR code scan reliability. This setting has no effect if the home screen theme is \"standard\".","example":"https://example.com"},"home_screen_qr_code_supporting_text":{"type":"string","description":"If the Zoom Rooms Scheduling Display home screen theme is \"compact\", a space is reserved for additional text to appear adjacent to the space reserved for a QR code. This setting has no effect if the home screen theme is \"standard\".","example":"Scan to reserve"}},"description":"Scheduling Display Settings section includes performing Zoom Room reservations and setting the home screen theme on the Scheduling Display device."}}}]}}}},"responses":{"204":{"description":"**HTTP Status Code:** `204` **No Content**  \n \nSettings updated successfully. "},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request \n\n **Error Code:** `200` <br>\n Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription.<br>\nAccess restricted. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:update:room_settings:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["ZoomRooms:Edit"],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:update:room_settings:admin"]}}},"/rooms/{roomId}":{"get":{"tags":["Zoom Rooms"],"summary":"Get Zoom Room profile","description":"\nZoom Rooms is a software-based room system that provides an integrated experience for audio conferencing, wireless screen sharing and video conferencing. Use this API to get detailed information on a specific Zoom Room in a Zoom account.\n\n**Prerequisites:**  \n \n* Pro or a higher plan with [Zoom Room](https://zoom.us/zoomrooms) license.  \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:read:room:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"getZRProfile","parameters":[{"name":"roomId","in":"path","description":"The unique identifier of the Zoom Room. This can be retrieved from the response of the [**List Zoom Rooms**](https://developers.zoom.us/docs/zoom-rooms/apis/#operation/listZoomRooms) API.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}},{"name":"regenerate_activation_code","in":"query","description":"Whether to regenerate an activation code for a Zoom Room. Default is `false`.","required":false,"schema":{"type":"boolean","example":true,"default":false}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` **OK**  \n \nZoom Room profile returned successfully.","content":{"application/json":{"schema":{"type":"object","properties":{"basic":{"type":"object","properties":{"activation_code":{"type":"string","description":"The code used to complete the setup of the Zoom Room.","example":"1315-2376-2198-7926"},"hide_room_in_contacts":{"type":"boolean","description":"Whether to hide this Zoom Room from your contact list. **True** to hide.  **False** to show.","example":true},"name":{"type":"string","description":"Name of the Zoom Room.","example":"My Personal Meeting Room"},"display_name":{"maxLength":64,"type":"string","description":"The short display name of the Zoom Room.","example":"My Personal Meeting Room"},"required_code_to_ext":{"type":"boolean","description":"Determines whether to require a code to exit out of the Zoom Rooms application to switch between other apps.","example":true},"room_passcode":{"maxLength":16,"minLength":1,"type":"string","description":"The 1-16 digit number or characters used to secure your Zoom Rooms application. This code must be entered on your Zoom Room Controller to change settings or sign out.","example":"975193018"},"support_email":{"type":"string","description":"The email address to use for reporting Zoom Room issues.","format":"email","example":"contact-it@example.com"},"support_phone":{"type":"string","description":"The phone number to use for reporting Zoom Room issues.\n","example":"18798769876"},"calendar_resource_id":{"type":"string","description":"The calendar resource's ID.","example":"u7GQ3q_zQbqJnNp02-oMjQ"},"zoom_room_type":{"type":"string","description":"The room type: `Kiosk`, `ZoomRoom`, `StandaloneWhiteboard`, `SchedulingDisplayOnly`, `DigitalSignageOnly`,`PersonalZoomRoom`","example":"ZoomRoom","enum":["Kiosk","ZoomRoom","StandaloneWhiteboard","SchedulingDisplayOnly","DigitalSignageOnly","PersonalZoomRoom"]},"location_id":{"type":"string","description":"The location ID of the place where the Zoom Room was added.","example":"49D7a0xPQvGQ2DCMZgSe7w"},"tag_ids":{"type":"array","description":"The list of tag ID associated with the Zoom Room.","items":{"type":"string","description":"The  tag ID associated with the Zoom Room.","example":"Tva2CuIdTgsv8wAnhyAdU3m06Y2HuLQtlh3"}},"use_display_name_on_scheduling_display":{"type":"boolean","description":"If enabled, the Zoom Rooms Scheduling Display(s) of this Zoom Room will show the display_name instead of the name.  Note: this setting is only effective if a display_name is configured.","example":true},"use_display_name_on_zoom_rooms_display_and_controller":{"type":"boolean","description":"If enabled, the Zoom Rooms Controller(s) and Zoom Rooms display(s) of this Zoom Room will show the display_name instead of the name.  Note: this setting is only effective if a display_name is configured.","example":true},"use_display_name_in_meetings":{"type":"boolean","description":"If enabled, the Zoom Room will use the display_name instead of the name in meetings; the display_name will be shown in the Zoom meeting participants list and as the Zoom Rooms' label in the meeting video layout of other meeting participants.  Note: this setting is only effective if a display_name is configured and the use_on_zoom_rooms_and_controller setting is enabled.","example":true},"capacity":{"maximum":500,"minimum":1,"type":"number","description":"The in-room participant capacity of the Zoom Room.","example":1},"show_room_capacity_on_the_zoom_rooms":{"type":"boolean","description":"If enabled, the Zoom Room show the seating capacity the display(s) of the Zoom Room.  Note: this setting is only effective if a capacity is configured.","example":true},"show_room_capacity_on_the_scheduling_display":{"type":"boolean","description":"If enabled, the Zoom Room show the seating capacity the Zoom Rooms Scheduling Display(s) of the Zoom Room.  Note: this setting is only effective if a capacity is configured.","example":true},"user_id":{"type":"string","description":"The user ID of the user assigned to a Personal Zoom Room.  Note: this field will only be present for Personal Zoom Rooms.","example":"Ih3wZpAjTlitZcAhuYRbxg"}}},"device":{"type":"object","properties":{"device_profile_id":{"type":"string","description":"The device's profile ID.","example":"J352JVkNRpyAgUaurxmrsh"}},"description":"The information about the device."},"setup":{"type":"object","properties":{"checkin_and_checkout":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether to enable check-in and check-out options.","example":true},"checkin_and_checkout_options":{"type":"object","properties":{"checkin_minutes_prior_to_meeting_start_time":{"type":"integer","description":"Allowed seconds for participants to check in prior to the meeting start time.","example":600},"allowed_minutes_before_release_room_after_no_checkout":{"type":"integer","description":"Allowed seconds before releasing a room due to no check-out or Zoom Room activity.","example":600},"enable_new_user_checkin_notification":{"type":"boolean","description":"Determine whether to notify in-room participants on the Zoom Rooms display when users check in.","example":true},"enable_remove_recurring":{"type":"boolean","description":"Remove recurring meeting series from Zoom Rooms.","example":true},"allowed_consecutive_missed_checkin_before_removing_room":{"type":"integer","description":"Allowed number of consecutive missed check-ins before removing the room from entire meeting series.","example":4}},"description":"Check-in and check-out options subsettings."}},"description":"The set up information for checking in and out of a Zoom Room."},"under_construction":{"type":"boolean","description":"Rooms with under construction mode enabled are hidden on the dashboard by default and all issue notifications are disabled. You can change your dashboard filters to show rooms under construction if you prefer.","example":true},"apply_background_image_to_all_displays":{"type":"boolean","description":"Apply the same background image to all displays of the Zoom Room. If the value of the this field is true, the `background_image_info` object will only contain and only accept changes to the background image information of `zoom_rooms_display1`.","example":true},"background_image_info":{"type":"array","description":"The background image information for each display. If the value of the `apply_background_image_to_all_displays` field is `true`, this object will only accept changes to the background image information of `zoom_rooms_display1`.","items":{"type":"object","properties":{"display_id":{"type":"string","description":"The id of the display. The value can be one of the following:  \n \n`zoom_rooms_display1`: The display1 of the Zoom Room.  \n \n`zoom_rooms_display2`: The display2 of the Zoom Room.  \n \n`zoom_rooms_display3`: The display3 of the Zoom Room. \n \n`zoom_rooms_display4`: The display4 of the Zoom Room. \n \n`companion_whiteboard`: The display of the Companion Whiteboard. \n \n`companion_zoom_rooms`: The display of the Companion Zoom Room.\n","example":"zoom_rooms_display1","enum":["zoom_rooms_display1","zoom_rooms_display2","zoom_rooms_display3","zoom_rooms_display4","companion_whiteboard","companion_zoom_rooms"]},"content_id":{"type":"string","description":"When the background image is a [background image library content item](https://developers.zoom.us/docs/api/rest/reference/zoom-rooms/methods/#operation/ListZoomRoomsbackgroundimagelibrarycontents) or [default Zoom Rooms background image library content item](https://developers.zoom.us/docs/api/rest/reference/zoom-rooms/methods/#operation/ListDefaultZoomRoomsBackgroundImageLibrarycontents), this field will contain the `content_id`. When a background image has been directly uploaded, this field will be empty.\"","example":"zrd9DycNSxK6K4dEUS6z-g"},"download_url":{"type":"string","description":"The URL where the background image file may be downloaded. This URL will be expire according to the `download_url_ttl`.","example":"https://zoom.us/file/Sq2mdxqRQ9eq7wmD5TFD6g?jwt=eyJ0eXAiOiJKV1QiLCJrIjoiaHRlNU05dDciLCJ6bV9za20iOiJ6bV9vMm0iLCJhbGc"},"download_url_ttl":{"type":"integer","description":"The time to live of the download URL, in seconds. When this field is not present, the link will never expire.","example":3600}}}},"pro_device":{"type":"boolean","description":"If enabled, the Personal Zoom Room will consume a Zoom Rooms license and have access to \"Pro\" features.  Note: this field will only be present for Personal Zoom Rooms.","example":true}}}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `200` <br>\n * Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription.\n* Access restricted. \n* No permission to regenerate an activation code for a Zoom Room. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `1012` <br>\n Room not found: {roomId}. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:read:admin","zoom_rooms:read:room:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["ZoomRooms:Read"],"x-macro-scopes":["room:read:admin"],"x-granular-scopes":["zoom_rooms:read:room:admin"]}},"delete":{"tags":["Zoom Rooms"],"summary":"Delete a Zoom Room","description":"[Remove](https://support.zoom.us/hc/en-us/articles/360033432032-Zoom-Room-Device-Profiles#h_e55b2092-c418-4b02-819f-44de51448900) a specific Zoom Room profile from a Zoom account.  \n   \n \n**Prerequisites:**  \n \n* Pro or a higher plan with [Zoom Room](https://zoom.us/zoomrooms) license.  \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:delete:room:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"deleteAZoomRoom","parameters":[{"name":"roomId","in":"path","description":"Unique identifier of a Zoom Room.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}}],"responses":{"204":{"description":"**HTTP Status Code:** `204` **No Content**   \n \nZoom Room deleted successfully.\n"},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request \n\n **Error Code:** `200` <br>\n Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription.<br>\nAccess restricted.<br> <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found \n\n **Error Code:** `1012` <br>\n Room not found:{roomId} <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:delete:room:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["ZoomRooms:Edit"],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:delete:room:admin"]}},"patch":{"tags":["Zoom Rooms"],"summary":"Update a Zoom Room profile","description":"Update basic information on a specific Zoom Room in a Zoom account.  \n \n\n**Prerequisites:**  \n \n* Pro or a higher plan with [Zoom Room](https://zoom.us/zoomrooms) license.  \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:update:room:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"updateRoomProfile","parameters":[{"name":"roomId","in":"path","description":"The unique identifier of a Zoom Room.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"basic":{"type":"object","properties":{"hide_room_in_contacts":{"type":"boolean","description":"Hide this Zoom Room from your Contact List.","example":true},"zoom_room_type":{"type":"string","description":"The room type: Kiosk, ZoomRoom, StandaloneWhiteboard, SchedulingDisplayOnly, DigitalSignageOnly,PersonalZoomRoom","example":"ZoomRoom","enum":["Kiosk","ZoomRoom","StandaloneWhiteboard","SchedulingDisplayOnly","DigitalSignageOnly","PersonalZoomRoom"]},"name":{"type":"string","description":"Name of the Zoom Room.","example":"My Personal Meeting Room"},"display_name":{"type":"string","description":"The short display name of the Zoom Room.","example":"My Personal Meeting Room"},"required_code_to_ext":{"type":"boolean","description":"Require code to exit out of Zoom Rooms application to switch between other apps.\n","example":true},"room_passcode":{"maxLength":16,"minLength":1,"type":"string","description":"1-16 digit number or characters used to secure your Zoom Rooms application. This code must be entered on your Zoom Room Controller to change settings or sign out.","example":"975193018"},"support_email":{"type":"string","description":"The email address to use for reporting Zoom Room issues.","format":"email","example":"contact-it@example.com"},"support_phone":{"type":"string","description":"The phone number to use for reporting Zoom Room issues.\n","example":"18798769876"},"calendar_resource_id":{"type":"string","description":"The calendar resource's ID. If the value of this field is empty (`&quot;&quot;`), the calendar resource will be removed from Zoom Room.","example":"u7GQ3q_zQbqJnNp02-oMjQ"},"tag_ids":{"type":"array","description":"The list of tag ID to be associated with the Zoom room.","items":{"type":"string","description":"The  tag ID to be associated with the Zoom room.","example":"Tva2CuIdTgsv8wAnhyAdU3m06Y2HuLQtlh3"}},"use_display_name_on_scheduling_display":{"type":"boolean","description":"If enabled, the Zoom Rooms Scheduling Display(s) of this Zoom Room will show the display_name instead of the name.  Note: this setting is only effective if a display_name is configured.","example":true},"use_display_name_on_zoom_rooms_display_and_controller":{"type":"boolean","description":"If enabled, the Zoom Rooms Controller(s) and Zoom Rooms display(s) of this Zoom Room will show the display_name instead of the name.  Note: this setting is only effective if a display_name is configured.","example":true},"use_display_name_in_meetings":{"type":"boolean","description":"If enabled, the Zoom Room will use the display_name instead of the name in meetings; the display_name will be shown in the Zoom meeting participants list and as the Zoom Rooms' label in the meeting video layout of other meeting participants.  Note: this setting is only effective if a display_name is configured and the use_on_zoom_rooms_and_controller setting is enabled.","example":true},"capacity":{"maximum":500,"minimum":1,"type":"integer","description":"The in-room participant capacity of the Zoom Room.","example":1},"show_room_capacity_on_the_zoom_rooms":{"type":"boolean","description":"If enabled, the Zoom Room show the seating capacity the display(s) of the Zoom Room.  Note: this setting is only effective if a capacity is configured.","example":true},"show_room_capacity_on_the_scheduling_display":{"type":"boolean","description":"If enabled, the Zoom Room show the seating capacity the Zoom Rooms Scheduling Display(s) of the Zoom Room.  Note: this setting is only effective if a capacity is configured.","example":true}}},"device":{"type":"object","properties":{"device_profile_id":{"type":"string","description":"The device's profile ID.","example":"J352JVkNRpyAgUaurxmrsh"}},"description":"The information about the device."},"setup":{"type":"object","properties":{"checkin_and_checkout":{"type":"object","properties":{"enable":{"type":"boolean","description":"Whether to enable check-in and check-out options.","example":true},"checkin_and_checkout_options":{"type":"object","properties":{"checkin_minutes_prior_to_meeting_start_time":{"type":"integer","description":"Allowed seconds for participants to check-in prior to meeting start time.","example":600},"allowed_minutes_before_release_room_after_no_checkout":{"type":"integer","description":"Allowed seconds before releasing room due to no check-out or Zoom Room activity.","example":600},"enable_new_user_checkin_notification":{"type":"boolean","description":"Notify in-room participants on the Zoom Rooms display when users check in.","example":true},"enable_remove_recurring":{"type":"boolean","description":"Remove recurring meeting series from Zoom Rooms.","example":true},"allowed_consecutive_missed_checkin_before_removing_room":{"type":"integer","description":"Allowed number of consecutive missed check-ins before removing the room from entire meeting series.","example":4}},"description":"Check-in and check-out options subsettings."}},"description":"The set up information for checking in and out of Zoom Room."},"under_construction":{"type":"boolean","description":"Rooms with under construction mode enabled are hidden on the dashboard by default and all issue notifications are disabled. You can change your dashboard filters to show rooms under construction if you prefer.","example":true},"apply_background_image_to_all_displays":{"type":"boolean","description":"Apply the same background image to all displays of the Zoom Room. If the value of the this field is `true`, the `background_image_info` object will only contain and only accept changes to the background image information of `zoom_rooms_display1`","example":true},"background_image_info":{"type":"array","description":"The background image information for each display. If the value of the `apply_background_image_to_all_displays` field is `true`, this object will only accept changes to the background image information of `zoom_rooms_display1`.","items":{"type":"object","properties":{"display_id":{"type":"string","description":"The id of the display. The value can be one of the following:  \n \n`zoom_rooms_display1`: The display1 of the Zoom Room.  \n \n`zoom_rooms_display2`: The display2 of the Zoom Room.  \n \n`zoom_rooms_display3`: The display3 of the Zoom Room. \n \n`zoom_rooms_display4`: The display4 of the Zoom Room. \n \n`companion_whiteboard`: The display of the Companion Whiteboard. \n \n`companion_zoom_rooms`: The display of the Companion Zoom Room.\n","example":"zoom_rooms_display1","enum":["zoom_rooms_display1","zoom_rooms_display2","zoom_rooms_display3","zoom_rooms_display4","companion_whiteboard","companion_zoom_rooms"]},"content_id":{"type":"string","description":"To set the background image to a [background image library content item](https://developers.zoom.us/docs/api/rest/reference/zoom-rooms/methods/#operation/ListZoomRoomsbackgroundimagelibrarycontents) or [default Zoom Rooms background image library content item](https://developers.zoom.us/docs/api/rest/reference/zoom-rooms/methods/#operation/ListDefaultZoomRoomsBackgroundImageLibrarycontents), set this field to a background image library content item's `content_id`. To reset the background, set the content_id to an empty string.","example":"LHMmOOYaRiOA5m5WZjXVPA"}}}},"pro_device":{"type":"boolean","description":"If enabled, the Personal Zoom Room will consume a Zoom Rooms license and have access to \"Pro\" features.  Note: this field will only be present for Personal Zoom Rooms.","example":true},"screen_lock_pin":{"type":"string","description":"Set a 6-digit screen lock pin.  Only numeric characters are allowed.  Note: this field will only be present for Personal Zoom Rooms.","example":"123456"}}}}}}}},"responses":{"204":{"description":"**HTTP Status Code:** `204` **No Content**   Zoom Room profile information updated successfully."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `200` <br>\n Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription.<br>\n**Access restricted**.<br><br> <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `1012` <br>\n Zoom Room not found: {roomId}.<br><br>. <br>\n**Error Code:** `8005` <br>\n Zoom Room device profile does not exist: {roomId}.<br><br> <br>\n**Error Code:** `4060` <br>\n Calendar resource does not exist: {resourceId}.<br><br> <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:update:room:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["ZoomRooms:Edit"],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:update:room:admin"]}}},"/rooms/{roomId}/device_profiles":{"get":{"tags":["Zoom Rooms"],"summary":"List device profiles","description":"Returns a list of Zoom Room device profiles.  **Prerequisites:** * A Pro or a higher account with Zoom Rooms.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:read:list_device_profiles:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"getRoomProfiles","parameters":[{"name":"roomId","in":"path","description":"The Zoom Room's ID.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` **OK**  \n \nDevice profiles returned.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"audio_processing":{"type":"boolean","description":"Whether audio processing is enabled.","example":false},"auto_adjust_mic_level":{"type":"boolean","description":"Whether microphone level auto adjust is enabled.","example":true},"camera_id":{"type":"string","description":"The camera's device ID.","example":"usb#vid_0bda&pid_58fd&mi_00#6&1e7cbc97&0&0000#{65e8773d-8f56-11d0-a3b9-00a0c9223196}global"},"echo_cancellation":{"type":"boolean","description":"Whether echo cancellation is enabled.","example":true},"id":{"type":"string","description":"The device's profile ID.","example":"Gz_fNcaSPByng-3vsqv_iQ"},"microphone_id":{"type":"string","description":"The microphone's device ID.","example":"{0.0.2.00000000}.{eff76572-ac52-4c79-bd30-67f968bjb15f}"},"name":{"type":"string","description":"The device profile's name.","example":"ZR1 Device"},"noise_suppression":{"type":"string","description":"The noise suppression setting: \n* `moderate` &mdash; Moderate noise suppression. \n* `aggressive` &mdash; Aggressive noise suppression. \n* `none` &mdash; Noise suppression disabled.","example":"aggressive","enum":["moderate","aggressive","none"]},"speaker_id":{"type":"string","description":"The speaker's device ID.","example":"{0.0.0.00000000}.{4f9b30cb-872e-49ed-a1b9-a7ec352bf3e6}"}},"description":"The information about the Zoom Room's device profile."}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `200` <br>\n * Zoom Room subscription not found. Purchase a Zoom Room subscription and try again. <br>\n* Access restricted. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `1012` <br>\n Zoom Room ID does not exist: {roomId}. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:read:admin","zoom_rooms:read:list_device_profiles:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["room:read:admin"],"x-granular-scopes":["zoom_rooms:read:list_device_profiles:admin"]}},"post":{"tags":["Zoom Rooms"],"summary":"Create a device profile","description":"Creates a Zoom Room device profile.  **Prerequisites:** * A Pro or a higher account with Zoom Rooms.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:write:device_profile:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"createRoomDeviceProfile","parameters":[{"name":"roomId","in":"path","description":"The Zoom Room's ID.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"audio_processing":{"type":"boolean","description":"Whether to enable audio processing.","example":false},"auto_adjust_mic_level":{"type":"boolean","description":"Whether to enable microphone level auto adjust.","example":true},"camera_id":{"type":"string","description":"The camera's device ID.","example":"usb#vid_0bda&pid_58fd&mi_00#6&1e7cbc97&0&0000#{65e8773d-8f56-11d0-a3b9-00a0c9223196}global"},"echo_cancellation":{"type":"boolean","description":"Whether to enable echo cancellation.","example":true},"microphone_id":{"type":"string","description":"The microphone's device ID.","example":"{0.0.2.00000000}.{eff76572-ac52-4c79-bd30-67f968bjb15f}"},"name":{"type":"string","description":"The device profile's name.","example":"ZR1 Device"},"noise_suppression":{"type":"string","description":"The noise suppression setting: \n* `moderate` &mdash; Moderate noise suppression. \n* `aggressive` &mdash; Aggressive noise suppression. \n* `none` &mdash; Noise suppression disabled.","example":"none","enum":["moderate","aggressive","none"]},"speaker_id":{"type":"string","description":"The speaker's device ID.","example":"{0.0.0.00000000}.{4f9b30cb-872e-49ed-a1b9-a7ec352bf3e6}"}},"description":"Information about the Zoom Room device profile."}}}},"responses":{"201":{"description":"**HTTP Status Code:** `201` **Created**  \n \nDevice profile successfully created."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `200` <br>\n * Zoom Room subscription not found. Purchase a Zoom Room subscription and try again. <br>\n* Access restricted. <br>\n**Error Code:** `300` <br>\n Unable to create device profile because there is no microphone/speaker/camera available in the following Zoom Room: {roomId}. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `1012` <br>\n Room does not exist: {roomId}. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:write:device_profile:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:write:device_profile:admin"]}}},"/rooms/{roomId}/device_profiles/devices":{"get":{"tags":["Zoom Rooms"],"summary":"Get device information","description":"Returns information about a Zoom Room device.  **Prerequisites:** * A Pro or a higher account with Zoom Rooms.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:read:device_profile:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"getRoomDevices","parameters":[{"name":"roomId","in":"path","description":"The Zoom Room's ID.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200`   \n \n Device information returned.","content":{"application/json":{"schema":{"type":"object","properties":{"cameras":{"type":"array","description":"Information about the Zoom Room device's cameras.","items":{"type":"object","properties":{"id":{"type":"string","description":"The camera's device ID.","example":"usb#vid_0bda&pid_58fd&mi_00#6&1e7cbc97&0&0000#{65e8773d-8f56-11d0-a3b9-00a0c9223196}global"},"name":{"type":"string","description":"The camera's device name.","example":"Integrated Webcam"}}}},"microphones":{"type":"array","description":"Information about the Zoom Room device's microphone.","items":{"type":"object","properties":{"id":{"type":"string","description":"The microphone's device ID.","example":"{0.0.1.00000000}.{eff76542-ac52-4c78-bd90-67f968bab16f}"},"name":{"type":"string","description":"The microphone's device name.","example":"Realtek(R) Audio"}}}},"speakers":{"type":"array","description":"Information about the Zoom Room device's speakers.","items":{"type":"object","properties":{"id":{"type":"string","description":"The speaker's device ID.","example":"{0.0.0.00000000}.{4f9b30cb-872e-49ed-a1b9-a7ec352bf3e6}"},"name":{"type":"string","description":"The speaker's device name.","example":"Realtek(R) Audio"}}}}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `200` <br>\n * Zoom Room subscription not found. Purchase a Zoom Room subscription and try again. <br>\n* Access restricted. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `1012` <br>\n Zoom Room ID does not exist: {roomId}. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:read:admin","zoom_rooms:read:device_profile:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["room:read:admin"],"x-granular-scopes":["zoom_rooms:read:device_profile:admin"]}}},"/rooms/{roomId}/device_profiles/{deviceProfileId}":{"get":{"tags":["Zoom Rooms"],"summary":"Get a device profile","description":"Returns a Zoom Room device profile.  **Prerequisites:** * A Pro or a higher account with Zoom Rooms.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:read:admin`,`room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:read:device_profile:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"getRoomProfile","parameters":[{"name":"roomId","in":"path","description":"The Zoom Room's ID.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}},{"name":"deviceProfileId","in":"path","description":"The Zoom Room device profile's ID.","required":true,"schema":{"type":"string","example":"pwkZtOnUSIqY7PbWxbH4IA"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` **OK**  \n \nDevice profile returned.","content":{"application/json":{"schema":{"type":"object","properties":{"audio_processing":{"type":"boolean","description":"Whether audio processing is enabled.","example":false},"auto_adjust_mic_level":{"type":"boolean","description":"Whether microphone level auto adjust is enabled.","example":true},"camera_id":{"type":"string","description":"The camera's device ID.","example":"usb#vid_0bda&pid_58fd&mi_00#6&1e7cbc97&0&0000#{65e8773d-8f56-11d0-a3b9-00a0c9223196}global"},"echo_cancellation":{"type":"boolean","description":"Whether echo cancellation is enabled.","example":true},"id":{"type":"string","description":"The device's profile ID.","example":"Gz_fNcaSPByng-3vsqv_iQ"},"microphone_id":{"type":"string","description":"The microphone's device ID.","example":"{0.0.2.00000000}.{eff76572-ac52-4c79-bd30-67f968bjb15f}"},"name":{"type":"string","description":"The device profile's name.","example":"ZR1 Device"},"noise_suppression":{"type":"string","description":"The noise suppression setting: \n* `moderate` &mdash; Moderate noise suppression. \n* `aggressive` &mdash; Aggressive noise suppression. \n* `none` &mdash; Noise suppression disabled.","example":"aggressive","enum":["moderate","aggressive","none"]},"speaker_id":{"type":"string","description":"The speaker's device ID.","example":"{0.0.0.00000000}.{4f9b30cb-872e-49ed-a1b9-a7ec352bf3e6}"}},"description":"The information about the Zoom Room's device profile."}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `200` <br>\n * Zoom Room subscription not found. Purchase a Zoom Room subscription and try again. <br>\n* Access restricted. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `1012` <br>\n Room does not exist: {roomId}. <br>\n**Error Code:** `8005` <br>\n Zoom Room device profile does not exist: {roomId}. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:read:admin","room:write:admin","zoom_rooms:read:device_profile:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["ZoomRooms:Read"],"x-macro-scopes":["room:read:admin","room:write:admin"],"x-granular-scopes":["zoom_rooms:read:device_profile:admin"]}},"delete":{"tags":["Zoom Rooms"],"summary":"Delete a device profile","description":"Deletes a Zoom Room device profile.  **Prerequisites:** * A Pro or a higher account with Zoom Rooms.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:delete:device_profile:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"deleteRoomProfile","parameters":[{"name":"roomId","in":"path","description":"The Zoom Room's ID.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}},{"name":"deviceProfileId","in":"path","description":"The Zoom Room device profile's ID.","required":true,"schema":{"type":"string","example":"pwkZtOnUSIqY7PbWxbH4IA"}}],"responses":{"204":{"description":"**HTTP Status Code:** `204` **No Content**  \n \nDevice profile deleted."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `200` <br>\n * Zoom Room subscription not found. Purchase a Zoom Room subscription and try again. <br>\n* Access restricted. <br>\n**Error Code:** `300` <br>\n You cannot delete this device profile. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `1012` <br>\n Room does not exist: {roomId}. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:delete:device_profile:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:delete:device_profile:admin"]}},"patch":{"tags":["Zoom Rooms"],"summary":"Update a device profile","description":"Updates a Zoom Room device profile.  **Prerequisites:** * A Pro or a higher account with Zoom Rooms.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:update:device_profile:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"updateDeviceProfile","parameters":[{"name":"roomId","in":"path","description":"The Zoom Room's ID.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}},{"name":"deviceProfileId","in":"path","description":"The Zoom Room device profile's ID.","required":true,"schema":{"type":"string","example":"pwkZtOnUSIqY7PbWxbH4IA"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"audio_processing":{"type":"boolean","description":"Whether to enable audio processing.","example":false},"auto_adjust_mic_level":{"type":"boolean","description":"Whether to enable microphone level auto adjust.","example":true},"camera_id":{"type":"string","description":"The camera's device ID.","example":"usb#vid_0bda&pid_58fd&mi_00#6&1e7cbc97&0&0000#{65e8773d-8f56-11d0-a3b9-00a0c9223196}global"},"echo_cancellation":{"type":"boolean","description":"Whether to enable echo cancellation.","example":true},"microphone_id":{"type":"string","description":"The microphone's device ID.","example":"{0.0.2.00000000}.{eff76572-ac52-4c79-bd30-67f968bjb15f}"},"noise_suppression":{"type":"string","description":"The noise suppression setting: \n* `moderate` &mdash; Moderate noise suppression. \n* `aggressive` &mdash; Aggressive noise suppression. \n* `none` &mdash; Noise suppression disabled.","example":"none","enum":["moderate","aggressive","none"]},"speaker_id":{"type":"string","description":"The speaker's device ID.","example":"{0.0.0.00000000}.{4f9b30cb-872e-49ed-a1b9-a7ec352bf3e6}"}},"description":"Information about the Zoom Room device profile."}}}},"responses":{"204":{"description":"**HTTP Status Code:** `204` **No Content**  \n \nDevice profile updated."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `200` <br>\n * Zoom Room subscription not found. Purchase a Zoom Room subscription and try again. <br>\n* Access restricted. <br>\n**Error Code:** `300` <br>\n You cannot change this device profile. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `1012` <br>\n Room does not exist: {roomId}. <br>\n**Error Code:** `8005` <br>\n Room device profile does not exist: {roomId}. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:update:device_profile:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:update:device_profile:admin"]}}},"/rooms/{roomId}/devices":{"get":{"tags":["Zoom Rooms"],"summary":"List Zoom Room devices","description":"List information about the devices that are being used for a specific [Zoom Room](https://support.zoom.us/hc/en-us/articles/207483343-Getting-Started-with-Zoom-Rooms) in an account.\n\n**Prerequisites:**  \n \n* Pro or a higher plan with [Zoom Room](https://zoom.us/zoomrooms) license.  \n \n* Account owner or admin permissions.\n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:read:list_devices:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"listZRDevices","parameters":[{"name":"roomId","in":"path","description":"Unique Identifier of the Zoom Room. This can be retrieved from the response of [**List Zoom Rooms**](/docs/api-reference/zoom-api/methods#operation/listZoomRooms) API.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` **OK**\nDevices listed successfully.","content":{"application/json":{"schema":{"type":"object","properties":{"devices":{"type":"array","items":{"type":"object","properties":{"app_version":{"type":"string","description":"App version of Zoom Rooms.","example":"5.9.1 (2581)"},"device_system":{"type":"string","description":"Operating system of the device.","example":"Win10 Build 19043.1266"},"device_type":{"type":"string","description":"Type of the device. The value of this field can be one of the following:  \n `Zoom Rooms Computer`,  \n  `Controller`, `Scheduling Display`, `Zoom Rooms Control System`, `Companion Whiteboard`","example":"Controller","enum":["Zoom Rooms Computer","Controller","Scheduling Display","Zoom Rooms Control System","Companion Whiteboard"]},"id":{"type":"string","description":"Unique identifier of the device.","example":"{0.0.1.00000000}.{eff76542-ac52-4c78-bd90-67f968bab16f}"},"room_name":{"type":"string","description":"Name of the Zoom Room.","example":"My Room"},"status":{"type":"string","description":"Status of the device. The value can be either `Online` or `Offline`.","example":"Online","enum":["Online","Offline"]},"device_mac_addresses":{"type":"array","description":"Array of device mac addresses","example":["01-23-45-67-89-AB"],"items":{"type":"string","description":"Device mac address","example":"01-23-45-67-89-AB"}},"device_hostname":{"type":"string","description":"The device's name","example":"Test Computer"},"device_manufacturer":{"type":"string","description":"The device's manufacturer","example":"Poly"},"device_model":{"type":"string","description":"The device's model","example":"MacBookPro14,1"},"device_firmware":{"type":"string","description":"The device's firmware version","example":"1.1.1"},"ip_address":{"type":"string","description":"The device IP address.","example":"10.10.10.10"},"serial_number":{"type":"string","description":"The device serial number.","example":"6NRN2A0"}}}}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request \n\n **Error Code:** `200` <br>\n Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:read:admin","zoom_rooms:read:list_devices:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["ZoomRooms:Read"],"x-macro-scopes":["room:read:admin"],"x-granular-scopes":["zoom_rooms:read:list_devices:admin"]}}},"/rooms/{roomId}/location":{"put":{"tags":["Zoom Rooms"],"summary":"Change a Zoom Room's location","description":"An account owner of a Zoom account can establish a [Zoom Rooms Location Hierarchy](https://support.zoom.us/hc/en-us/articles/115000342983-Zoom-Rooms-Location-Hierarchy) to better organize Zoom Rooms spread across various locations. The location can be structured in a hierarchy with Country being the top-level location, followed by city, campus, building, and floor. Use this API to assign a new location for a Zoom Room. Note that the Zoom Room can be assigned only to the lowest level location available in the hierarchy.\n**Prerequisite:**  \n \n* Account owner or admin permission\n* Zoom Rooms version 4.0 or higher  \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:update:room_location:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"changeZRLocation","parameters":[{"name":"roomId","in":"path","description":"Unique Identifier of the Zoom Room.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"location_id":{"type":"string","description":"Location ID of the location where Zoom Room is to be assigned. This can be retrieved from the `id` property in the response of [**List Zoom Rooms locations**](/docs/api-reference/zoom-api/methods#operation/listZRLocations) API.","example":"49D7a0xPQvGQ2DCMZgSe7w"}}}}}},"responses":{"204":{"description":"**HTTP Status Code:** `204` **No Content**  \n \nLocation of the Zoom Room changed successfully."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request \n\n **Error Code:** `200` <br>\n Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found \n\n **Error Code:** `4801` <br>\n Location not found: {location_id} <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:update:room_location:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["ZoomRooms:Edit"],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:update:room_location:admin"]}}},"/rooms/{roomId}/sensor_data":{"get":{"tags":["Zoom Rooms"],"summary":"Get Zoom Room sensor data","description":"Retrieves the sensor data from the specified Zoom Room. \n\n   **Prerequisites** \n\n  * Zoom Room licenses\n  * Owner or Admin privileges on the Zoom Account.   \n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:read:sensor_data:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"getZRSensorData","parameters":[{"name":"roomId","in":"path","description":"Unique identifier of the Zoom Room. This can be retrieved from the response of the [**List Zoom Rooms**](https://developers.zoom.us/docs/api/rest/reference/zoom-rooms/methods/#operation/listZoomRooms) API.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}},{"name":"from","in":"query","description":"The start time and date in 'yyyy-MM-ddTHH:dd:ssZ' format.","required":true,"schema":{"type":"string","format":"datetime","example":"2022-06-19T00:00:00Z"}},{"name":"to","in":"query","description":"The end time and date in 'yyyy-MM-ddTHH:dd:ssZ' format.","required":true,"schema":{"type":"string","format":"datetime","example":"2022-06-19T00:00:00Z"}},{"name":"page_size","in":"query","description":"The number of records returned within a single API call.","required":false,"schema":{"maximum":300,"type":"integer","example":30,"default":30}},{"name":"next_page_token","in":"query","description":"Use the next page token to paginate through large result sets. A next page token is returned whenever the set of available results exceed the current page size. This token's expiration period is 15 minutes.","required":false,"schema":{"type":"string","example":"0JblM1ZHFIdXjAHefkYOfTdCw1Lq9H1urw2"}},{"name":"device_id","in":"query","required":false,"schema":{"type":"string","description":"The device ID.","example":"NiVvY1NWpE2nulNrhVjgU4jD0swziVrXBbaFZyC3u+o="}},{"name":"sensor_type","in":"query","required":false,"schema":{"type":"string","example":"CO2","enum":["CO2","TEMPERATURE","REAL_TIME_PEOPLE_COUNT","HUMIDITY","VOC","PM25","PM10","AIR_PRESSURE","AQI"]}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` **OK**  \n \nZoom Room settings returned successfully.","content":{"application/json":{"schema":{"required":["from","next_page_token","page_size","sensor_data","to","total_records"],"type":"object","properties":{"from":{"type":"string","description":"The start date in the query.","format":"datetime","example":"2022-06-19T00:00:00Z"},"to":{"type":"string","description":"The end date in the query.","format":"datetime","example":"2022-06-19T00:00:00Z"},"next_page_token":{"type":"string","description":"The next page token is used to paginate through large result sets. A next page token will be returned whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes.","example":"R4aF9Oj0fVM2hhezJTEmSKaBSkfesDwGy42"},"page_size":{"maximum":300,"type":"integer","description":"The number of records returned within a single API call.","example":30},"total_records":{"type":"integer","description":"The total number of all the records available across pages.","example":5},"sensor_data":{"type":"array","description":"The data from the Zoom Room sensor.","items":{"required":["date_time","device_id","sensor_type","sensor_value"],"type":"object","properties":{"date_time":{"type":"string","description":"The time when the sensor data is reported.","format":"datetime","example":"2022-06-19T00:00:00Z"},"device_id":{"type":"string","description":"The device ID.","example":"NiVvY1NWpE2nulNrhVjgU4jD0swziVrXBbaFZyC3u+o="},"sensor_type":{"type":"string","description":"The sensor type.","example":"CO2","enum":["CO2","TEMPERATURE","REAL_TIME_PEOPLE_COUNT","HUMIDITY","VOC","PM25","PM10","AIR_PRESSURE","AQI"]},"sensor_value":{"type":"string","description":"The values from the sensor.","example":"102.0"}}}}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `200` <br>\n Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription.<br>\n**Access restricted**. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `1012` <br>\n Room not found:{roomId}. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:read:admin","zoom_rooms:read:sensor_data:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["room:read:admin"],"x-granular-scopes":["zoom_rooms:read:sensor_data:admin"]}}},"/rooms/{roomId}/virtual_controller":{"get":{"tags":["Zoom Rooms"],"summary":"Get Zoom Rooms virtual controller URL","description":"Get the Zoom Rooms virtual controller URL. \n\n**Prerequisites:**  \n* Pro or a higher plan with [Zoom Room](https://zoom.us/zoomrooms) license.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:read:virtual_controller:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"getWebzrcUrl","parameters":[{"name":"roomId","in":"path","description":"The unique identifier of the Zoom Room. This can be retrieved from the response of the List Zoom Rooms API.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}},{"name":"pre_authenticated_link","in":"query","description":"If true, the URL for the virtual controller will contain a time-limited authentication token (10 minute lifetime) that will permit to the virtual controller without requiring login to Zoom admin portal.  Default is false.","required":false,"schema":{"type":"boolean","example":false}}],"responses":{"200":{"description":"**HTTP Status Code:** `200`**OK** Zoom Rooms virtual controller URL returned successfully.","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","description":"The Zoom Rooms virtual controller URL.","example":"https://zoom.us/launch/webzrc?nodeId=SnoDt6rcTqi7HIuFZsib9A"},"expire_in":{"type":"integer","description":"Expiry time of a pre-authenticated link in seconds.","example":600}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `300520003` <br>\n Check Zoom Room error. Failed to launch Zoom Rooms virtual controller. <br>\n"},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n **Error Code:** `300520001` <br>\n User not logged in. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `300520002` <br>\n No Zoom Rooms found. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:read:admin","zoom_rooms:read:virtual_controller:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["ZRWebController:Edit"],"x-macro-scopes":["room:read:admin"],"x-granular-scopes":["zoom_rooms:read:virtual_controller:admin"]}}},"/rooms/account_profile":{"get":{"tags":["Zoom Rooms Account"],"summary":"Get Zoom Room account profile","description":"Get details on the account profile of a Zoom Room. This information can only by accessed either by the Zoom Room Account Owner or a user with Zoom Rooms admin permission. To get information on an individual room profile, use the [**Get Zoom Room profile**](/docs/api-reference/zoom-api/methods#operation/getZRProfile) API. \n\n**Prerequisites:**  \n \n* Zoom account owner or Zoom Rooms admin permissions.  \n \n\n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:read:account_profile:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"getZRAccountProfile","responses":{"200":{"description":"**HTTP Status Code:** `200` **OK**  \n \nZoom Room Account Profile returned successfully.","content":{"application/json":{"schema":{"type":"object","properties":{"basic":{"type":"object","properties":{"required_code_to_ext":{"type":"boolean","description":"The required code to exit out of the Zoom Rooms application to switch between other apps.\n","example":true},"room_passcode":{"maxLength":16,"minLength":1,"type":"string","description":"The 1-16 digit number or characters used to secure your Zoom Rooms application. This code must be entered on your Zoom Room Controller to change settings or to sign out.","example":"111111"},"support_email":{"type":"string","description":"The email address used for reporting Zoom Room issues.","format":"email","example":"contact-it@example.com"},"support_phone":{"type":"string","description":"The phone number used for reporting Zoom Room issues.","example":"18798769876"}}},"setup":{"type":"object","properties":{"apply_background_image_to_all_displays":{"type":"boolean","description":"Apply the same background image to all displays of the Zoom Room. If the value of the this field is true, the `background_image_info` object will only contain and only accept changes to the background image information of `zoom_rooms_display1`.","example":true},"background_image_info":{"type":"array","description":"The background image information for each display. If the value of the `apply_background_image_to_all_displays` field is `true`, this object will only accept changes to the background image information of `zoom_rooms_display1`.","items":{"type":"object","properties":{"display_id":{"type":"string","description":"The id of the display. The value can be one of the following:  \n \n`zoom_rooms_display1`: The display1 of the Zoom Room.  \n \n`zoom_rooms_display2`: The display2 of the Zoom Room.  \n \n`zoom_rooms_display3`: The display3 of the Zoom Room. \n \n`zoom_rooms_display4`: The display4 of the Zoom Room. \n \n`companion_whiteboard`: The display of the Companion Whiteboard. \n \n`companion_zoom_rooms`: The display of the Companion Zoom Room.\n","example":"zoom_rooms_display1","enum":["zoom_rooms_display1","zoom_rooms_display2","zoom_rooms_display3","zoom_rooms_display4","companion_whiteboard","companion_zoom_rooms"]},"content_id":{"type":"string","description":"When the background image is a [background image library content item](https://developers.zoom.us/docs/api/rest/reference/zoom-rooms/methods/#operation/ListZoomRoomsbackgroundimagelibrarycontents) or [default Zoom Rooms background image library content item](https://developers.zoom.us/docs/api/rest/reference/zoom-rooms/methods/#operation/ListDefaultZoomRoomsBackgroundImageLibrarycontents), this field will contain the `content_id`. When a background image has been directly uploaded, this field will be empty.\"","example":"zrd9DycNSxK6K4dEUS6z-g"},"download_url":{"type":"string","description":"The URL where the background image file may be downloaded. This URL will be expire according to the `download_url_ttl`.","example":"https://zoom.us/file/Sq2mdxqRQ9eq7wmD5TFD6g?jwt=eyJ0eXAiOiJKV1QiLCJrIjoiaHRlNU05dDciLCJ6bV9za20iOiJ6bV9vMm0iLCJhbGc"},"download_url_ttl":{"type":"integer","description":"The time to live of the download URL, in seconds. When this field is not present, the link will never expire.","example":3600}}}}}}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `200` <br>\n Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription.<br>\nAccess restricted. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:read:admin","zoom_rooms:read:account_profile:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["room:read:admin"],"x-granular-scopes":["zoom_rooms:read:account_profile:admin"]}},"patch":{"tags":["Zoom Rooms Account"],"summary":"Update Zoom Room account profile","description":"Update information on the account profile of a Zoom Room. This information can only by accessed either by the Zoom Room Account Owner or a user with Zoom Rooms admin permission. To update information on an individual room profile, use the [**Update a Zoom Room profile**](/docs/api-reference/zoom-api/methods#operation/updateRoomProfile) API. \n\n**Prerequisites:**  \n \n* Zoom account owner or Zoom Rooms admin permissions.  \n \n\n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:update:account_profile:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"updateZRAccProfile","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"basic":{"type":"object","properties":{"required_code_to_ext":{"type":"boolean","description":"The required code to exit out of the Zoom Rooms application to switch between other apps.\n","example":true},"room_passcode":{"maxLength":16,"minLength":1,"type":"string","description":"The 1-16 digit number or characters used to secure your Zoom Rooms application. This code must be entered on your Zoom Room Controller to change settings or to sign out.","example":"975193018"},"support_email":{"type":"string","description":"The email address used for reporting Zoom Room issues.","format":"email","example":"contact-it@example.com"},"support_phone":{"type":"string","description":"The phone number used for reporting Zoom Room issues.","example":"18798769876"}}},"setup":{"type":"object","properties":{"apply_background_image_to_all_displays":{"type":"boolean","description":"Apply the same background image to all displays of the Zoom Room. If the value of the this field is `true`, the `background_image_info` object will only contain and only accept changes to the background image information of `zoom_rooms_display1`.","example":true},"background_image_info":{"type":"array","description":"The background image information for each display. If the value of the `apply_background_image_to_all_displays` field is `true`, this object will only accept changes to the background image information of `zoom_rooms_display1`.","items":{"type":"object","properties":{"display_id":{"type":"string","description":"The id of the display. The value can be one of the following:  \n \n`zoom_rooms_display1`: The display1 of the Zoom Room.  \n \n`zoom_rooms_display2`: The display2 of the Zoom Room.  \n \n`zoom_rooms_display3`: The display3 of the Zoom Room. \n \n`zoom_rooms_display4`: The display4 of the Zoom Room. \n \n`companion_whiteboard`: The display of the Companion Whiteboard. \n \n`companion_zoom_rooms`: The display of the Companion Zoom Room.\n","example":"zoom_rooms_display1","enum":["zoom_rooms_display1","zoom_rooms_display2","zoom_rooms_display3","zoom_rooms_display4","companion_whiteboard","companion_zoom_rooms"]},"content_id":{"type":"string","description":"To set the background image to a [background image library content item](https://developers.zoom.us/docs/api/rest/reference/zoom-rooms/methods/#operation/ListZoomRoomsbackgroundimagelibrarycontents) or [default Zoom Rooms background image library content item](https://developers.zoom.us/docs/api/rest/reference/zoom-rooms/methods/#operation/ListDefaultZoomRoomsBackgroundImageLibrarycontents), set this field to a background image library content item's `content_id`. To reset the background, set the content_id to an empty string.","example":"LHMmOOYaRiOA5m5WZjXVPA"}}}}}}}}}}},"responses":{"204":{"description":"**HTTP Status Code:** `204` **No Content**  \n \nProfile updated successfully."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `200` <br>\n Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription.<br>\n**Access restricted**. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:update:account_profile:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:update:account_profile:admin"]}}},"/rooms/account_settings":{"get":{"tags":["Zoom Rooms Account"],"summary":"Get Zoom Room account settings","description":"Get details on Account Settings of a Zoom Room. With this API, you can view the **Account Meeting Settings**, **Alert Settings** (Client Alert Settings and Notification Settings), **Digital Signage Settings** or **Scheduling Display Settings** of the Zoom Rooms account. By default, only **Account Meeting Settings** are returned. To view only **Alert Settings**, specify `alert` as the value of the `setting_type` query parameter.  \n   \n \n**Prerequisites:**  \n \n* Zoom Room licenses.\n* Owner or Admin privileges on the Zoom Account.  \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:read:account_settings:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"getZRAccountSettings","parameters":[{"name":"setting_type","in":"query","description":"The type of setting that you would like to retrieve.\n\n`alert`: Alert settings of the Zoom Rooms Account.\n \n`meeting`: Meeting settings of the Zoom Rooms Account.\n \n`signage`: Digital Signage settings of the Zoom Rooms Account.\n\n`scheduling_display`: Scheduling Display settings of the Zoom Rooms Account.","required":true,"schema":{"type":"string","example":"meeting","default":"meeting","enum":["meeting","alert","signage","scheduling_display"]}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` **OK**  \n \nZR Account Settings returned successfully.\n","content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"zoom_rooms":{"type":"object","properties":{"allow_multiple_content_sharing":{"type":"boolean","description":"Enable multiple participants to [share content simultaneously](https://support.zoom.us/hc/en-us/articles/360017767812-Sharing-Multiple-Screens-in-a-Zoom-Room) by default.","example":true},"audio_device_daily_auto_test":{"type":"boolean","description":"Enable [automated audio test](https://support.zoom.us/hc/en-us/articles/360000319683-Zoom-Rooms-Daily-Audio-Testing) to ensure high quality audio.","example":true},"auto_direct_sharing":{"type":"boolean","description":"Enable participants in a Zoom Room to share their laptop screen on the Zoom Room TV without entering a meeting ID or sharing code.","example":true},"auto_start_scheduled_meeting":{"type":"boolean","description":"Automatically start scheduled meetings according to the start time listed on the calendar associated with the room. A meeting alert will appear 10 minutes prior to the scheduled time on the TV.","example":true},"auto_stop_scheduled_meeting":{"type":"boolean","description":"Automatically stop the meeting at the end time as scheduled and listed in the calendar associated with the room. ","example":true},"count_attendees_number_in_room":{"type":"boolean","description":"Use facial detection technology to [determine and display the attendees count](https://support.zoom.us/hc/en-us/articles/360031027111-Count-Attendees-in-Zoom-Rooms) after meetings on Dashboard.\n","example":true},"display_feedback_survey":{"type":"boolean","description":"Display a [survey](https://support.zoom.us/hc/en-us/articles/214193146-End-of-Meeting-Attendee-Feedback) at the end of each meeting regarding the audio and video quality on the Zoom Rooms Controller.","example":true},"display_meeting_list":{"type":"boolean","description":" Show the same information on the TV that is shown on the controller.","example":true},"display_top_banner":{"type":"boolean","description":"Allow to display room name, time and sharing key on the top portion of TV.","example":true},"email_address_prompt_before_recording":{"type":"boolean","description":"Allow in-room participants to input email address where they can receive the recording before starting a recording if the meeting was created on the Scheduling Display or if it was started using the &quot;Meet Now&quot; option.","example":true},"encrypt_shared_screen_content":{"type":"boolean","description":"Encrypt screen and content shared in meetings.","example":true},"hide_id_for_private_meeting":{"type":"boolean","description":"If enabled, the meeting host and meeting ID (in addition to the meeting topic) are hidden from the Zoom Rooms display for private meetings. This affects meetings that were originally scheduled as private, as well as public meetings that were transformed to private.","example":true},"make_room_alternative_host":{"type":"boolean","description":"Set [Zoom Rooms as the alternative host](https://support.zoom.us/hc/en-us/articles/203614149-Zoom-Rooms-as-Alternative-Host).\n","example":true},"secure_connection_channel":{"type":"boolean","description":"Enable secure connection between Zoom Rooms computer and controller.","example":true},"send_whiteboard_to_internal_contact_only":{"type":"boolean","description":"Restrict[ sending Whiteboard sessions](https://support.zoom.us/hc/en-us/articles/115004797286-Using-the-Whiteboard-in-Zoom-Rooms-for-Touch#h_781274b3-5237-4320-8826-be2120b00e21) to contacts or internal users only.","example":true},"show_alert_before_meeting":{"type":"boolean","description":"If enabled, the upcoming meeting alert message will be shown on the TV display. The value of the `upcoming_meeting_alert` field should be set to `true` to use this field. ","example":true},"show_call_history_in_room":{"type":"boolean","description":"Allow users to see call history of joined meetings and phone calls from the Zoom Rooms controller.\n","example":true},"show_contact_list_on_controller":{"type":"boolean","description":"If enabled, you can invite participants from the contact list during a meeting or when starting a meeting","example":true},"show_non_video_participants":{"type":"boolean","description":"When enabled, meeting participants that are audio only or have their video turned off will also be shown on the Zoom Rooms display by default.","example":true},"start_airplay_manually":{"type":"boolean","description":"Require the AirPlay service to be [started by an administrator](https://support.zoom.us/hc/en-us/articles/204726885-Screen-Share-Using-Airplay-Mirroring#h_a342ad38-4e46-47a8-a1d9-cded3b144b39) rather than always being available.","example":true},"start_airplay_mirroring":{"type":"boolean","description":"Allow users to share content via Apple Screen Mirroring (called Airplay on iOS 11 or earlier) in Zoom Rooms","example":true},"support_join_3rd_party_meeting":{"type":"boolean","description":"Integrate with Skype for Business, GoToMeeting, or WebEx and show the meeting dial-in button on the meeting list tab for Zoom Rooms Controllers.","example":true},"transform_meeting_to_private":{"type":"boolean","description":"If enabled, all meetings in this room will be treated as [private meetings](https://support.zoom.us/hc/en-us/articles/115001051063-Zoom-Rooms-Private-Meetings), and the Zoom Room will display &quot;Your Name's Meeting&quot; instead of the real meeting topic.","example":true},"upcoming_meeting_alert":{"type":"boolean","description":"If enabled, a reminder will display 10 minutes prior to the next scheduled meeting on the controller.","example":true},"weekly_system_restart":{"type":"boolean","description":"[Restart](https://support.zoom.us/hc/en-us/articles/205418949-Zoom-Rooms-Weekly-System-Restart) the Zoom Rooms computer and controller once a week.","example":true}}}}},{"type":"object","properties":{"client_alert":{"type":"object","properties":{"detect_bluetooth_microphone_error_alert":{"type":"boolean","description":"Display an alert message when an issue is detected with a bluetooth microphone.","example":true},"detect_bluetooth_speaker_error_alert":{"type":"boolean","description":"Display an alert message when an issue is detected with a bluetooth speaker.","example":true},"detect_camera_error_alert":{"type":"boolean","description":"Display an alert message when an issue is detected with a camera.","example":true},"detect_microphone_error_alert":{"type":"boolean","description":"Display an alert message when an issue is detected with microphone.","example":true},"detect_speaker_error_alert":{"type":"boolean","description":"Display an alert message when an issue is detected with a speaker.","example":true},"cpu_usage_high_detected_notification_on_zr_display":{"type":"boolean","description":"Display a notification message on the Zoom Room display when CPU usage is above 90%.","example":true},"network_unstable_detected_notification_on_zr_display":{"type":"boolean","description":"Display a notification message on the Zoom Room display low bandwidth network is detected","example":true}},"description":"The Client Alert Settings section includes alerts that display on the TV screen of the Zoom Room. Disable these settings if you have deliberately disconnected one or more peripheral devices or have never enabled them. "},"digital_signage":{"type":"object","properties":{"banner":{"type":"object","properties":{"banner_room_name":{"type":"boolean","description":"Display or hide banner room name.","example":true},"banner_sharing_key":{"type":"boolean","description":"Display or hide banner sharing key.","example":true},"banner_time":{"type":"boolean","description":"Display or hide time in the banner.","example":true}},"description":"Specifies the elements that you want to display in the top banner."},"display_period":{"type":"object","properties":{"start_displaying_content":{"type":"integer","description":"Start displaying digital signage content after certain duration after the meeting ends. The value of this field indicates the duration in minutes.","example":1},"stop_displaying_content":{"type":"integer","description":"Stop displaying content {certain_duration} before a meeting is scheduled to begin. The value of this field indicates the duration in minutes.","example":1}},"description":"Display period object lets you define the number of minutes before or after the scheduled meeting time you would like the content to display."},"enable_digital_signage":{"type":"boolean","description":"[Indicates whether digital signage is on or off,](https://support.zoom.us/hc/en-us/articles/360000030683-Zoom-Rooms-digital-signage#h_767fbb33-82a8-45a8-8392-a1bfa9687edd).   \n \n`true`: enable  \n  `false`: disable","example":true},"layout":{"type":"string","description":"Set the [layout](https://support.zoom.us/hc/en-us/articles/360000030683-Zoom-Rooms-digital-signage#h_4e25ddf3-8f97-4957-8f8b-99725f940fa7). The value of this field can be either `standard` or `video_content`.\n\n`standard`: Standard Center  \n \n`video_content`: Video + Content","example":"true"},"mute":{"type":"boolean","description":"Sound of all contents will be muted if the value of this field is set to `true`.","example":true},"play_list":{"maxItems":2,"type":"array","description":"Content list.","items":{"type":"object","properties":{"action":{"type":"string","description":"Specify an action for the content list. The value can be one of the following:  \n \n`add`: Add another content list.  \n \n`update`: Update existing content list.  \n \n`delete`: Delete content list.\n","example":"add","enum":["add","update","delete"]},"contents":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"content_id":{"type":"string","description":"Content Id.","example":"blKfsfQ-QSW7V_LPjZrIdg"},"duration":{"type":"integer","description":"Duration for how long the content will be displayed.","example":65},"id":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"},"name":{"type":"string","description":"Name of the content.","example":"content name"},"order":{"type":"integer","description":"Order of the content in the display.","example":1}},"description":"Content list."}},"end_time":{"type":"string","description":"Specify the display end time for the content list in GMT.","example":"2021-03-18T05:41:36Z"},"id":{"type":"string","description":"Unique identifier of the content list. This field is only required if you would like to remove or update the content list.","example":"blKfsfQ-QSW7V_LPjZrIdg"},"name":{"type":"string","description":"Name of the content list.","example":"content list"},"start_time":{"type":"string","description":"Specify the display start time for the content list in GMT.","example":"2021-03-18T05:41:36Z"}}}}}},"notification":{"type":"object","properties":{"audio_meet_usability_threshold":{"type":"boolean","description":"Send an alert when the audio echo test result meets usability threshold.","example":true},"audio_not_meet_usability_threshold":{"type":"boolean","description":"Send an alert when the audio echo test result does not meet usability threshold.","example":true},"battery_is_charging":{"type":"boolean","description":"Send an alert when the battery starts charging.","example":true},"battery_low_and_not_charging":{"type":"boolean","description":"Send an alert when the battery of the controller or the scheduling display is low (at 20%) and is not being charged.","example":true},"battery_percentage":{"type":"string","description":"Specify a percentage so that an alert is sent when the battery is less than the {battery_percentage} that you specified.","example":"90"},"controller_scheduling_disconnected":{"type":"boolean","description":"Send an alert when the connection to the Controller or Scheduling Display cannot be detected.","example":true},"controller_scheduling_reconnected":{"type":"boolean","description":"Send an alert when the Controller or Scheduling Display can be detected again.","example":true},"cpu_usage_high_detected":{"type":"boolean","description":"Send an alert when CPU usage is above 90%.","example":true},"mic_speaker_camera_disconnected":{"type":"boolean","description":"Send an alert when the mic, speaker or camera is disconnected in the Zoom Room.","example":true},"mic_speaker_camera_reconnected":{"type":"boolean","description":"Send an alert when the mic, speaker or camera is reconnected.","example":true},"network_unstable_detected":{"type":"boolean","description":"Send an alert when low bandwidth network is detected","example":true},"sip_registration_failed":{"type":"boolean","description":"Send an alert when SIP registration stops working. ","example":true},"sip_registration_re_enabled":{"type":"boolean","description":"Send an alert after the SIP registration is re-enabled.","example":true},"zoom_room_come_back_online":{"type":"boolean","description":"Send an alert when the Zoom Room is online after previously being offline.","example":true},"zoom_room_display_disconnected":{"type":"boolean","description":"Send an alert when the TV display is disconnected","example":true},"zoom_room_offline":{"type":"boolean","description":"Send an alert when the machine hosting the Zoom Room application has a network issue or cannot connect with the Controller.","example":true}},"description":"[Notifications Settings](https://support.zoom.us/hc/en-us/articles/205394099-Zoom-Room-Alerts#h_b430b5f2-5150-4522-9c96-c77f22ab70bc) includes the circumstances in which the room sends an email alert to the support team to notify them of a potentially urgent issue. These issues can affect the operation of the room, but do not display on the TV screen. The email alert is sent to the email address specified in the Notification Email Recipients section. "},"scheduling_display":{"type":"object","properties":{"instant_room_reservation":{"type":"boolean","description":"If enabled, the Zoom Room Scheduling Display will allow a user to perform an instant room reservation on the device.","example":true},"reserve_other_rooms":{"type":"object","properties":{"allow_to_reserve_other_rooms":{"type":"boolean","description":"If enabled, the Zoom Room Scheduling Display will allow a user to perform instant room reservations of other rooms on the device.","example":true},"location_types":{"type":"string","description":"The Zoom Room Scheduling Display will allow a user to find other rooms to reserve in the same parent Zoom Rooms Location Hierarchy Location as this device, and higher Location levels if so configured. Use the API [Get Zoom Room Location Structure](https://developers.zoom.us/docs/api/rest/reference/zoom-rooms/methods/#operation/getZRLocationStructure) to determine valid Location levels.","example":"floor","enum":["city","campus","building","floor"]}},"description":"Contains settings that allows Zoom Room Scheduling Display to reserve other Zoom Rooms."},"set_scheduling_display_background_image_to_zoom_room_background":{"type":"boolean","description":"If enabled, the Zoom Room Scheduling Display will use the same background image as the Zoom Room. Note: Some Zoom Rooms Scheduling displays use a different display aspect ratio than standard 16:9; the background image will be scaled to fit the Scheduling Display's display, with any excess cropped.","example":true},"home_screen_theme":{"type":"string","description":"The Zoom Room Scheduling Display UI theme.","example":"compact","enum":["standard","compact"]},"home_screen_qr_code_url":{"type":"string","description":"If the Zoom Rooms Scheduling Display home screen theme is \"compact\", a space is reserved for a QR code to be displayed. You may optionally provide a URL which Zoom will use to automatically generate the corresponding QR code image. If you provide a URL that exceeds 100 characters in total length, Zoom will automatically use the Zoom URL shortening service to generate a shortened URL that will redirect to your actual URL; the URL is shortened to increase QR code scan reliability. This setting has no effect if the home screen theme is \"standard\".","example":"https://example.com"},"home_screen_qr_code_supporting_text":{"type":"string","description":"If the Zoom Rooms Scheduling Display home screen theme is \"compact\", a space is reserved for additional text to appear adjacent to the space reserved for a QR code. This setting has no effect if the home screen theme is \"standard\".","example":"Scan to reserve"}},"description":"Scheduling Display Settings section includes performing Zoom Room reservations and setting the home screen theme on the Scheduling Display device."}}}]}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request \n\n **Error Code:** `200` <br>\n Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription.<br>\nAccess restricted. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:read:admin","zoom_rooms:read:account_settings:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["ZoomRooms:Read"],"x-macro-scopes":["room:read:admin"],"x-granular-scopes":["zoom_rooms:read:account_settings:admin"]}},"patch":{"tags":["Zoom Rooms Account"],"summary":"Update Zoom Room account settings","description":"Update account settings applied for Zoom Rooms in a Zoom account. With this API, you can update the **Account Meeting Settings**, **Alert Settings** (Client Alert Settings and Notification Settings), **Digital Signage Settings** or **Scheduling Display Settings** of the Zoom Rooms account by specifying the required setting type in the `setting_type` parameter. To update only **Alert Settings**, specify `alert` as the value of the `setting_type` query parameter and to update only **Account Meeting Settings**, specify `meeting` as the value of the `setting_type` query parameter.  \n   \n \n**Prerequisites:**  \n \n* Zoom Room licenses\n* Owner or Admin privileges on the Zoom Account.  \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:update:account_settings:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"updateZoomRoomAccSettings","parameters":[{"name":"setting_type","in":"query","description":"The type of setting that you would like to update.  \n\n`alert`: Alert settings of the Zoom Rooms Account.\n \n`meeting`: Meeting settings of the Zoom Rooms Account.\n \n`signage`: Digital Signage settings of the Zoom Rooms Account.\n\n`scheduling_display`: Scheduling Display settings of the Zoom Rooms Account.","required":true,"schema":{"type":"string","example":"meeting","default":"meeting"}}],"requestBody":{"content":{"application/json":{"schema":{"oneOf":[{"type":"object","properties":{"zoom_rooms":{"type":"object","properties":{"allow_multiple_content_sharing":{"type":"boolean","description":"Enable multiple participants to [share content simultaneously](https://support.zoom.us/hc/en-us/articles/360017767812-Sharing-Multiple-Screens-in-a-Zoom-Room) by default.","example":true},"audio_device_daily_auto_test":{"type":"boolean","description":"Enable [automated audio test](https://support.zoom.us/hc/en-us/articles/360000319683-Zoom-Rooms-Daily-Audio-Testing) to ensure high quality audio.","example":true},"auto_direct_sharing":{"type":"boolean","description":"Enable participants in a Zoom Room to share their laptop screen on the Zoom Room TV without entering a meeting ID or sharing code.","example":true},"auto_start_scheduled_meeting":{"type":"boolean","description":"Automatically start scheduled meetings according to the start time listed on the calendar associated with the room. A meeting alert will appear 10 minutes prior to the scheduled time on the TV.","example":true},"auto_stop_scheduled_meeting":{"type":"boolean","description":"Automatically stop the meeting at the end time as scheduled and listed in the calendar associated with the room. ","example":true},"count_attendees_number_in_room":{"type":"boolean","description":"Use facial detection technology to [determine and display the attendees count](https://support.zoom.us/hc/en-us/articles/360031027111-Count-Attendees-in-Zoom-Rooms) after meetings on Dashboard.\n","example":true},"display_feedback_survey":{"type":"boolean","description":"Display a [survey](https://support.zoom.us/hc/en-us/articles/214193146-End-of-Meeting-Attendee-Feedback) at the end of each meeting regarding the audio and video quality on the Zoom Rooms Controller.","example":true},"display_meeting_list":{"type":"boolean","description":" Show the same information on the TV that is shown on the controller.","example":true},"display_top_banner":{"type":"boolean","description":"Allow to display room name, time and sharing key on the top portion of TV.","example":true},"email_address_prompt_before_recording":{"type":"boolean","description":"Allow in-room participants to input email address where they can receive the recording before starting a recording if the meeting was created on the Scheduling Display or if it was started using the &quot;Meet Now&quot; option.","example":true},"encrypt_shared_screen_content":{"type":"boolean","description":"Encrypt screen and content shared in meetings.","example":true},"hide_id_for_private_meeting":{"type":"boolean","description":"If enabled, the meeting host and meeting ID (in addition to the meeting topic) are hidden from the Zoom Rooms display for private meetings. This affects meetings that were originally scheduled as private, as well as public meetings that were transformed to private.","example":true},"make_room_alternative_host":{"type":"boolean","description":"Set [Zoom Rooms as the alternative host](https://support.zoom.us/hc/en-us/articles/203614149-Zoom-Rooms-as-Alternative-Host).\n","example":true},"secure_connection_channel":{"type":"boolean","description":"Enable secure connection between Zoom Rooms computer and controller.","example":true},"send_whiteboard_to_internal_contact_only":{"type":"boolean","description":"Restrict[ sending Whiteboard sessions](https://support.zoom.us/hc/en-us/articles/115004797286-Using-the-Whiteboard-in-Zoom-Rooms-for-Touch#h_781274b3-5237-4320-8826-be2120b00e21) to contacts or internal users only.","example":true},"show_alert_before_meeting":{"type":"boolean","description":"If enabled, the upcoming meeting alert message will be shown on the TV display. The value of the `upcoming_meeting_alert` field should be set to `true` to use this field. ","example":true},"show_call_history_in_room":{"type":"boolean","description":"Allow users to see call history of joined meetings and phone calls from the Zoom Rooms controller.\n","example":true},"show_contact_list_on_controller":{"type":"boolean","description":"If enabled, you can invite participants from the contact list during a meeting or when starting a meeting","example":true},"show_non_video_participants":{"type":"boolean","description":"When enabled, meeting participants that are audio only or have their video turned off will also be shown on the Zoom Rooms display by default.","example":true},"start_airplay_manually":{"type":"boolean","description":"Require the AirPlay service to be [started by an administrator](https://support.zoom.us/hc/en-us/articles/204726885-Screen-Share-Using-Airplay-Mirroring#h_a342ad38-4e46-47a8-a1d9-cded3b144b39) rather than always being available.","example":true},"support_join_3rd_party_meeting":{"type":"boolean","description":"Integrate with Skype for Business, GoToMeeting, or WebEx and show the meeting dial-in button on the meeting list tab for Zoom Rooms Controllers.","example":true},"transform_meeting_to_private":{"type":"boolean","description":"If enabled, all meetings in this room will be treated as [private meetings](https://support.zoom.us/hc/en-us/articles/115001051063-Zoom-Rooms-Private-Meetings), and the Zoom Room will display &quot;Your Name's Meeting&quot; instead of the real meeting topic.","example":true},"upcoming_meeting_alert":{"type":"boolean","description":"If enabled, a reminder will display 10 minutes prior to the next scheduled meeting on the controller.","example":true},"weekly_system_restart":{"type":"boolean","description":"[Restart](https://support.zoom.us/hc/en-us/articles/205418949-Zoom-Rooms-Weekly-System-Restart) the Zoom Rooms computer and controller once a week.","example":true}}}}},{"type":"object","properties":{"client_alert":{"type":"object","properties":{"detect_bluetooth_microphone_error_alert":{"type":"boolean","description":"Display an alert message when an issue is detected with a bluetooth microphone.","example":true},"detect_bluetooth_speaker_error_alert":{"type":"boolean","description":"Display an alert message when an issue is detected with a bluetooth speaker.","example":true},"detect_camera_error_alert":{"type":"boolean","description":"Display an alert message when an issue is detected with a camera.","example":true},"detect_microphone_error_alert":{"type":"boolean","description":"Display an alert message when an issue is detected with microphone.","example":true},"detect_speaker_error_alert":{"type":"boolean","description":"Display an alert message when an issue is detected with a speaker.","example":true},"cpu_usage_high_detected_notification_on_zr_display":{"type":"boolean","description":"Display a notification message on the Zoom Room display when CPU usage is above 90%.","example":true},"network_unstable_detected_notification_on_zr_display":{"type":"boolean","description":"Display a notification message on the Zoom Room display low bandwidth network is detected","example":true}},"description":"The Client Alert Settings section includes alerts that display on the TV screen of the Zoom Room. Disable these settings if you have deliberately disconnected one or more peripheral devices or have never enabled them. "},"digital_signage":{"type":"object","properties":{"banner":{"type":"object","properties":{"banner_room_name":{"type":"boolean","example":true},"banner_sharing_key":{"type":"boolean","example":true},"banner_time":{"type":"boolean","example":true}}},"display_period":{"type":"object","properties":{"start_displaying_content":{"type":"integer","description":"Start displaying digital signage content after certain duration after the meeting ends. Specify the value of the duration in minutes in this field.","example":1},"stop_displaying_content":{"type":"integer","description":"Stop displaying content {certain_duration} before a meeting is scheduled to begin. Specify the value of duration in minutes in this field.","example":1}},"description":"Display period object lets you define the number of minutes before or after the scheduled meeting time you would like the content to display."},"enable_digital_signage":{"type":"boolean","description":"[Enable or disable digital signage](https://support.zoom.us/hc/en-us/articles/360000030683-Zoom-Rooms-digital-signage#h_767fbb33-82a8-45a8-8392-a1bfa9687edd).   \n \n`true`: enable  \n  `false`: disable","example":true},"layout":{"type":"string","description":"Set the [layout](https://support.zoom.us/hc/en-us/articles/360000030683-Zoom-Rooms-digital-signage#h_4e25ddf3-8f97-4957-8f8b-99725f940fa7). The value of this field can be either `standard` or `video_content`.\n\n`standard`: Standard Center  \n \n`video_content`: Video + Content","example":"standard"},"mute":{"type":"boolean","description":"Sound of all contents will be muted if the value of this field is set to `true`.","example":true},"play_list":{"maxItems":2,"type":"array","description":"Content list.","items":{"type":"object","properties":{"action":{"type":"string","description":"Specify an action for the content list. The value can be one of the following:  \n \n`add`: Add another content list.  \n \n`update`: Update existing content list.  \n \n`delete`: Delete content list.\n","example":"add","enum":["add","update","delete"]},"contents":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"action":{"type":"string","description":"Specify an action for the content in the content list. The value can be one of the following:  \n \n`add`: Add another content to the content list.  \n \n`update`: Update existing content's information in the content list.  \n \n`delete`: Delete content from the content list.\n\n","example":"add"},"content_id":{"type":"string","description":"Content Id.","example":"blKfsfQ-QSW7V_LPjZrIdg"},"duration":{"type":"integer","description":"By default each content is display for 5 seconds. Using this field, specify how long you would like to display the content.","example":65},"id":{"type":"string","description":"Unique identifier of the content. This field is only required if you would like to remove or update the content information.","example":"blKfsfQ-QSW7V_LPjZrIdg"},"name":{"type":"string","description":"Name of the content.","example":"name content"},"order":{"type":"integer","description":"Order of the content in the display.","example":1}},"description":"Content list."}},"end_time":{"type":"string","description":"Specify the display end time for the content list in GMT.","example":"2021-03-18T05:41:36Z"},"id":{"type":"string","description":"Unique identifier of the content list. This field is only required if you would like to remove or update the content list.","example":"blKfsfQ-QSW7V_LPjZrIdg"},"name":{"type":"string","description":"Name of the content list.","example":"content list"},"start_time":{"type":"string","description":"Specify the display start time for the content list in GMT.","example":"2021-03-18T05:41:36Z"}}}}}},"notification":{"type":"object","properties":{"audio_meet_usability_threshold":{"type":"boolean","description":"Send an alert when the audio echo test result meets usability threshold.","example":true},"audio_not_meet_usability_threshold":{"type":"boolean","description":"Send an alert when the audio echo test result does not meet usability threshold.","example":true},"battery_is_charging":{"type":"boolean","description":"Send an alert when the battery starts charging.","example":true},"battery_low_and_not_charging":{"type":"boolean","description":"Send an alert when the battery of the controller or the scheduling display is low (at 20%) and is not being charged.","example":true},"battery_percentage":{"type":"string","description":"Specify a percentage so that an alert is sent when the battery is less than the {battery_percentage} that you specified.","example":"90"},"controller_scheduling_disconnected":{"type":"boolean","description":"Send an alert when the connection to the Controller or Scheduling Display cannot be detected.","example":true},"controller_scheduling_reconnected":{"type":"boolean","description":"Send an alert when the Controller or Scheduling Display can be detected again.","example":true},"cpu_usage_high_detected":{"type":"boolean","description":"Send an alert when CPU usage is above 90%.","example":true},"mic_speaker_camera_disconnected":{"type":"boolean","description":"Send an alert when the mic, speaker or camera is disconnected in the Zoom Room.","example":true},"mic_speaker_camera_reconnected":{"type":"boolean","description":"Send an alert when the mic, speaker or camera is reconnected.","example":true},"network_stable_detected":{"type":"boolean","description":"Send an alert when the network is stable.","example":true},"network_unstable_detected":{"type":"boolean","description":"Send an alert when low bandwidth network is detected","example":true},"sip_registration_failed":{"type":"boolean","description":"Send an alert when SIP registration stops working. ","example":true},"sip_registration_re_enabled":{"type":"boolean","description":"Send an alert after the SIP registration is re-enabled.","example":true},"zoom_room_come_back_online":{"type":"boolean","description":"Send an alert when the Zoom Room is online after previously being offline.","example":true},"zoom_room_display_disconnected":{"type":"boolean","description":"Send an alert when the TV display is disconnected","example":true},"zoom_room_offline":{"type":"boolean","description":"Send an alert when the machine hosting the Zoom Room application has a network issue or cannot connect with the Controller.","example":true}},"description":"[Notifications Settings](https://support.zoom.us/hc/en-us/articles/205394099-Zoom-Room-Alerts#h_b430b5f2-5150-4522-9c96-c77f22ab70bc) includes the circumstances in which the room sends an email alert to the support team to notify them of a potentially urgent issue. These issues can affect the operation of the room, but do not display on the TV screen. The email alert is sent to the email address specified in the Notification Email Recipients section. "},"scheduling_display":{"type":"object","properties":{"instant_room_reservation":{"type":"boolean","description":"If enabled, the Zoom Room Scheduling Display will allow a user to perform an instant room reservation on the device.","example":true},"reserve_other_rooms":{"type":"object","properties":{"allow_to_reserve_other_rooms":{"type":"boolean","description":"If enabled, the Zoom Room Scheduling Display will allow a user to perform instant room reservations of other rooms on the device.","example":true},"location_types":{"type":"string","description":"The Zoom Room Scheduling Display will allow a user to find other rooms to reserve in the same parent Zoom Rooms Location Hierarchy Location as this device, and higher Location levels if so configured. Use the API [Get Zoom Room Location Structure](https://developers.zoom.us/docs/api/rest/reference/zoom-rooms/methods/#operation/getZRLocationStructure) to determine valid Location levels.","example":"floor","enum":["city","campus","building","floor"]}},"description":"Contains settings that allows Zoom Room Scheduling Display to reserve other Zoom Rooms."},"set_scheduling_display_background_image_to_zoom_room_background":{"type":"boolean","description":"If enabled, the Zoom Room Scheduling Display will use the same background image as the Zoom Room. Note: Some Zoom Rooms Scheduling displays use a different display aspect ratio than standard 16:9; the background image will be scaled to fit the Scheduling Display's display, with any excess cropped.","example":true},"home_screen_theme":{"type":"string","description":"The Zoom Room Scheduling Display UI theme.","example":"compact","enum":["standard","compact"]},"home_screen_qr_code_url":{"type":"string","description":"If the Zoom Rooms Scheduling Display home screen theme is \"compact\", a space is reserved for a QR code to be displayed. You may optionally provide a URL which Zoom will use to automatically generate the corresponding QR code image. If you provide a URL that exceeds 100 characters in total length, Zoom will automatically use the Zoom URL shortening service to generate a shortened URL that will redirect to your actual URL; the URL is shortened to increase QR code scan reliability. This setting has no effect if the home screen theme is \"standard\".","example":"https://example.com"},"home_screen_qr_code_supporting_text":{"type":"string","description":"If the Zoom Rooms Scheduling Display home screen theme is \"compact\", a space is reserved for additional text to appear adjacent to the space reserved for a QR code. This setting has no effect if the home screen theme is \"standard\".","example":"Scan to reserve"}},"description":"Scheduling Display Settings section includes performing Zoom Room reservations and setting the home screen theme on the Scheduling Display device."}}}]}}}},"responses":{"204":{"description":"**HTTP Status Code:** `204` **No Content**  \n \nSettings updated successfully.\n"},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request \n\n **Error Code:** `200` <br>\n Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription.<br>\nAccess restricted. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:update:account_settings:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["ZoomRooms:Edit"],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:update:account_settings:admin"]}}},"/rooms/calendar/services":{"get":{"tags":["Zoom Rooms Calendar"],"summary":"List calendar services","description":"List all the existing [calendar services](https://support.zoom.us/hc/en-us/articles/4409832833037) in a Zoom Room account.  **Prerequisites:** * A Pro or a higher plan with a [Zoom Rooms](https://zoom.us/zoomrooms) license.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:read:list_calendar_services:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"getCalendarServices","responses":{"200":{"description":"**HTTP Status Code:** `200` **OK**  \n \nCalendar services returned successfully.","content":{"application/json":{"schema":{"type":"object","properties":{"calendar_services":{"type":"array","description":"Information about the calendar services.","items":{"type":"object","properties":{"calendar_service_id":{"type":"string","description":"The calendar service's ID.","example":"rNQUpdDXySFGhVycz7aR-SR"},"calendar_service_name":{"type":"string","description":"The calender service's name.","example":"zroom1@example.com"},"calendar_resource_total_number":{"type":"integer","description":"The total number of calendar resources.","example":100},"calendar_resource_assigned_number":{"type":"integer","description":"The number of assigned calendar resources.","example":10},"added_date_time":{"type":"string","description":"The date and time at which the calendar service was added.","format":"date-time","example":"2022-03-31T19:03:03Z"},"latest_synced_date_time":{"type":"string","description":"The date and time at which the calendar service was last synced.","format":"date-time","example":"2022-03-31T19:03:03Z"}}}}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `200` <br>\n * Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription. \n* At least one normal Zoom Rooms required. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:read:admin","zoom_rooms:read:list_calendar_services:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["room:read:admin"],"x-granular-scopes":["zoom_rooms:read:list_calendar_services:admin"]}}},"/rooms/calendar/services/{serviceId}":{"delete":{"tags":["Zoom Rooms Calendar"],"summary":"Delete a calendar service","description":"Deletes a Zoom Room account's calendar service.  **Prerequisites:** * A Pro or a higher plan with a [Zoom Rooms](https://zoom.us/zoomrooms) license.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:delete:calendar_service:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"deleteACalendarService","parameters":[{"name":"serviceId","in":"path","description":"The calendar service's ID.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}}],"responses":{"204":{"description":"**HTTP Status Code:** `204` **No Content**  \n \nCalendar service successfully deleted."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `200` <br>\n * Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription. \n* At least one normal Zoom Rooms required. <br>\n**Error Code:** `4005` <br>\n Calendar resource assigned to a Zoom Room: {resourceId}. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `4061` <br>\n Calendar service does not exist: {serviceId}. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:delete:calendar_service:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:delete:calendar_service:admin"]}}},"/rooms/calendar/services/{serviceId}/resources":{"get":{"tags":["Zoom Rooms Calendar"],"summary":"List calendar resources by calendar service","description":"List all of a Zoom Room account's [calendar resources](https://support.zoom.us/hc/en-us/articles/4409832833037).  **Prerequisites:** * A Pro or a higher plan with a [Zoom Rooms](https://zoom.us/zoomrooms) license.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:read:list_calendar_resources:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"getCalendarResourcesByServiceId","parameters":[{"name":"serviceId","in":"path","description":"The calendar service's ID.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}},{"name":"page_size","in":"query","description":"The number of records returned within a single API call.","required":false,"schema":{"maximum":300,"type":"integer","example":30,"default":30}},{"name":"next_page_token","in":"query","description":"Use the next page token to paginate through large result sets. A next page token is returned whenever the set of available results exceeds the current page size. This token's expiration period is 15 minutes.","required":false,"schema":{"type":"string","example":"IAfJX3jsOLW7w3dokmFl84zOa0MAVGyMEB2"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` **OK**  \n \nCalendar resources successfully returned.","content":{"application/json":{"schema":{"type":"object","properties":{"next_page_token":{"type":"string","description":"The next page token is used to paginate through large result sets. A next page token will be returned whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes.","example":"At6eWnFZ1FB3arCXnRxqHLXKhbDW18yz2i2"},"page_size":{"type":"integer","description":"The number of records returned within a single API call.","example":20},"calendar_resources":{"type":"array","description":"Information about existing calendar resources.","items":{"type":"object","properties":{"calendar_resource_id":{"type":"string","description":"The calendar resource's ID.","example":"rNQUpdDXySFGhVycz7aR-SR"},"calendar_resource_email":{"type":"string","description":"The calendar resource's email address.","format":"email","example":"zroom1@example.com"},"calendar_resource_name":{"type":"string","description":"The calendar resource's name.","example":"zroom1"},"assigned_room_id":{"type":"string","description":"The Zoom Room user ID that the calendar resource is assigned to.","example":"yLom99u5QuKBTw4Q7_P6Pw"},"sync_status":{"type":"string","description":"The calendar resource's sync status: \n* `Success` &mdash; Synched. \n* `Failed` &mdash; Not synced.","example":"Success","enum":["Success","Failed"]}}}}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `200` <br>\n * Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription. \n* At least one normal Zoom Rooms required. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `4061` <br>\n Calendar service does not exist: {serviceId}. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:read:admin","zoom_rooms:read:list_calendar_resources:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["room:read:admin"],"x-granular-scopes":["zoom_rooms:read:list_calendar_resources:admin"]}},"post":{"tags":["Zoom Rooms Calendar"],"summary":"Add a calendar resource to a calendar service","description":"Use this API to add a [calendar resource](https://support.zoom.us/hc/en-us/articles/4409832833037) to a Microsoft Exchange or Office 365 calendar service in a Zoom Room account. \n\n**Note:** This API does not support adding a calendar resource to a Google calendar service. \n\n **Prerequisites:** \n* A Pro or a higher plan with a [Zoom Rooms](https://zoom.us/zoomrooms) license.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:write:calendar_resource:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"addACalendarResourceToCalendarService","parameters":[{"name":"serviceId","in":"path","description":"The calendar service's ID.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}}],"requestBody":{"content":{"application/json":{"schema":{"required":["calendar_resource_email"],"type":"object","properties":{"calendar_resource_email":{"type":"string","description":"The calendar resource's email address.","example":"zroom1@example.com"}}}}}},"responses":{"201":{"description":"**HTTP Status Code:** `201` **Created**  \n \nCalendar resource successfully added.","content":{"application/json":{"schema":{"type":"object","properties":{"calendar_resource_id":{"type":"string","description":"The calendar resource's ID.","example":"rNQUpdDXySFGhVycz7aR-SR"},"calendar_resource_email":{"type":"string","description":"The calendar resource's email address.","format":"email","example":"zroom1@example.com"},"calendar_resource_name":{"type":"string","description":"The calendar resource's name.","example":"zroom1"}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `200` <br>\n * Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription. \n* At least one normal Zoom Rooms required. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `4061` <br>\n Calendar service does not exist: {serviceId}. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:write:calendar_resource:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:write:calendar_resource:admin"]}}},"/rooms/calendar/services/{serviceId}/resources/{resourceId}":{"get":{"tags":["Zoom Rooms Calendar"],"summary":"Get a calendar resource by ID","description":"List Zoom Room account's [calendar resource](https://support.zoom.us/hc/en-us/articles/4409832833037).  **Prerequisites:** * A Pro or a higher plan with a [Zoom Rooms](https://zoom.us/zoomrooms) license.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:read:calendar_resource:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"getCalendarResourceById","parameters":[{"name":"serviceId","in":"path","description":"The calendar service's ID.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}},{"name":"resourceId","in":"path","description":"The calendar resource's ID.","required":true,"schema":{"type":"string","example":"rNQUpdDXySFGhVycz7aR-SR"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` **OK**  \n \nCalendar resources successfully returned.","content":{"application/json":{"schema":{"type":"object","properties":{"calendar_resource_id":{"type":"string","description":"The calendar resource's ID.","example":"rNQUpdDXySFGhVycz7aR-SR"},"calendar_resource_email":{"type":"string","description":"The calendar resource's email address.","format":"email","example":"zroom1@example.com"},"calendar_resource_name":{"type":"string","description":"The calendar resource's name.","example":"zroom1"},"assigned_room_id":{"type":"string","description":"The Zoom Room user ID that the calendar resource is assigned to.","example":"yLom99u5QuKBTw4Q7_P6Pw"},"sync_status":{"type":"string","description":"The calendar resource's sync status: \n* `Success` &mdash; Synched. \n* `Failed` &mdash; Not synced.","example":"Success","enum":["Success","Failed"]}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `200` <br>\n * Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription. \n* At least one normal Zoom Rooms required. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `4061` <br>\n Calendar service does not exist: {serviceId}. <br>\n**Error Code:** `4060` <br>\n Calendar resource does not exist: {resourceId}. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:read:admin","zoom_rooms:read:calendar_resource:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["room:read:admin"],"x-granular-scopes":["zoom_rooms:read:calendar_resource:admin"]}},"delete":{"tags":["Zoom Rooms Calendar"],"summary":"Delete a calendar resource","description":"Deletes a Zoom Room account's [calendar resource](https://support.zoom.us/hc/en-us/articles/4409832833037) from a Microsoft Exchange or Office 365 calendar service. **Note:** This API does not support deleting a calendar resource from a Google calendar service.  **Prerequisites:** * A Pro or a higher plan with a [Zoom Rooms](https://zoom.us/zoomrooms) license.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:delete:calendar_resource:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"deleteACalendarResource","parameters":[{"name":"serviceId","in":"path","description":"The calendar service's ID.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}},{"name":"resourceId","in":"path","description":"The calendar resource's ID. You can get this value using the [**List Calendar Resources**](/docs/api-reference/zoom-api/methods#operation/listCalendarResources) API.","required":true,"schema":{"type":"string","example":"rNQUpdDXySFGhVycz7aR-SR"}}],"responses":{"204":{"description":"**HTTP Status Code:** `204` **No Content**  \n \nCalendar resource successfully deleted."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `200` <br>\n * Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription. \n* At least one normal Zoom Rooms required. <br>\n**Error Code:** `4005` <br>\n Calendar resource assigned to a Zoom Room: {resourceId}. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `4061` <br>\n Calendar service does not exist: {serviceId}. <br>\n**Error Code:** `4060` <br>\n Calendar resource does not exist: {resourceId}. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:delete:calendar_resource:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:delete:calendar_resource:admin"]}}},"/rooms/calendar/services/{serviceId}/sync":{"put":{"tags":["Zoom Rooms Calendar"],"summary":"Start calendar service sync process","description":"Use this API to kick off the sync process for Zoom Room account's calendar service. \n\n **Prerequisites:** \n* A Pro or a higher plan with a [Zoom Rooms](https://zoom.us/zoomrooms) license.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:update:calendar_service:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"syncACalendarService","parameters":[{"name":"serviceId","in":"path","description":"The calendar service's ID.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}}],"responses":{"202":{"description":"**HTTP Status Code:** `202` **Accepted**  \n \nCalendar processed successfully."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `200` <br>\n * Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription. \n* At least one normal Zoom Rooms required. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `4061` <br>\n Calendar service does not exist: {serviceId}. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:update:calendar_service:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["CalendarIntegration:Edit","ZoomRooms:Edit"],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:update:calendar_service:admin"]}}},"/rooms/content/background/contents":{"get":{"tags":["Zoom Rooms Content"],"summary":"List Zoom Rooms background image library contents","description":"Returns a list of Zoom Rooms background image library contents. Maximum number per page 200.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:read:background_library_content:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"ListZoomRoomsbackgroundimagelibrarycontents","parameters":[{"name":"page_size","in":"query","description":"Page Size (number of file contents items).","required":false,"schema":{"type":"integer","example":30}},{"name":"next_page_token","in":"query","description":"The next page token is used to paginate through large result sets. A next page token will be returned whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes.","required":false,"schema":{"type":"string","example":"IAfJX3jsOLW7w3dokmFl84zOa0MAVGyMEB2"}},{"name":"folder_id","in":"query","description":"The folder ID.","required":false,"schema":{"type":"string","example":"LHMmOOYaRiOA5m5WZjXVPA"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` **OK**\nA list of Zoom Rooms background image library content items.","content":{"application/json":{"schema":{"required":["page_size"],"type":"object","properties":{"next_page_token":{"type":"string","description":"The next page token is used to paginate through large result sets. A next page token will be returned whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes.","example":"At6eWnFZ1FB3arCXnRxqHLXKhbDW18yz2i2"},"page_size":{"type":"string","description":"Page Size (number of file contents items).","example":"20"},"total_records":{"type":"string","description":"Total number of file content items.","example":"200"},"contents":{"type":"array","items":{"type":"object","properties":{"content_id":{"type":"string","description":"The file content ID.","example":"zrd9DycNSxK6K4dEUS6z-g"},"content_name":{"type":"string","description":"The file content name.","example":"Example.jpg"}}}}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `30051005` <br>\n Invalid next_page_token or page_size. <br>\n"},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:read:admin","zoom_rooms:read:background_library_content:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["ZoomRooms:Read"],"x-macro-scopes":["room:read:admin"],"x-granular-scopes":["zoom_rooms:read:background_library_content:admin"]}}},"/rooms/content/background/contents/{contentId}":{"get":{"tags":["Zoom Rooms Content"],"summary":"Get Zoom Rooms background image library content","description":"Return a Zoom Rooms background image library content item.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:read:background_library_content:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"GetZoomRoomsBackgroundImageLibraryContent","parameters":[{"name":"contentId","in":"path","description":"The file content ID.","required":true,"schema":{"type":"string","example":"zrd9DycNSxK6K4dEUS6z"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` **OK**   Return a Zoom Rooms background image library content item.","content":{"application/json":{"schema":{"type":"object","properties":{"content_id":{"type":"string","description":"The file content ID.","example":"zrd9DycNSxK6K4dEUS6z"},"content_name":{"type":"string","description":"The file content name.","example":"Test.jpg"},"download_url":{"type":"string","description":" The URL where the background image file may be downloaded. This URL will be expire according to the `download_url_ttl`.","example":"https://st1.zoom.us/fe-static/zr-settings/file/digital_signage/ZR_Digital_Guide_Still_Image.jpg"},"download_url_ttl":{"type":"string","description":"The time to live of the download URL, in seconds.","example":"3600"}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `30051005` <br>\n Invalid parameter: File content ID must not contain illegal characters. <br>\n"},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `30054003` <br>\n File content not found. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:read:admin","zoom_rooms:read:background_library_content:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["ZoomRooms:Read"],"x-macro-scopes":["room:read:admin"],"x-granular-scopes":["zoom_rooms:read:background_library_content:admin"]}},"delete":{"tags":["Zoom Rooms Content"],"summary":"Delete Zoom Rooms Background Image Library Content","description":"Deletes a Zoom Rooms background image library content item. Warning: the image will be deleted, and Zoom Rooms using the image will revert to the default background image.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:delete:background_library_content:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"DeleteZoomRoomsBackgroundImageLibraryContent","parameters":[{"name":"contentId","in":"path","description":"The file content ID.","required":true,"schema":{"type":"string","example":"zrd9DycNSxK6K4dEUS6z"}}],"responses":{"204":{"description":"**HTTP Status Code:** `204` **OK**  \n \nZoom Rooms background image library content deleted successfully."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `30051005` <br>\n Invalid Parameter: Folder ID Must Not Contain Illegal Characters. <br>\n"},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `30054003` <br>\n Folder Not Found. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:delete:background_library_content:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["ZoomRooms:Edit"],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:delete:background_library_content:admin"]}}},"/rooms/content/background/defaults":{"get":{"tags":["Zoom Rooms Content"],"summary":"List default Zoom Rooms background image library contents","description":"Display a list of Zoom-provided default background images from the background image library.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:read:background_library_content:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"ListDefaultZoomRoomsBackgroundImageLibrarycontents","parameters":[{"name":"page_size","in":"query","description":"Page size, in number of file contents items.","required":false,"schema":{"type":"integer","example":30}},{"name":"next_page_token","in":"query","description":"Use the next page token to paginate through large result sets. A next page token is returned whenever the set of available results exceeds the current page size. This token's expiration period is 15 minutes.","required":false,"schema":{"type":"string","example":"IAfJX3jsOLW7w3dokmFl84zOa0MAVGyMEB2"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` **OK**\nA list of Zoom-provided default background images from the background image library.","content":{"application/json":{"schema":{"type":"object","properties":{"next_page_token":{"type":"string","description":"Use the next page token is used to paginate through large result sets. A next page token is returned whenever the set of available results exceeds the current page size. This token's expiration period is 15 minutes.","example":"At6eWnFZ1FB3arCXnRxqHLXKhbDW18yz2i2"},"page_size":{"type":"string","description":"Page size, in number of file contents items.","example":"20"},"total_records":{"type":"string","description":"Total number of file content items.","example":"200"},"contents":{"type":"array","items":{"type":"object","properties":{"content_id":{"type":"string","description":"The file content ID.","example":"zrd9DycNSxK6K4dEUS6z-g"},"content_name":{"type":"string","description":"The file content name.","example":"golden_gate_bridge.jpg"},"download_url":{"type":"string","description":"The URL to download the default background image file.","example":"https://st1.zoom.us/fe-static/fe-image-box/images/background-image/golden_gate_bridge.png"}}}}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `30051005` <br>\n Invalid next_page_token or page_size. <br>\n"},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:read:admin","zoom_rooms:read:background_library_content:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["ZoomRooms:Read"],"x-macro-scopes":["room:read:admin"],"x-granular-scopes":["zoom_rooms:read:background_library_content:admin"]}}},"/rooms/content/background/folders":{"get":{"tags":["Zoom Rooms Content"],"summary":"List Zoom Rooms Background Image Library Folders","description":"Returns a list of Zoom Rooms background image library content folders. Maximum number per page 200.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:read:background_library_folder:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"ListZoomRoomsBackgroundLibraryFolders","parameters":[{"name":"page_size","in":"query","description":"Page Size (Number of Folders).","required":false,"schema":{"type":"integer","example":30}},{"name":"next_page_token","in":"query","description":"Use the next page token to paginate through large result sets. A next page token is returned whenever the set of available results exceeds the current page size. This token's expiration period is 15 minutes.","required":false,"schema":{"type":"string","example":"IAfJX3jsOLW7w3dokmFl84zOa0MAVGyMEB2"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` **OK**\nA list of Zoom Rooms background image library folders.","content":{"application/json":{"schema":{"required":["page_size"],"type":"object","properties":{"next_page_token":{"type":"string","description":"The next page token is used to paginate through large result sets. A next page token will be returned whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes.","example":"At6eWnFZ1FB3arCXnRxqHLXKhbDW18yz2i2"},"page_size":{"type":"integer","description":"Page Size (Number of folders).","example":20},"total_records":{"type":"string","description":"Total number of folders.","example":"20"},"folders":{"type":"array","items":{"type":"object","properties":{"folder_id":{"type":"string","description":"The folder ID.","example":"LHMmOOYaRiOA5m5WZjXVPA"},"folder_name":{"type":"string","description":"The folder name.","example":"Example Folder"}}}}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `30051005` <br>\n Invalid next_page_token or page_size. <br>\n"},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:read:admin","zoom_rooms:read:background_library_folder:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["ZoomRooms:Read"],"x-macro-scopes":["room:read:admin"],"x-granular-scopes":["zoom_rooms:read:background_library_folder:admin"]}},"post":{"tags":["Zoom Rooms Content"],"summary":"Add Zoom Rooms Background Image Library Folder","description":"Use this API to add a Zoom Rooms background image library content folder. You may create up to 20 folders, maximum.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:write:background_library_folder:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"AddZoomRoomsBackgroundLibraryFolder","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"folder_name":{"type":"string","description":"The folder name.","example":"Example Folder"}}}}}},"responses":{"201":{"description":"**HTTP Status Code:** `201` **OK**   \nZoom Rooms background image library folder added successfully.","content":{"application/json":{"schema":{"type":"object","properties":{"folder_id":{"type":"string","description":"The folder ID.","example":"LHMmOOYaRiOA5m5WZjXVPA"}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `30051005` <br>\n Invalid Parameter: Folder Name Must Not Contain Illegal Characters. <br>\n**Error Code:** `30057007` <br>\n Folder Creation Failed: Maximum Folder Limit (20) Exceeded. <br>\n"},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:write:background_library_folder:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["ZoomRooms:Edit"],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:write:background_library_folder:admin"]}}},"/rooms/content/background/folders/{folderId}":{"get":{"tags":["Zoom Rooms Content"],"summary":"Get Zoom Rooms Background Image Library Folder","description":"Returns a Zoom Rooms background image library folder.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:read:background_library_folder:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"GetZoomRoomsBackgroundLibraryFolder","parameters":[{"name":"folderId","in":"path","description":"The folder ID.","required":true,"schema":{"type":"string","example":"LHMmOOYaRiOA5m5WZjXVPA"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` **OK**   \nInformation about the Zoom Rooms background image library folder.","content":{"application/json":{"schema":{"type":"object","properties":{"folder_id":{"type":"string","description":"The folder ID.","example":"LHMmOOYaRiOA5m5WZjXVPA"},"folder_name":{"type":"string","description":"The folder name.","example":"Example folder"}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `30051005` <br>\n Invalid Parameter: Folder ID Must Not Contain Illegal Characters <br>\n"},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `30054003` <br>\n Folder Not Found <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:read:admin","zoom_rooms:read:background_library_folder:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["ZoomRooms:Read"],"x-macro-scopes":["room:read:admin"],"x-granular-scopes":["zoom_rooms:read:background_library_folder:admin"]}},"delete":{"tags":["Zoom Rooms Content"],"summary":"Delete Zoom Rooms Background Image Library Folder","description":"Deletes a Zoom Rooms background image library content folder.  Warning: all images in the folder will be deleted, and Zoom Rooms using those images will revert to the default background image.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:delete:background_library_folder:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"DeleteZoomRoomsBackgroundLibraryFolder","parameters":[{"name":"folderId","in":"path","description":"The folder ID.","required":true,"schema":{"type":"string","example":"LHMmOOYaRiOA5m5WZjXVPA"}}],"responses":{"204":{"description":"**HTTP Status Code:** `204` **OK**   \nZoom Rooms background image library folder deleted successfully."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `30051005` <br>\n Invalid Parameter: Folder ID Must Not Contain Illegal Characters. <br>\n"},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `30054003` <br>\n Folder Not Found. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:delete:background_library_folder:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["ZoomRooms:Edit"],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:delete:background_library_folder:admin"]}},"patch":{"tags":["Zoom Rooms Content"],"summary":"Update Zoom Rooms Background Image Library Folder","description":"Updates a Zoom Rooms background image library content folder.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:update:background_library_folder:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"UpdateaZoomRoomsBackgroundLibraryFolderName","parameters":[{"name":"folderId","in":"path","description":"The folder ID.","required":true,"schema":{"type":"string","example":"LHMmOOYaRiOA5m5WZjXVPA"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"folder_name":{"type":"string","description":"The folder name.","example":"Example Folder"}}}}}},"responses":{"204":{"description":"**HTTP Status Code:** `204` **OK**\nZoom Rooms background image library folder updated successfully."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `30051005` <br>\n Invalid Parameter: Folder Name and Folder ID Must Not Contain Illegal Characters. <br>\n**Error Code:** `30057005` <br>\n The name is already taken. Choose another one. <br>\n"},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `30054003` <br>\n Folder Not Found. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:update:background_library_folder:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["ZoomRooms:Edit"],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:update:background_library_folder:admin"]}}},"/rooms/content/digital_signage/contents":{"get":{"tags":["Zoom Rooms Content"],"summary":"List Digital Signage content items","description":"Returns a list of Zoom Rooms digital signage library base folder content items.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:read:digital_signage_library_contents:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"GETListdigitalsignagecontentitems","parameters":[{"name":"page_size","in":"query","description":"The number of records, returned within a single API call. Default: 30，Max: 200.","required":true,"schema":{"maximum":200,"minimum":1,"type":"integer","example":30,"default":30}},{"name":"next_page_token","in":"query","description":"Use the next page token to paginate through large result sets. A next page token is returned whenever the set of available results exceeds the current page size. This token's expiration period is 15 minutes.","required":false,"schema":{"type":"string","example":"IAfJX3jsOLW7w3dokmFl84zOa0MAVGyMEB2"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` **OK**  \n \nList of digital signage library content items successful.","content":{"application/json":{"schema":{"type":"object","properties":{"next_page_token":{"type":"string","description":"The next page token is used to paginate through large result sets. A next page token will be returned whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes.","example":"IAfJX3jsOLW7w3dokmFl84zOa0MAVGyMEB2\n"},"page_size":{"type":"integer","description":"The number of records returned within a single API call.","example":1},"contents":{"maxItems":200,"type":"array","description":"List of digital signage library content items","items":{"type":"object","properties":{"content_id":{"type":"string","description":"The content ID.","example":"4zOa0MAVGyMEB2"},"content_type":{"type":"string","description":"The content type.","example":"image","enum":["image","video","url"]},"content_name":{"type":"string","description":"If the content item is a picture or video, the file name.  If the content item is a URL, the URL.","example":"example.jpg"}},"description":"content items"}}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `30051005` <br>\n Invalid next_page_token or page_size. <br>\n"},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:read:admin","zoom_rooms:read:digital_signage_library_contents:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["DigitalSignage:Read"],"x-macro-scopes":["room:read:admin"],"x-granular-scopes":["zoom_rooms:read:digital_signage_library_contents:admin"]}},"post":{"tags":["Zoom Rooms Content"],"summary":"Add a digital signage URL","description":"Use this API to add a URL to the Zoom Rooms digital signage content library.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:write:digital_signage_library_contents:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"AddadigitalsignageURL","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"content_name":{"type":"string","description":"The file content name.","example":"Example Website URL"},"content_url":{"type":"string","description":"The file content URL.","example":"https://example.com/example"},"folder_id":{"type":"string","description":"The folder ID.","example":"LHMmOOYaRiOA5m5WZjXVPA"}}}}}},"responses":{"201":{"description":"**HTTP Status Code:** `201` **OK**\n\nAdd a digital signage URL successfully.","content":{"application/json":{"schema":{"type":"object","properties":{"content_id":{"type":"string","description":"The content item ID.","example":"ulx2iq6lTAOVTflXCrS4LQ"}}}}}},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:write:digital_signage_library_contents:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["DigitalSignage:Edit"],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:write:digital_signage_library_contents:admin"]}}},"/rooms/content/digital_signage/contents/{contentId}":{"get":{"tags":["Zoom Rooms Content"],"summary":"Get Digital Signage content item","description":"Use this API to get the details of an individual digital signage content item.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:read:digital_signage_library_contents:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"Getdigitalsignagecontentitem","parameters":[{"name":"contentId","in":"path","description":"The content ID.","required":true,"schema":{"type":"string","example":"IAfJX3jsOLW7w3dokmFl"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` **OK**  \n \nGet digital signage content item successfully.","content":{"application/json":{"schema":{"type":"object","properties":{"content_id":{"type":"string","description":"Unique identifier of the content item.","example":"HE-d7lrSR4qqxC12noVtaA"},"content_type":{"type":"string","description":"The content item type.","example":"url","enum":["image","video","url"]},"content_name":{"type":"string","description":"The name of the content item.","example":"example url"},"content_url":{"type":"string","description":"If the content item is a URL, the target URL.  If the content item is an image or video, this field will be empty.","example":"https://zoom.us"},"expires":{"type":"boolean","description":"If set to `true`, the content will expire at the configured expiration_time.  Default: `false`.","example":false},"expiration_time":{"type":"string","description":"If expires is true, the content will expire after the configured time.","format":"date-time"},"folder_id":{"type":"string","description":"Unique identifier of the digital signage content folder where the content is located.  If the item is in the root folder, the folder_id will be empty.","example":"7lrSR4qqxC11HQVtaArtvg"},"download_url":{"type":"string","description":"If the content item is an image or video, the URL where the file can be downloaded.  If the content item is a URL, this field will be empty. This URL will be expire according to the download_url_ttl.","example":"https://fileserver.zoom.us/rescfdrddvdwssw123"},"download_url_ttl":{"type":"integer","description":"The time to live of the download URL, in seconds.","example":300}}}}}},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:read:admin","zoom_rooms:read:digital_signage_library_contents:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["DigitalSignage:Read"],"x-macro-scopes":["room:read:admin"],"x-granular-scopes":["zoom_rooms:read:digital_signage_library_contents:admin"]}},"delete":{"tags":["Zoom Rooms Content"],"summary":"Delete a Digital Signage content item","description":"Use this API to delete an individual digital signage content item.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`,`room:write:master`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:write:digital_signage_library_contents:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"Deleteadigitalsignagecontentitem","parameters":[{"name":"contentId","in":"path","description":"Unique identifier of the digital signage content","required":true,"schema":{"type":"string","example":"U0V35NT8RdCWUKsU-MLm-g"}},{"name":"remove_from_library_only","in":"query","description":" If set to `true`, the content item will be removed from the content library only.  If set to `false`, the content item will be removed from the content library and from any playlists and/or Zoom Room content lists that reference the content library item.","required":false,"schema":{"type":"boolean","example":true}}],"responses":{"204":{"description":" **HTTP Status Code:** `204` **OK**\n \n Delete a digital signage content successfully."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","room:write:master","zoom_rooms:write:digital_signage_library_contents:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["DigitalSignage:Edit"],"x-macro-scopes":["room:write:admin","room:write:master"],"x-granular-scopes":["zoom_rooms:write:digital_signage_library_contents:admin"]}},"patch":{"tags":["Zoom Rooms Content"],"summary":"Update a Digital Signage content item attributes","description":"Use this API to update a digital signage content item's attributes.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:write:digital_signage_library_contents:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"Updateadigitalsignagecontentitemattributes","parameters":[{"name":"contentId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"content_name":{"type":"string","description":"The name of the content item.","example":"Example Website URL"},"content_url":{"type":"string","description":" Changes the target URL of a digital signage content item of the URL type.  This field will be ignored for image or video content items.","example":"https://example.com/example"},"expires":{"type":"boolean","description":"If set to `true`, the content will expire at the configured expiration_time.  Default: `false`.","example":true},"expiration_time":{"pattern":"yyyy-MM-dd HH:mm:ss","type":"string","description":"If expires is true, the content will expire after the configured time.","format":"date-time"}}}}}},"responses":{"204":{"description":"**HTTP Status Code:** `204` **OK**\n\nUpdate a digital signage content item attributes successfully."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:write:digital_signage_library_contents:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["DigitalSignage:Edit"],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:write:digital_signage_library_contents:admin"]}}},"/rooms/content/digital_signage/folders":{"post":{"tags":["Zoom Rooms Content"],"summary":"Add a digital signage content folder","description":"Use this API to add a Digital Signage Content folder.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:write:digital_signage_library_contents:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"Addadigitalsignagecontentfolder","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"folder_name":{"type":"string","description":"The digital signage content folder name.","example":"testfolder"}}}}}},"responses":{"200":{"description":"**HTTP Status Code:** `201` **Created** \n\nAdd a digital signage folder successfully.","content":{"application/json":{"schema":{"type":"object","properties":{"folder_id":{"type":"string","description":"The folder ID.","example":"idV95eT8RdCds23U-NLo-a"}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:write:digital_signage_library_contents:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["DigitalSignage:Edit"],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:write:digital_signage_library_contents:admin"]}}},"/rooms/content/digital_signage/folders/{folderId}":{"get":{"tags":["Zoom Rooms Content"],"summary":"Get Digital Signage content folder","description":"Use this API to get the details of an individual digital signage content folder.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:read:master`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:read:digital_signage_library_contents:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"Getdigitalsignagecontentfolderdetails","parameters":[{"name":"folderId","in":"path","description":"Unique identifier of the digital signage content folder.","required":true,"schema":{"type":"string","example":"idV95eT8RdCds23U-NLo-a"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` **OK**\n\nGet a digital signage folder successfully.\"","content":{"application/json":{"schema":{"type":"object","properties":{"folder_id":{"type":"string","description":"Unique identifier of the digital signage content folder.","example":"idV95eT8RdCds23U-NLo-a"},"folder_name":{"type":"string","description":"The digital signage content folder name.","example":"testfolder"}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:read:master","zoom_rooms:read:digital_signage_library_contents:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["DigitalSignage:Read"],"x-macro-scopes":["room:read:master"],"x-granular-scopes":["zoom_rooms:read:digital_signage_library_contents:admin"]}},"delete":{"tags":["Zoom Rooms Content"],"summary":"Delete a Digital Signage content folder","description":"Use this API to delete an individual digital signage content folder.  **Note**: All digital signage content items in this folder will also be deleted.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:master`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:write:digital_signage_library_contents:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"Deleteadigitalsignagecontentfolder","parameters":[{"name":"folderId","in":"path","description":"The folder ID.","required":true,"schema":{"type":"string","example":"idV95eT8RdCds23U-NLo-a"}},{"name":"remove_from_library_only","in":"query","description":"If set to `true`, the folder and all its content item(s) will be removed from the content library only.  If set to `false`, the folder and all its content item(s) will be removed from the content library and from any playlists and/or Zoom Room content lists that reference the content library item(s).","required":false,"schema":{"type":"boolean","example":true}}],"responses":{"204":{"description":"*HTTP Status Code:** `204` **No Content**\n\nDelete digital signage folder successful."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:master","zoom_rooms:write:digital_signage_library_contents:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["DigitalSignage:Edit"],"x-macro-scopes":["room:write:master"],"x-granular-scopes":["zoom_rooms:write:digital_signage_library_contents:admin"]}},"patch":{"tags":["Zoom Rooms Content"],"summary":"Update a digital signage content folder","description":"Updates a Digital Signage content folder’s attributes.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:write:digital_signage_library_contents:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"Updateadigitalsignagecontentfolder","parameters":[{"name":"folderId","in":"path","description":"The folder ID.","required":true,"schema":{"type":"string","example":"idV95eT8RdCds23U-NLo-a"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"folder_name":{"type":"string","description":"The digital signage content folder name.","example":"myfolder"}}}}}},"responses":{"204":{"description":"**HTTP Status Code:** `204` **No content**\n\nUpdate digital signage content folder successful.\n\n"}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:write:digital_signage_library_contents:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["DigitalSignage:Edit"],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:write:digital_signage_library_contents:admin"]}}},"/rooms/content/digital_signage/playlists":{"get":{"tags":["Zoom Rooms Content"],"summary":"List Digital Signage library playlists","description":" Returns a list of Zoom Rooms content library digital signage playlists.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:read:digital_signage_library_playlists:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"ListDigitalSignagelibraryplaylists","parameters":[{"name":"page_size","in":"query","description":"The number of records returned within a single API call.","required":false,"schema":{"maximum":300,"minimum":1,"type":"integer","example":30}},{"name":"next_page_token","in":"query","description":"Use the next page token to paginate through large result sets. A next page token is returned whenever the set of available results exceeds the current page size. This token's expiration period is 15 minutes.","required":false,"schema":{"type":"string","example":"IAfJX3jsOLW7w3dokmFl84zOa0MAVGyMEB2"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` **OK** \n\nList playlist successful.","content":{"application/json":{"schema":{"type":"object","properties":{"next_page_token":{"type":"string","description":"The next page token is used to paginate through large result sets. A next page token will be returned whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes.","example":"ecfJX3jsOLW7w3dokmF90czOa0MAVGyMEB2"},"page_size":{"type":"integer","description":" The number of records returned within a single API call.","example":10},"playlists":{"maxItems":300,"type":"array","items":{"type":"object","properties":{"playlist_id":{"type":"string","description":" The playlist id","example":"U0V35NT8RdCWUKsU-MLm-g"},"playlist_name":{"type":"string","description":" The playlist name","example":"myplaylist"}}}}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:read:admin","zoom_rooms:read:digital_signage_library_playlists:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["DigitalSignage:Read"],"x-macro-scopes":["room:read:admin"],"x-granular-scopes":["zoom_rooms:read:digital_signage_library_playlists:admin"]}},"post":{"tags":["Zoom Rooms Content"],"summary":"Add a Digital Signage library playlist","description":"Use this API to add a content library Digital Signage Playlist.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:write:digital_signage_library_playlists:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"AddaDigitalSignagelibraryplaylist","requestBody":{"content":{"application/json":{"schema":{"required":["playlist_name"],"type":"object","properties":{"playlist_name":{"type":"string","description":"The playlist name","example":"my playlist"}}}}}},"responses":{"201":{"description":"**HTTP Status Code:** `201` **Created**\n\nAdd digital signage playlist successful.","content":{"application/json":{"schema":{"type":"object","properties":{"playlist_id":{"type":"string","description":"The playlist ID.","example":"U0V35NT8RdCWUKsU-MLm-g"}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:write:digital_signage_library_playlists:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["DigitalSignage:Edit"],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:write:digital_signage_library_playlists:admin"]}}},"/rooms/content/digital_signage/playlists/{playlistId}":{"get":{"tags":["Zoom Rooms Content"],"summary":"Get Digital Signage library playlist","description":"Returns a Zoom Rooms content library digital signage playlist.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:read:digital_signage_library_playlists:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"GetDigitalSignagelibraryplaylist","parameters":[{"name":"playlistId","in":"path","description":"The unique identifier of the playlist. This can be retrieved from the response of the list digital signage library playlists API.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` **OK** \n\nGet Zoom Rooms content library digital signage playlist successful.","content":{"application/json":{"schema":{"type":"object","properties":{"playlist_id":{"type":"string","description":"The playlist ID.","example":"U0V35NT8RdCWUKsU-MLm-g"},"playlist_name":{"type":"string","description":"The playlist name.","example":"myplaylist"}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:read:admin","zoom_rooms:read:digital_signage_library_playlists:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["DigitalSignage:Read"],"x-macro-scopes":["room:read:admin"],"x-granular-scopes":["zoom_rooms:read:digital_signage_library_playlists:admin"]}},"delete":{"tags":["Zoom Rooms Content"],"summary":"Delete Digital Signage library playlist","description":"Delete digital signage library playlist.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:write:digital_signage_library_playlists:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"DeleteDigitalSignagelibraryplaylist","parameters":[{"name":"playlistId","in":"path","description":"The unique identifier of the playlist. This can be retrieved from the response of the List Digital Signage library playlists API.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}}],"requestBody":{"description":"Deletes a Zoom Rooms content library digital signage playlist.  \n**Note**: This will remove the playlist from the content library, all locations it was published, and be removed from all Zoom Room content lists that included the playlist."},"responses":{"204":{"description":"**HTTP Status Code:** `204` **No Content**\n\nZoom Rooms content library digital signage playlist deleted successfully."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:write:digital_signage_library_playlists:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["DigitalSignage:Edit"],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:write:digital_signage_library_playlists:admin"]}},"patch":{"tags":["Zoom Rooms Content"],"summary":"Update a Digital Signage library playlist","description":"Updates a Zoom Rooms content library digital signage playlist.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:write:digital_signage_library_playlists:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"UpdateaDigitalSignagelibraryplaylist","parameters":[{"name":"playlistId","in":"path","description":"The unique identifier of the playlist. This can be retrieved from the response of the List Digital Signage library playlists API.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"playlist_name":{"type":"string","description":"The playlist name.","example":"myplaylist"}}}}}},"responses":{"204":{"description":"**HTTP Status Code:** `204` **No Content**\n\nUpdate a Digital Signage library playlist successful."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:write:digital_signage_library_playlists:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["DigitalSignage:Edit"],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:write:digital_signage_library_playlists:admin"]}}},"/rooms/content/digital_signage/playlists/{playlistId}/contents":{"get":{"tags":["Zoom Rooms Content"],"summary":"Get Digital Signage library playlist content items","description":"Returns a Zoom Rooms content library digital signage playlist content items and their metadata.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:read:digital_signage_library_playlists:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"GetDigitalSignagelibraryplaylistcontentitems","parameters":[{"name":"playlistId","in":"path","description":" The unique identifier of the playlist. This can be retrieved from the response of the List Digital Signage library playlists API.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}},{"name":"page_size","in":"query","description":"The number of records returned within a single API call.","required":false,"schema":{"maximum":300,"minimum":1,"type":"integer","example":30}},{"name":"next_page_token","in":"query","description":"Use the next page token to paginate through large result sets. A next page token is returned whenever the set of available results exceeds the current page size. This token's expiration period is 15 minutes.","required":false,"schema":{"type":"string","example":"IAfJX3jsOLW7w3dokmFl84zOa0MAVGyMEB2"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` **OK**\n\nGet a digital signage playlist contents successfully.\"","content":{"application/json":{"schema":{"type":"object","properties":{"contents":{"maxItems":300,"type":"array","description":"List of content items in the playlist.  The items are provided in order.","items":{"type":"object","properties":{"content_id":{"type":"string","description":"The content item ID.","example":"U0V35NT8RdCWUKsU-MLm-g"},"content_name":{"type":"string","description":"The content item name","example":"example.jpg"},"content_duration":{"type":"integer","description":"The content item play duration, in seconds.","example":10}}}},"next_page_token":{"type":"string","description":"The next page token is used to paginate through large result sets. A next page token will be returned whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes.","example":"IAfJX3jsOLW7w3dokmFl84zOa0MAVGyMEB2"},"page_size":{"type":"integer","description":"The number of records returned within a single API call.","example":20}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n "},"403":{"description":"**HTTP Status Code:** `403` <br>\n Forbidden  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n "}},"security":[{"openapi_oauth":["room:read:admin","zoom_rooms:read:digital_signage_library_playlists:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["DigitalSignage:Read"],"x-macro-scopes":["room:read:admin"],"x-granular-scopes":["zoom_rooms:read:digital_signage_library_playlists:admin"]}},"put":{"tags":["Zoom Rooms Content"],"summary":"Update Digital Signage library playlist content items","description":"Updates a Zoom Rooms content library digital signage playlist content items and their metadata.  This API replaces the entire playlist.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:write:digital_signage_library_playlists:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"UpdateDigitalSignagelibraryplaylistcontentitems","parameters":[{"name":"playlistId","in":"path","description":"The unique identifier of the playlist. This can be retrieved from the response of the List Digital Signage library playlists API.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"contents":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"content_id":{"type":"string","description":"The content item ID.","example":"U0V35NT8RdCWUKsU-MLm-g"},"content_duration":{"type":"integer","description":"The content item play duration, in seconds","example":10}},"description":" List of content items to insert the playlist.  The items must be provided in order.  \n **Note**: The playlist contents are entirely replaced with the supplied items."}}}}}}},"responses":{"204":{"description":"**HTTP Status Code:** `204` **No Content** \n\nUpdate Digital Signage library playlist content items successful."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n "},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:write:digital_signage_library_playlists:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["DigitalSignage:Edit"],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:write:digital_signage_library_playlists:admin"]}}},"/rooms/content/digital_signage/playlists/{playlistId}/rooms":{"get":{"tags":["Zoom Rooms Content"],"summary":"List Digital Signage library playlist published rooms","description":"List Digital Signage library playlist published rooms.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:read:digital_signage_library_playlists:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"ListDigitalSignagelibraryplaylistpublishedrooms","parameters":[{"name":"playlistId","in":"path","description":"The unique identifier of the playlist. This can be retrieved from the response of the List Digital Signage library playlists API.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` **OK** \nList Digital Signage library playlist published rooms successfully.","content":{"application/json":{"schema":{"required":["rooms"],"type":"object","properties":{"rooms":{"type":"array","description":"The Zoom Rooms where the playlist is published.","items":{"type":"object","properties":{"room_id":{"type":"string","description":"The Zoom Room ID.","example":"qMOLd574SIGGVycz8aX_sa"}}}}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:read:admin","zoom_rooms:read:digital_signage_library_playlists:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["DigitalSignage:Read"],"x-macro-scopes":["room:read:admin"],"x-granular-scopes":["zoom_rooms:read:digital_signage_library_playlists:admin"]}},"put":{"tags":["Zoom Rooms Content"],"summary":"Update Digital Signage library playlist published rooms","description":"Update Digital Signage library playlist published rooms.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:write:digital_signage_library_playlists:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"UpdateDigitalSignagelibraryplaylistpublishedrooms","parameters":[{"name":"playlistId","in":"path","description":"The unique identifier of the playlist. This can be retrieved from the response of the List Digital Signage library playlists API.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}}],"requestBody":{"description":"Updates the list of Zoom Rooms where the playlist is published.","content":{"application/json":{"schema":{"type":"object","properties":{"rooms":{"type":"array","description":" The Zoom Rooms where the playlist is published.","items":{"type":"object","properties":{"room_id":{"type":"string","description":"The Zoom Room ID.","example":"345dddnySiujVycz8aX_JQ"}}}}}}}}},"responses":{"204":{"description":"*HTTP Status Code:* `204` **No Content** \nUpdate Digital Signage library playlist published rooms successfully."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:write:digital_signage_library_playlists:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["DigitalSignage:Edit"],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:write:digital_signage_library_playlists:admin"]}}},"/zrbackground/files":{"put":{"tags":["Zoom Rooms Content"],"summary":"Update Zoom Rooms background image library content","description":"Update a Zoom Rooms background image library content. **Prerequisite:**   The caller must be a Zoom Rooms licensed user. **Note:**  * Base URL - `https://fileapi.zoom.us/v2/`.  * Rate limit - 20 requests per second per user or 2000 requests per second per IP address. * The caller must support HTTP 30x redirects. * The caller must retain the Authorization header when redirected to a different hostname. * JPG/JPEG, 24-bit PNG (no alpha) or GIF (ZR Appliance only)* Recommended dimensions - 1920 x 1080 (landscape) or 1080 x 1920 (portrait) for 16:9 aspect ratio displays* Maximum dimensions - 5120 x 2160 (landscape) or 2160 x 5120 (portrait)* For an **account-level** [OAuth app](https://developers.zoom.us/docs/integrations/create/), this API can only be used on behalf of a user who is assigned with a [role](https://support.zoom.us/hc/en-us/articles/115001078646-Using-role-management#:~:text=Each%20user%20in%20a%20Zoom,owner%2C%20administrator%2C%20or%20member.&amp;text=Role%2Dbased%20access%20control%20enables,needs%20to%20view%20or%20edit.) with **Edit** permission for **Zoom Rooms**.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:update:background_library_content:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"UpdateZoomRoomsBackgroundImageLibraryContent","requestBody":{"content":{"multipart/form-data":{"schema":{"required":["content_id","file"],"type":"object","properties":{"file":{"type":"string","description":"Upload image.\n* JPG/JPEG, 24-bit PNG (no alpha) or GIF (ZR Appliance only).\n* Recommended dimensions - 1920 x 1080 (landscape) or 1080 x 1920 (portrait) for 16:9 aspect ratio displays.\n* Maximum dimensions - 5120 x 2160 (landscape) or 2160 x 5120 (portrait).","format":"binary","example":""},"content_name":{"type":"string","description":"The file content name.","example":"Test.jpg"},"folder_id":{"type":"string","description":"The folder ID.","example":"LHMmOOYaRiOA5m5WZjXVPA"},"content_id":{"type":"string","description":"The file content ID.","example":"zrd9DycNSxK6K4dEUS6z"}}}}}},"responses":{"204":{"description":"**HTTP Status Code:** `204` **OK**\nZoom Rooms background image library content updated successfully."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n "},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:update:background_library_content:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["ZoomRooms:Edit"],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:update:background_library_content:admin"]}},"post":{"tags":["Zoom Rooms Content"],"summary":"Add Zoom Rooms background image library content","description":"Upload an image to Zoom Room Content Library.  \n**Prerequisite:**   The caller must be a Zoom Room licensed user. \n**Note:**  * Base URL: `https://fileapi.zoom.us/v2/`.  \n* Rate limit: 20 requests per second per user or 2000 requests per second per IP address. \n* The caller must support HTTP 30x redirects. \n* The caller must retain the Authorization header when redirected to a different hostname. \n* JPG/JPEG, 24-bit PNG (no alpha) or GIF (ZR Appliance only)\n* Recommended dimensions - 1920 x 1080 (landscape) or 1080 x 1920 (portrait) for 16:9 aspect ratio displays\n* Maximum dimensions - 5120 x 2160 (landscape) or 2160 x 5120 (portrait)\n* Your object size should no more than 10 M\n* For an **account-level** [OAuth app](https://developers.zoom.us/docs/integrations/create/), this API can only be used on behalf of a user who is assigned with a [role](https://support.zoom.us/hc/en-us/articles/115001078646-Using-role-management#:~:text=Each%20user%20in%20a%20Zoom,owner%2C%20administrator%2C%20or%20member.&amp;text=Role%2Dbased%20access%20control%20enables,needs%20to%20view%20or%20edit.) with **Edit** permission for **Zoom Rooms**.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:write:background_library_content:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"AddZoomRoomsBackgroundImageLibraryContent","requestBody":{"content":{"multipart/form-data":{"schema":{"required":["file"],"type":"object","properties":{"file":{"type":"string","description":"Upload image.\n* JPG/JPEG, 24-bit PNG (no alpha) or GIF (ZR Appliance only).\n* Recommended dimensions - 1920 x 1080 (landscape) or 1080 x 1920 (portrait) for 16:9 aspect ratio displays.\n* Maximum dimensions - 5120 x 2160 (landscape) or 2160 x 5120 (portrait).","format":"binary","example":""},"content_name":{"type":"string","description":"The file content name.","example":"Test.jpg"},"folder_id":{"type":"string","description":"The folder ID.","example":"LHMmOOYaRiOA5m5WZjXVPA"}}}}}},"responses":{"201":{"description":"**HTTP Status Code:** `201` **OK**  \n \nZoom Rooms background image library content added successfully.","content":{"application/json":{"schema":{"type":"object","properties":{"content_id":{"type":"string","description":"The file content ID.","example":"zrd9DycNSxK6K4dEUS6z-g"}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n "},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:write:background_library_content:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["ZoomRooms:Edit"],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:write:background_library_content:admin"]}}},"/zrdigitalsignage/files":{"put":{"tags":["Zoom Rooms Content"],"summary":"Update a Digital Signage image or video file","description":"Update an image or video content item in the Zoom Rooms digital signage content library.\n**Note**: * Base URL: https://fileapi.zoom.us/v2/.\n\n**Rate limit**: 20 requests per second per user or 2000 requests per second per IP address.\n\nThe caller must support HTTP 30x redirects.\n\nThe caller must retain the Authorization header when redirected to a different hostname.\nJPG/JPEG, 24-bit PNG (no alpha) or GIF (ZR Appliance only).\n\n**Recommended dimensions**\n - 1920 x 1080 (landscape) or 1080 x 1920 (portrait) for 16:9 aspect ratio displays\nMaximum dimensions - 5120 x 2160 (landscape) or 2160 x 5120 (portrait)\nYour object size should no more than 10 M.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:write:digital_signage_library_contents:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"Updateadigitalsignageimageorvideofile","requestBody":{"content":{"multipart/form-data":{"schema":{"required":["file"],"type":"object","properties":{"file":{"type":"string","description":"Upload image.\nJPG/JPEG, 24-bit PNG (no alpha) or GIF (ZR Appliance only).\nRecommended dimensions - 1920 x 1080 (landscape) or 1080 x 1920 (portrait) for 16:9 aspect ratio displays.\nMaximum dimensions - 5120 x 2160 (landscape) or 2160 x 5120 (portrait).","format":"binary","example":"Vm0wd2QyUXlVWGxWV0d4WFlUSm9WMVl3Wkc5V2JGbDNXa1pPVlUxV2NIcFhhMXBQVjBaYWMySkVUbGhoTVVwVVZtcEdTMk15U2tWVWJHaG9UV3N3ZUZacVFtRlpWMDE1VTJ0V1ZXSkhhRzlVVmxaM1ZsWmFjVkZ0UmxSTmJFcEpWbTEwVjFWdFNsWlhiR2hYWWxob2VsUlVSbUZrUjA1R1UyMTRVMkpXU2twV2JURXdZVEZrU0ZOclpHcFRSVXBZVkZWYWQxTkdVbFZTYlVaclVsUkdWbFpYZUZOVWJVWTJVbFJHVjFaRmIzZFdha1poVjBaT2NtRkdXbWxoTUhCWlYxWlNSMWxYUmtkV1dHaFlZbGhTV0ZSV2FFTlNiRnBZWlVoa1YwMUVSa1pWYkZKRFZqQXhkVlZ1V2xkaGEzQklWV3BHVDJSV1VuUmpSazVYVWpOb2IxWXhaRFJpTVZGM1RsVmtWbUpyY0ZsWmJGWmhZMVpTVjFkdVpFNVNiRm93V2xWa01GWlhTa2RqUkVaV1ZqTm9kbFpxUmt0ak1rNUhZVVprYUdFelFrbFdWRUpoV1ZkU1YxTnVUbFJpUjFKVVZGUkJkMDFSUFQwPQ=="},"content_id":{"type":"string","description":"The content ID.","example":"zrd9DycNSxK6K4dEUS6z"}}}}}},"responses":{"204":{"description":"**HTTP Status Code:** `204` **No Content** : Zoom Rooms digital signage content updated successfully."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n "},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:write:digital_signage_library_contents:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["DigitalSignage:Edit"],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:write:digital_signage_library_contents:admin"]}},"post":{"tags":["Zoom Rooms Content"],"summary":"Add a digital signage image or video ","description":"Upload an image or video to the Zoom Rooms Digital Signage Content Library.\n**Note**: * Base URL: https://fileapi.zoom.us/v2/\n\n**Rate limit**: 20 requests per second per user or 2000 requests per second per IP address.\nThe caller must support HTTP 30x redirects.\n\nThe caller must retain the Authorization header when redirected to a different hostname.\nJPG/JPEG, 24-bit PNG (no alpha) or GIF (ZR Appliance only)\n\n**Recommended dimensions**:\n\n - 1920 x 1080 (landscape) or 1080 x 1920 (portrait) for 16:9 aspect ratio displays.\nMaximum dimensions - 5120 x 2160 (landscape) or 2160 x 5120 (portrait)\nYour object size should no more than 10 M.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:write:digital_signage_library_contents:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"Adddigitalsignageimageorvideo","requestBody":{"content":{"multipart/form-data":{"schema":{"required":["content_name","file"],"type":"object","properties":{"file":{"type":"string","description":"Upload image.\n* JPG/JPEG, 24-bit PNG (no alpha) or GIF (ZR Appliance only).\n* Recommended dimensions - 1920 x 1080 (landscape) or 1080 x 1920 (portrait) for 16:9 aspect ratio displays.\n* Maximum dimensions - 5120 x 2160 (landscape) or 2160 x 5120 (portrait).","format":"binary","example":""},"content_name":{"type":"string","description":"The file content name.","example":"example.jpg"},"folder_id":{"type":"string","description":"The folder ID.","example":"ry6d7lrSR4qqxC11HQ30lc"}}}}}},"responses":{"201":{"description":"**HTTP Status Code:** `201` **OK**  \n \nZoom Rooms digital signage library content added successfully.","content":{"application/json":{"schema":{"type":"object","properties":{"content_id":{"type":"string","description":"The content item ID.","example":"ulx2iq6lTAOVTflXCrS4LQ"}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n "},"401":{"description":"**HTTP Status Code:** `401` <br>\n Unauthorized  \n\n "},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:write:digital_signage_library_contents:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["DigitalSignage:Edit"],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:write:digital_signage_library_contents:admin"]}}},"/rooms/{roomId}/devices/{deviceId}":{"delete":{"tags":["Zoom Rooms Devices"],"summary":"Delete a Zoom Room user device","description":"Deletes a Zoom Room device.  **Prerequisites:**     * Pro or a higher plan with [Zoom Room](https://zoom.us/zoomrooms) license.   * Account owner or admin permissions.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:delete:device:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"deleteDevice","parameters":[{"name":"roomId","in":"path","description":"The Zoom Room ID.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}},{"name":"deviceId","in":"path","description":"The Mac or Windows device ID. The value of this field can be retrieved from the [**List Zoom Room devices**](/docs/api-reference/zoom-api/methods#operation/listZRDevices) API.","required":true,"schema":{"type":"string","example":"F1C6E9DF-429E-4FA1-85DA-AC95464F3D18"}}],"responses":{"204":{"description":"**HTTP Status Code:** `204` **No Content**  \n \nRoom device service successfully deleted."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `200` <br>\n  <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `4061` <br>\n Room device  service does not exist: {serviceId}. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:delete:device:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:delete:device:admin"]}}},"/rooms/{roomId}/devices/{deviceId}/app_version":{"put":{"tags":["Zoom Rooms Devices"],"summary":"Change Zoom Rooms app version","description":"Use this API to [upgrade or downgrade](https://support.zoom.us/hc/en-us/articles/204675449-Upgrade-or-Downgrade-Zoom-Rooms-Software) the version of your installed Zoom Rooms app on your Mac or Windows device. \n\n**Prerequisites:** \n* A Pro or a higher account with Zoom Rooms. \n* The Zoom Rooms software must be installed on a Mac or a Windows device. This API does not support other devices.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:update:device_app_version:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"changeZoomRoomsAppVersion","parameters":[{"name":"roomId","in":"path","description":"Unique Identifier of the Zoom Room.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}},{"name":"deviceId","in":"path","description":"Unique Identifier of the Mac or the Windows device. The value of this field can be retrieved from the [**List Zoom Room devices**](/docs/api-reference/zoom-api/methods#operation/listZRDevices) API.","required":true,"schema":{"type":"string","example":"qsrpAOJCTm-VPkOf3bHXgw"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"action":{"type":"string","description":"Specify one of the following values for this field:\n\n`upgrade`: Upgrade to the latest Zoom Rooms App Version.  \n \n`downgrade`: Downgrade the Zoom Rooms App Version.  \n \n`cancel`: Cancel an ongoing upgrade or downgrade process.","example":"update","enum":["upgrade","downgrade","cancel"]}}}}}},"responses":{"204":{"description":"**HTTP Status Code:** `204` **No Content**   \n \nRequest processed successfully."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request \n\n **Error Code:** `8001` <br>\n Cannot process this upgrade request. The Zoom Rooms Software in this device is either already up to date or is currently being updated.  <br>  <br> <br>\n**Error Code:** `8002` <br>\n Cannot process the downgrade request. The target version for downgrading is not available or the downgrade process has already been initiated. <br>  <br> <br>\n**Error Code:** `8003` <br>\n The cancel request could not be processed because the Zoom Rooms Software in this device is not being downgraded or upgraded at the moment. The cancel action should only be used to cancel an ongoing upgrade or downgrade process. <br>  <br> <br>\n**Error Code:** `8004` <br>\n A device with the provided Device ID: {deviceId} does not belong to the current room: {roomId}. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:update:device_app_version:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["ZoomRooms:Edit"],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:update:device_app_version:admin"]}}},"/rooms/locations":{"get":{"tags":["Zoom Rooms Location"],"summary":"List Zoom Room locations","description":"A Zoom account owner or a Zoom Room administrator can establish a [location hierarchy](https://support.zoom.us/hc/en-us/articles/115000342983-Zoom-Rooms-Location-Hierarchy) to help manage Zoom Rooms that are spread among a variety of locations. Use this API to list the different location types used for Zoom Rooms in an account.  \n   \n \n**Prerequisites:**\n* Account owner or admin permissions.\n* Zoom Rooms Version 4.0 or higher  \n   \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:read:list_locations:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"listZRLocations","parameters":[{"name":"parent_location_id","in":"query","description":"A unique identifier of the parent location. For instance, if a Zoom Room is located in Floor 1 of Building A, the location of Building A will be the parent location of Floor 1. Use this parameter to filter the response by a specific location hierarchy level.","required":false,"schema":{"type":"string","example":"49D7a0xPQvGQ2DCMZgSe7w"}},{"name":"type","in":"query","description":"Use this field to filter the response by the type of location. The value can be one of the following:\n`country`, `states`, `city`, `campus`, `building`, `floor`. ","required":false,"schema":{"type":"string","example":"states"}},{"name":"page_size","in":"query","description":"The number of records returned within a single API call.","required":false,"schema":{"maximum":300,"type":"integer","example":30,"default":30}},{"name":"next_page_token","in":"query","description":"Use the next page token to paginate through large result sets. A next page token is returned whenever the set of available results exceeds the current page size. This token's expiration period is 15 minutes.","required":false,"schema":{"type":"string","example":"IAfJX3jsOLW7w3dokmFl84zOa0MAVGyMEB2"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` **OK**  \n \nZoom Room locations listed successfully.\n","content":{"application/json":{"schema":{"type":"object","properties":{"locations":{"type":"array","description":"Information about the Zoom Room locations.","items":{"type":"object","properties":{"id":{"type":"string","description":"The location's unique ID.","example":"AAAAAAAAAA"},"name":{"type":"string","description":"The location's name.","example":"BuildingA"},"parent_location_id":{"type":"string","description":"The parent location's unique ID. For example, if a Zoom Room is located in Floor 1 of Building A, the location of Building A will be the parent location of Floor 1 and the `parent_location_id` of Floor 1 will be the ID of Building A. \n\nThe value of `parent_location_id` of the top-level location (`country`) is the Zoom account's ID.","example":"49D7a0xPQvGQ2DCMZgSe7w"},"type":{"type":"string","description":"The type of location: \n* `country` \n* `states` \n* `city` \n* `campus` \n* `building` \n* `floor`","example":"building","enum":["country","states","city","campus","building","floor"]}}}},"next_page_token":{"type":"string","description":"The next page token is used to paginate through large result sets. A next page token will be returned whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes.","example":"At6eWnFZ1FB3arCXnRxqHLXKhbDW18yz2i2"},"page_size":{"type":"integer","description":"The number of records returned with a single API call.","example":30}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request \n\n **Error Code:** `200` <br>\n Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription.<br> <br>\n**Error Code:** `300` <br>\n Location type not exist.<br> <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found \n\n **Error Code:** `4801` <br>\n Location not found:{parent_location_id}. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:read:admin","zoom_rooms:read:list_locations:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["room:read:admin"],"x-granular-scopes":["zoom_rooms:read:list_locations:admin"]}},"post":{"tags":["Zoom Rooms Location"],"summary":"Add a location","description":"Add a location to the [location hierarchial structure(s)](https://support.zoom.us/hc/en-us/articles/115000342983-Zoom-Rooms-Location-Hierarchy) of Zoom Rooms in an account.\n\n**Prerequisites:**\n* Account owner or admin permissions.\n* Zoom Rooms Version 4.0 or higher  \n   \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:write:location:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"addAZRLocation","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Name of the location. The name must be unique and shouldn't have already been used in the same account.","example":"location name"},"parent_location_id":{"type":"string","description":"The location ID of the location that is a level higher from the location that is being added.  \n   \n  For example, to add a City named &quot;City 1&quot; as the child location under a State named &quot;State 1&quot;, you must provide the location ID of &quot;State 1&quot;. This can be retrieved using the [**List Zoom Room locations**](/docs/api-reference/zoom-api/methods#operation/listZRLocations) API.","example":"49D7a0xPQvGQ2DCMZgSe7w"}}}}}},"responses":{"200":{"description":"**HTTP Status Code:** `200` **OK**  \n \nLocation added successfully.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Location ID: Unique Identifier of the location that was added.","example":"tgg7a0xPDvFn2DCnZgBe8k"},"name":{"type":"string","description":"Name of the location.","example":"location name"},"parent_location_id":{"type":"string","description":"Unique Identifier of the parent location.","example":"49D7a0xPQvGQ2DCMZgSe7w"},"type":{"type":"string","description":"Type of location. The value should be one of the following:  \n \n`country`, `states`, `city`, `campus`, `building`, `floor`.","example":"country","enum":["country","states","city","campus","building","floor"]}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `200` <br>\n Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription.<br><br> <br>\n**Error Code:** `300` <br>\n Location name already exists. Try a different location name.<br>\nInvalid parent location id {parent_location_id} <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `4801` <br>\n Location not exist {parent_location_id}. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:write:location:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:write:location:admin"]}}},"/rooms/locations/structure":{"get":{"tags":["Zoom Rooms Location"],"summary":"Get Zoom Room location structure","description":"Get the [location hierarchial structure(s)](https://support.zoom.us/hc/en-us/articles/115000342983-Zoom-Rooms-Location-Hierarchy) applied on the Zoom Rooms in an account.  \n   \n \n**Prerequisites:**  \n \n* Zoom Rooms version 4.0 or higher.\n* Account owner or admin permissions.  \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:read:location_hierarchy:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"getZRLocationStructure","responses":{"200":{"description":"**HTTP Status Code:** `200` **OK**  \n \nZoom Rooms location structure returned successfully.  \n \n","content":{"application/json":{"schema":{"type":"object","properties":{"structures":{"type":"array","description":"Hierarchial structure array of the Zoom Rooms location.","items":{"type":"string","example":"country"}}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `200` <br>\n Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:read:admin","zoom_rooms:read:location_hierarchy:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["room:read:admin"],"x-granular-scopes":["zoom_rooms:read:location_hierarchy:admin"]}},"put":{"tags":["Zoom Rooms Location"],"summary":"Update Zoom Rooms location structure","description":"Update the [location hierarchial structure(s)](https://support.zoom.us/hc/en-us/articles/115000342983-Zoom-Rooms-Location-Hierarchy) applied on the Zoom Rooms in an account.  \n   \n \n**Prerequisites:**  \n \n* Zoom Rooms version 4.0 or higher\n* Account owner or admin permissions  \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:update:location_hierarchy:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"updateZoomRoomsLocationStructure","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"structures":{"type":"array","description":"Location Structure. The value can be either one or a combination of the following strings separated by comma:\n`country`, `state`, `city`, `campus`, `building`, `floor`","items":{"type":"string","example":"country"}}}}}}},"responses":{"204":{"description":"**HTTP Status Code:** `204` **No Content**  \n \nLocation Structure updated successfully."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request \n\n **Error Code:** `2100` <br>\n This sub account has no sip trunk plan <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found \n\n **Error Code:** `2001` <br>\n This account does not exist or does not belong to this master account.<br>This account does not exist or does not belong to you. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:update:location_hierarchy:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:update:location_hierarchy:admin"]}}},"/rooms/locations/{locationId}":{"get":{"tags":["Zoom Rooms Location"],"summary":"Get Zoom Room location profile","description":"Each location type of the [Zoom Rooms location hierarchy](https://support.zoom.us/hc/en-us/articles/115000342983-Zoom-Rooms-Location-Hierarchy) has a profile page with information such as the location name, address, support email, and more. Use this API to retrieve information about a specific Zoom Rooms location type, such as the city location of the Zoom Rooms.\n\n**Prerequisite:**  \n \n* Account owner or admin permission.\n* Zoom Rooms version 4.0 or higher.  \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:read:location:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"getZRLocationProfile","parameters":[{"name":"locationId","in":"path","description":"Unique identifier of the location type. This can be retrieved using the [**List Zoom Room locations**](https://developers.zoom.us/docs/api/rest/reference/zoom-rooms/methods/#operation/listZRLocations) API (ID property in the response).","required":true,"schema":{"type":"string","example":"49D7a0xPQvGQ2DCMZgSe7w"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` **OK**  \n \nZoom Rooms Location Profile returned successfully.","content":{"application/json":{"schema":{"type":"object","properties":{"basic":{"type":"object","properties":{"address":{"type":"string","description":"Address","example":"California, USA"},"description":{"type":"string","description":"Description about the location.","example":"California, USA"},"name":{"type":"string","description":"Name of the location type.","example":"State"},"required_code_to_ext":{"type":"boolean","description":"Require code to exit out of your Zoom Rooms application to switch between other apps.\n","example":true},"room_passcode":{"maxLength":16,"minLength":1,"type":"string","description":"1-16 digit number or characters used to secure your Zoom Rooms application.","example":"975193018"},"support_email":{"type":"string","description":"The email address to be used for reporting Zoom Room issues.\n","format":"email","example":"contact-it@example.com"},"support_phone":{"type":"string","description":"The phone number to be used for reporting Zoom Room issues.\n","example":"18798769876"},"timezone":{"type":"string","description":"Timezone (only returned for location type - city).","example":"Asia/Shanghai"},"parent_location_id":{"type":"string","description":"The parent location id.","example":"_HaPEsvmRNmOL4xF9ODXdw"}}},"setup":{"type":"object","properties":{"apply_background_image_to_all_displays":{"type":"boolean","description":"Apply the same background image to all displays of the Zoom Room. If the value of the this field is true, the `background_image_info` object will only contain and only accept changes to the background image information of `zoom_rooms_display1`.","example":true},"background_image_info":{"type":"array","description":"The background image information for each display. If the value of the `apply_background_image_to_all_displays` field is `true`, this object will only accept changes to the background image information of `zoom_rooms_display1`.","items":{"type":"object","properties":{"display_id":{"type":"string","description":"The id of the display. The value can be one of the following:  \n \n`zoom_rooms_display1`: The display1 of the Zoom Room.  \n \n`zoom_rooms_display2`: The display2 of the Zoom Room.  \n \n`zoom_rooms_display3`: The display3 of the Zoom Room. \n \n`zoom_rooms_display4`: The display4 of the Zoom Room. \n \n`companion_whiteboard`: The display of the Companion Whiteboard. \n \n`companion_zoom_rooms`: The display of the Companion Zoom Room.\n","example":"zoom_rooms_display1","enum":["zoom_rooms_display1","zoom_rooms_display2","zoom_rooms_display3","zoom_rooms_display4","companion_whiteboard","companion_zoom_rooms"]},"content_id":{"type":"string","description":"When the background image is a [background image library content item](https://developers.zoom.us/docs/api/rest/reference/zoom-rooms/methods/#operation/ListZoomRoomsbackgroundimagelibrarycontents) or [default Zoom Rooms background image library content item](https://developers.zoom.us/docs/api/rest/reference/zoom-rooms/methods/#operation/ListDefaultZoomRoomsBackgroundImageLibrarycontents), this field will contain the `content_id`. When a background image has been directly uploaded, this field will be empty.\"","example":"zrd9DycNSxK6K4dEUS6z-g"},"download_url":{"type":"string","description":"The URL where the background image file may be downloaded. This URL will be expire according to the `download_url_ttl`.","example":"https://zoom.us/file/Sq2mdxqRQ9eq7wmD5TFD6g?jwt=eyJ0eXAiOiJKV1QiLCJrIjoiaHRlNU05dDciLCJ6bV9za20iOiJ6bV9vMm0iLCJhbGc"},"download_url_ttl":{"type":"integer","description":"The time to live of the download URL, in seconds. When this field is not present, the link will never expire.","example":3600}}}}}}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `200` <br>\n Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription.<br>\nAccess restricted.<br> <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `4801` <br>\n Location not found: {locationId}. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:read:admin","zoom_rooms:read:location:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["ZoomRooms:Read"],"x-macro-scopes":["room:read:admin"],"x-granular-scopes":["zoom_rooms:read:location:admin"]}},"delete":{"tags":["Zoom Rooms Location"],"summary":"Delete a location","description":"Remove a location from the [location hierarchial structure(s)](https://support.zoom.us/hc/en-us/articles/115000342983-Zoom-Rooms-Location-Hierarchy) of Zoom Rooms in an account.\n\n**Prerequisites:**\n* Account owner or admin permissions.\n* Zoom Rooms Version 4.0 or higher  \n   \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:write:location:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `LIGHT`","operationId":"deleteAZRLocation","parameters":[{"name":"locationId","in":"path","description":"Unique identifier of the location type. This can be retrieved using the [**List Zoom Room locations**](https://developers.zoom.us/docs/api/rest/reference/zoom-rooms/methods/#operation/listZRLocations) (ID property in the response).","required":true,"schema":{"type":"string","example":"49D7a0xPQvGQ2DCMZgSe7w"}}],"responses":{"204":{"description":"**HTTP Status Code:** `204` **No Content**   \n\nLocation deleted successfully."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `200` <br>\n Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription.<br>\n**Access restricted**.<br> <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `4801` <br>\n Location does not exist: {0}. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:write:location:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["ZoomRooms:Edit"],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:write:location:admin"]}},"patch":{"tags":["Zoom Rooms Location"],"summary":"Update Zoom Room location profile","description":"Each location type of the [Zoom Rooms location hierarchy](https://support.zoom.us/hc/en-us/articles/115000342983-Zoom-Rooms-Location-Hierarchy) has a profile page that includes information such as name of the location, address, support email, etc. Use this API to update information about a specific Zoom Rooms location type such as information about the city where the Zoom Rooms is located.\n\n**Prerequisite:**  \n \n* Account owner or admin permission.\n* Zoom Rooms version 4.0 or higher.  \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:update:location:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"updateZRLocationProfile","parameters":[{"name":"locationId","in":"path","description":"Unique Identifier of the location. This can be retrieved from the [**List Zoom Room locations**](https://developers.zoom.us/docs/zoom-rooms/apis/#operation/listZRLocations) API.","required":true,"schema":{"type":"string","example":"49D7a0xPQvGQ2DCMZgSe7w"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"basic":{"type":"object","properties":{"address":{"type":"string","description":"Address. Can only be updated for Campus and Building.","example":"California, USA"},"description":{"type":"string","description":"Description about the location.","example":"Floor-7"},"name":{"type":"string","description":"Name of the location type.","example":"State"},"required_code_to_ext":{"type":"boolean","description":"Require code to exit out of your Zoom Rooms application to switch between other apps.\n","example":true},"room_passcode":{"maxLength":16,"minLength":1,"type":"string","description":"1-16 digit number or characters used to secure your Zoom Rooms application.","example":"975193018"},"support_email":{"type":"string","description":"The email address to be used for reporting Zoom Room issues.\n","format":"email","example":"contact-it@example.com"},"support_phone":{"type":"string","description":"The phone number to be used for reporting Zoom Room issues.\n","example":"18798769876"},"timezone":{"type":"string","description":"Timezone (can only be updated for location type - city).","example":"Asia/Shanghai"}}},"setup":{"type":"object","properties":{"apply_background_image_to_all_displays":{"type":"boolean","description":"Apply the same background image to all displays of the Zoom Room. If the value of the this field is `true`, the `background_image_info` object will only contain and only accept changes to the background image information of `zoom_rooms_display1`.","example":true},"background_image_info":{"type":"array","description":"The background image information for each display. If the value of the `apply_background_image_to_all_displays` field is `true`, this object will only accept changes to the background image information of `zoom_rooms_display1`.","items":{"type":"object","properties":{"display_id":{"type":"string","description":"The id of the display. The value can be one of the following:  \n \n`zoom_rooms_display1`: The display1 of the Zoom Room.  \n \n`zoom_rooms_display2`: The display2 of the Zoom Room.  \n \n`zoom_rooms_display3`: The display3 of the Zoom Room. \n \n`zoom_rooms_display4`: The display4 of the Zoom Room. \n \n`companion_whiteboard`: The display of the Companion Whiteboard. \n \n`companion_zoom_rooms`: The display of the Companion Zoom Room.\n","example":"zoom_rooms_display1","enum":["zoom_rooms_display1","zoom_rooms_display2","zoom_rooms_display3","zoom_rooms_display4","companion_whiteboard","companion_zoom_rooms"]},"content_id":{"type":"string","description":"To set the background image to a [background image library content item](https://developers.zoom.us/docs/api/rest/reference/zoom-rooms/methods/#operation/ListZoomRoomsbackgroundimagelibrarycontents) or [default Zoom Rooms background image library content item](https://developers.zoom.us/docs/api/rest/reference/zoom-rooms/methods/#operation/ListDefaultZoomRoomsBackgroundImageLibrarycontents), set this field to a background image library content item's `content_id`. To reset the background, set the content_id to an empty string.","example":"LHMmOOYaRiOA5m5WZjXVPA"}}}}}}}}}}},"responses":{"204":{"description":"**HTTP Status Code:** `204` **No Content**  Location profile updated successfully."},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:update:location:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:update:location:admin"]}}},"/rooms/locations/{locationId}/location":{"put":{"tags":["Zoom Rooms Location"],"summary":"Change the assigned parent location","description":"An account owner of a Zoom account can establish a [Zoom Rooms Location Hierarchy](https://support.zoom.us/hc/en-us/articles/115000342983-Zoom-Rooms-Location-Hierarchy) to better organize Zoom Rooms spread across various locations. The location can be structured in a hierarchy with Country being the top-level location, followed by city, campus, building, and floor. The location in the lower level in the hierarchy is considered as a child of the location that is a level above in the hierarchy. Use this API to change the parent location of a child location.   \n   \n  For instance, if the location hierarchy is structured in a way where there are two campuses (Campus 1, and Campus 2) in a City and Campus 1 consists of a building named Building 1 with a floor where Zoom Rooms are located, and you would like to rearrange the structure so that Building 1 along with its child locations (floor and Zoom Rooms) are relocated directly under Campus 2 instead of Campus 1, you must provide the location ID of Building 1 in the path parameter of this request and the location ID of Campus 2 as the value of `parent_location_id` in the  request body.  \n   \n \n**Prerequisite:**  \n \n* Account owner or admin permission\n* Zoom Rooms version 4.0 or higher  \n \n\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:update:location:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"changeParentLocation","parameters":[{"name":"locationId","in":"path","required":true,"schema":{"type":"string","example":"49D7a0xPQvGQ2DCMZgSe7w"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"parent_location_id":{"type":"string","description":"Location ID of the new Parent Location under which you the child location will be positioned. This can be retrieved from the [**List Zoom Room locations**](/docs/api-reference/zoom-api/methods#operation/listZRLocations) API.","example":"49D7a0xPQvGQ2DCMZgSe7w"}}}}}},"responses":{"204":{"description":"**HTTP Status Code:** `204` **No Content**  \n \nLocation assigned successfully."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `200` <br>\n Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription.<br> <br>\n**Error Code:** `300` <br>\n Invalid parent location id {parent_location_id}. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `4801` <br>\n Location not found:{parent_location_id}. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:update:location:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:update:location:admin"]}}},"/rooms/locations/{locationId}/settings":{"get":{"tags":["Zoom Rooms Location"],"summary":"Get location settings","description":"Get information on meeting, alert, digital signage or scheduling display settings applied to Zoom Rooms located in a specific location. By default, only **Meeting Settings** are returned. To view only **Alert Settings**, specify `alert` as the value of the `setting_type` query parameter.      **Prerequisites:**   * Zoom Room licenses* Owner or Admin privileges on the Zoom Account.   \n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:read:location_settings:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"getZRLocationSettings","parameters":[{"name":"locationId","in":"path","description":"Unique identifier of the location type. This can be retrieved using the [**List Zoom Room locations**](https://developers.zoom.us/docs/api/rest/reference/zoom-rooms/methods/#operation/listZRLocations) (ID property in the response).","required":true,"schema":{"type":"string","example":"49D7a0xPQvGQ2DCMZgSe7w"}},{"name":"setting_type","in":"query","description":"The type of setting that you would like to retrieve.\n\n`alert`: Alert settings of the Zoom Rooms located in a specific location.\n \n`meeting`: Meeting settings of the Zoom Rooms located in a specific location.\n \n`signage`: Digital Signage settings of the Zoom Rooms located in a specific location.\n\n`scheduling_display`: Scheduling Display settings of the Zoom Rooms located in a specific location.","required":true,"schema":{"type":"string","example":"meeting","default":"meeting"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` **OK**  \n \nZoom Room location settings returned successfully.","content":{"application/json":{"schema":{"oneOf":[{"title":"index0","type":"object","properties":{"meeting_security":{"type":"object","properties":{"encryption_type":{"type":"string","description":"Specifies whether enhanced encryption or [end-to-end encryption](https://support.zoom.us/hc/en-us/articles/360048660871) is being used when starting or a meeting. When using end-to-end encryption, several features (e.g. cloud recording, phone/SIP/H.323 dial-in) will be **automatically disabled**.   \n   \n The value of this field can be one of the following:  \n \n`enhanced_encryption`: Enhanced encryption. Encryption is stored in the cloud if you enable this option.   \n \n\n`e2ee`: [End-to-end encryption](https://support.zoom.us/hc/en-us/articles/360048660871). The encryption key is stored in your local device and can not be obtained by anyone else. Enabling this setting also **disables** the following features: join before host, cloud recording, streaming, live transcription, breakout rooms, polling, 1:1 private chat, and meeting reactions.","example":"e2ee","enum":["enhanced_encryption","e2ee"]},"end_to_end_encrypted_meetings":{"type":"boolean","description":"Allows use of end-to-end encryption for meetings. If set to `true`, the encryption type is specified in `encryption_type` field.","example":true},"auto_security":{"type":"boolean","description":"Whether to require that all meetings are secured with one security option. Require that all meetings are secured with one of the following security options: a passcode, Waiting Room, or &quot;Only authenticated users can join meetings&quot;. If no security option is enabled, Zoom will secure all meetings with Waiting Room.","example":true}}},"zoom_rooms":{"type":"object","properties":{"allow_multiple_content_sharing":{"type":"boolean","description":"Enable multiple participants to [share content simultaneously](https://support.zoom.us/hc/en-us/articles/360017767812-Sharing-Multiple-Screens-in-a-Zoom-Room) by default.","example":true},"audio_device_daily_auto_test":{"type":"boolean","description":"Enable [automated audio test](https://support.zoom.us/hc/en-us/articles/360000319683-Zoom-Rooms-Daily-Audio-Testing) to ensure high quality audio.","example":true},"auto_accept_incoming_call_and_fecc":{"type":"boolean","description":"Automatically accept incoming calls made from other Zoom Rooms or contacts in your account. Enabling this setting will also automatically allow far-end camera control.\n\nThis setting is returned only for location type - &quot;country&quot;.","example":true},"auto_direct_sharing":{"type":"boolean","description":"Enable participants in a Zoom Room to share their laptop screen on the Zoom Room TV without entering a meeting ID or sharing code.","example":true},"auto_start_scheduled_meeting":{"type":"boolean","description":"Automatically start scheduled meetings according to the start time listed on the calendar associated with the room. A meeting alert will appear 10 minutes prior to the scheduled time on the TV.","example":true},"auto_stop_scheduled_meeting":{"type":"boolean","description":"Automatically stop the meeting at the end time as scheduled and listed in the calendar associated with the room. ","example":true},"count_attendees_number_in_room":{"type":"boolean","description":"Use facial detection technology to [determine and display the attendees count](https://support.zoom.us/hc/en-us/articles/360031027111-Count-Attendees-in-Zoom-Rooms) after meetings on Dashboard.\n","example":true},"display_feedback_survey":{"type":"boolean","description":"Display a [survey](https://support.zoom.us/hc/en-us/articles/214193146-End-of-Meeting-Attendee-Feedback) at the end of each meeting regarding the audio and video quality on the Zoom Rooms Controller.","example":true},"display_meeting_list":{"type":"boolean","description":" Show the same information on the TV that is shown on the controller.","example":true},"display_top_banner":{"type":"boolean","description":"Allow to display room name, time and sharing key on the top portion of TV.","example":true},"encrypt_shared_screen_content":{"type":"boolean","description":"Encrypt screen and content shared in meetings.","example":true},"hide_id_for_private_meeting":{"type":"boolean","description":"If enabled, the meeting host and meeting ID (in addition to the meeting topic) are hidden from the Zoom Rooms display for private meetings. This affects meetings that were originally scheduled as private, as well as public meetings that were transformed to private.","example":true},"hide_self_view":{"type":"boolean","description":"If enabled, you will not see your own video but other people in the meeting can still see your video.\n\nThis setting is returned only for location type - &quot;country&quot;.","example":true},"lock_speaker_volume_control":{"type":"boolean","description":"Lock speaker volume control on controller.\n\nThis setting is returned only for location type - &quot;country&quot;.","example":true},"send_whiteboard_to_internal_contact_only":{"type":"boolean","description":"Restrict[ sending Whiteboard sessions](https://support.zoom.us/hc/en-us/articles/115004797286-Using-the-Whiteboard-in-Zoom-Rooms-for-Touch#h_781274b3-5237-4320-8826-be2120b00e21) to contacts or internal users only.","example":true},"show_alert_before_meeting":{"type":"boolean","description":"If enabled, the upcoming meeting alert message will be shown on the TV display. The value of the `upcoming_meeting_alert` field should be set to `true` to use this field. ","example":true},"show_call_history_in_room":{"type":"boolean","description":"Allow users to see call history of joined meetings and phone calls from the Zoom Rooms controller.\n","example":true},"show_contact_list_on_controller":{"type":"boolean","description":"If enabled, you can invite participants from the contact list during a meeting or when starting a meeting","example":true},"show_non_video_participants":{"type":"boolean","description":"When enabled, meeting participants that are audio only or have their video turned off will also be shown on the Zoom Rooms display by default.","example":true},"start_airplay_manually":{"type":"boolean","description":"Require the AirPlay service to be [started by an administrator](https://support.zoom.us/hc/en-us/articles/204726885-Screen-Share-Using-Airplay-Mirroring#h_a342ad38-4e46-47a8-a1d9-cded3b144b39) rather than always being available.","example":true},"start_airplay_mirroring":{"type":"boolean","description":"Allow users to share content via Apple Screen Mirroring (called Airplay on iOS 11 or earlier) in Zoom Rooms","example":true},"start_hdmi_content_share_manualy":{"type":"boolean","description":"Disable automatic detection and enable manual content sharing from a device to a Zoom Room. Learn more [here](https://support.zoom.us/hc/en-us/articles/201504265-Wired-HDMI-Screen-Share-via-Capture-Device).\n\nThis setting is returned only for location type - &quot;country&quot;.","example":true},"support_join_3rd_party_meeting":{"type":"boolean","description":"Integrate with Skype for Business, GoToMeeting, or WebEx and show the meeting dial-in button on the meeting list tab for Zoom Rooms Controllers.","example":true},"transform_meeting_to_private":{"type":"boolean","description":"If enabled, all meetings in this room will be treated as [private meetings](https://support.zoom.us/hc/en-us/articles/115001051063-Zoom-Rooms-Private-Meetings), and the Zoom Room will display &quot;Your Name's Meeting&quot; instead of the real meeting topic.","example":true},"upcoming_meeting_alert":{"type":"boolean","description":"If enabled, a reminder will display 10 minutes prior to the next scheduled meeting on the controller.","example":true},"voice_commands":{"type":"boolean","description":"Enable [voice commands](https://support.zoom.us/hc/en-us/articles/115000527983-Voice-Command-with-Zoom-Rooms) with Zoom Rooms.","example":true},"weekly_system_restart":{"type":"boolean","description":"[Restart](https://support.zoom.us/hc/en-us/articles/205418949-Zoom-Rooms-Weekly-System-Restart) the Zoom Rooms computer and controller once a week.","example":true},"incoming_meeting_request":{"type":"object","properties":{"automatically_accept_incoming_meeting_request":{"type":"boolean","description":"If enabled, the Zoom Room will automatically accept incoming meeting requests (calls), such as being invited to a meeting in progress","example":true},"automatically_unmute":{"type":"boolean","description":"If enabled, the Zoom Room will automatically unmute after it automatically accepts the incoming meeting request and joins the meeting","example":true}}},"automatically_accept_far_end_camera_control_request":{"type":"boolean","description":"If enabled, the Zoom Room will automatically accept incoming far end camera control (FECC) requests from other Zoom clients received during a Zoom meeting","example":true}}}}},{"title":"index1","type":"object","properties":{"client_alert":{"type":"object","properties":{"detect_bluetooth_microphone_error_alert":{"type":"boolean","description":"Display an alert message when an issue is detected with a bluetooth microphone.","example":true},"detect_bluetooth_speaker_error_alert":{"type":"boolean","description":"Display an alert message when an issue is detected with a bluetooth speaker.","example":true},"detect_camera_error_alert":{"type":"boolean","description":"Display an alert message when an issue is detected with a camera.","example":true},"detect_microphone_error_alert":{"type":"boolean","description":"Display an alert message when an issue is detected with microphone.","example":true},"detect_speaker_error_alert":{"type":"boolean","description":"Display an alert message when an issue is detected with a speaker.","example":true},"cpu_usage_high_detected_notification_on_zr_display":{"type":"boolean","description":"Display a notification message on the Zoom Room display when CPU usage is above 90%.","example":true},"network_unstable_detected_notification_on_zr_display":{"type":"boolean","description":"Display a notification message on the Zoom Room display low bandwidth network is detected","example":true}},"description":"The Client Alert Settings section includes alerts that display on the TV screen of the Zoom Room. Disable these settings if you have deliberately disconnected one or more peripheral devices or have never enabled them. "},"digital_signage":{"type":"object","properties":{"banner":{"type":"object","properties":{"banner_room_name":{"type":"boolean","description":"Display or hide banner room name.","example":true},"banner_sharing_key":{"type":"boolean","description":"Display or hide banner sharing key.","example":true},"banner_time":{"type":"boolean","description":"Display or hide time in the banner.","example":true}},"description":"Specifies the elements that you want to display in the top banner."},"display_period":{"type":"object","properties":{"start_displaying_content":{"type":"integer","description":"Start displaying digital signage content after certain duration after the meeting ends. The value of this field indicates the duration in minutes.","example":1},"stop_displaying_content":{"type":"integer","description":"Stop displaying content {certain_duration} before a meeting is scheduled to begin. The value of this field indicates the duration in minutes.","example":1}},"description":"Display period object lets you define the number of minutes before or after the scheduled meeting time you would like the content to display."},"enable_digital_signage":{"type":"boolean","description":"[Indicates whether digital signage is on or off,](https://support.zoom.us/hc/en-us/articles/360000030683-Zoom-Rooms-digital-signage#h_767fbb33-82a8-45a8-8392-a1bfa9687edd).   \n \n`true`: enable  \n  `false`: disable","example":true},"layout":{"type":"string","description":"Set the [layout](https://support.zoom.us/hc/en-us/articles/360000030683-Zoom-Rooms-digital-signage#h_4e25ddf3-8f97-4957-8f8b-99725f940fa7). The value of this field can be either `standard` or `video_content`.\n\n`standard`: Standard Center  \n \n`video_content`: Video + Content","example":"standard"},"mute":{"type":"boolean","description":"Sound of all contents will be muted if the value of this field is set to `true`.","example":true},"play_list":{"maxItems":2,"type":"array","description":"Content list.","items":{"type":"object","properties":{"action":{"type":"string","description":"Specify an action for the content list. The value can be one of the following:  \n \n`add`: Add another content list.  \n \n`update`: Update existing content list.  \n \n`delete`: Delete content list.\n","example":"update","enum":["add","update","delete"]},"contents":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"content_id":{"type":"string","description":"Content Id.","example":"blKfsfQ-QSW7V_LPjZrIdg"},"duration":{"type":"integer","description":"Duration for how long the content will be displayed.","example":65},"id":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"},"name":{"type":"string","description":"Name of the content.","example":"content name"},"order":{"type":"integer","description":"Order of the content in the display.","example":1}},"description":"Content list."}},"end_time":{"type":"string","description":"Specify the display end time for the content list in GMT.","example":"2021-03-18T05:41:36Z"},"id":{"type":"string","description":"Unique identifier of the content list. This field is only required if you would like to remove or update the content list.","example":"blKfsfQ-QSW7V_LPjZrIdg"},"name":{"type":"string","description":"Name of the content list.","example":"content name"},"start_time":{"type":"string","description":"Specify the display start time for the content list in GMT.","example":"2021-03-18T05:41:36Z"}}}}}},"notification":{"type":"object","properties":{"audio_meet_usability_threshold":{"type":"boolean","description":"Send an alert when the audio echo test result meets usability threshold.","example":true},"audio_not_meet_usability_threshold":{"type":"boolean","description":"Send an alert when the audio echo test result does not meet usability threshold.","example":true},"battery_is_charging":{"type":"boolean","description":"Send an alert when the battery starts charging.","example":true},"battery_low_and_not_charging":{"type":"boolean","description":"Send an alert when the battery of the controller or the scheduling display is low (at 20%) and is not being charged.","example":true},"battery_percentage":{"type":"string","description":"Specify a percentage so that an alert is sent when the battery is less than the {battery_percentage} that you specified.","example":"90"},"controller_scheduling_disconnected":{"type":"boolean","description":"Send an alert when the connection to the Controller or Scheduling Display cannot be detected.","example":true},"controller_scheduling_reconnected":{"type":"boolean","description":"Send an alert when the Controller or Scheduling Display can be detected again.","example":true},"cpu_usage_high_detected":{"type":"boolean","description":"Send an alert when CPU usage is above 90%.","example":true},"mic_speaker_camera_disconnected":{"type":"boolean","description":"Send an alert when the mic, speaker or camera is disconnected in the Zoom Room.","example":true},"mic_speaker_camera_reconnected":{"type":"boolean","description":"Send an alert when the mic, speaker or camera is reconnected.","example":true},"network_unstable_detected":{"type":"boolean","description":"Send an alert when low bandwidth network is detected","example":true},"sip_registration_failed":{"type":"boolean","description":"Send an alert when SIP registration stops working. ","example":true},"sip_registration_re_enabled":{"type":"boolean","description":"Send an alert after the SIP registration is re-enabled.","example":true},"zoom_room_come_back_online":{"type":"boolean","description":"Send an alert when the Zoom Room is online after previously being offline.","example":true},"zoom_room_display_disconnected":{"type":"boolean","description":"Send an alert when the TV display is disconnected","example":true},"zoom_room_offline":{"type":"boolean","description":"Send an alert when the machine hosting the Zoom Room application has a network issue or cannot connect with the Controller.","example":true}},"description":"[Notifications Settings](https://support.zoom.us/hc/en-us/articles/205394099-Zoom-Room-Alerts#h_b430b5f2-5150-4522-9c96-c77f22ab70bc) includes the circumstances in which the room sends an email alert to the support team to notify them of a potentially urgent issue. These issues can affect the operation of the room, but do not display on the TV screen. The email alert is sent to the email address specified in the Notification Email Recipients section. "},"scheduling_display":{"type":"object","properties":{"instant_room_reservation":{"type":"boolean","description":"If enabled, the Zoom Room Scheduling Display will allow a user to perform an instant room reservation on the device.","example":true},"reserve_other_rooms":{"type":"object","properties":{"allow_to_reserve_other_rooms":{"type":"boolean","description":"If enabled, the Zoom Room Scheduling Display will allow a user to perform instant room reservations of other rooms on the device.","example":true},"location_types":{"type":"string","description":"The Zoom Room Scheduling Display will allow a user to find other rooms to reserve in the same parent Zoom Rooms Location Hierarchy Location as this device, and higher Location levels if so configured. Use the API [Get Zoom Room Location Structure](https://developers.zoom.us/docs/api/rest/reference/zoom-rooms/methods/#operation/getZRLocationStructure) to determine valid Location levels.","example":"floor","enum":["city","campus","building","floor"]}},"description":"Contains settings that allows Zoom Room Scheduling Display to reserve other Zoom Rooms."},"set_scheduling_display_background_image_to_zoom_room_background":{"type":"boolean","description":"If enabled, the Zoom Room Scheduling Display will use the same background image as the Zoom Room. Note: Some Zoom Rooms Scheduling displays use a different display aspect ratio than standard 16:9; the background image will be scaled to fit the Scheduling Display's display, with any excess cropped.","example":true},"home_screen_theme":{"type":"string","description":"The Zoom Room Scheduling Display UI theme.","example":"compact","enum":["standard","compact"]},"home_screen_qr_code_url":{"type":"string","description":"If the Zoom Rooms Scheduling Display home screen theme is \"compact\", a space is reserved for a QR code to be displayed. You may optionally provide a URL which Zoom will use to automatically generate the corresponding QR code image. If you provide a URL that exceeds 100 characters in total length, Zoom will automatically use the Zoom URL shortening service to generate a shortened URL that will redirect to your actual URL; the URL is shortened to increase QR code scan reliability. This setting has no effect if the home screen theme is \"standard\".","example":"https://example.com"},"home_screen_qr_code_supporting_text":{"type":"string","description":"If the Zoom Rooms Scheduling Display home screen theme is \"compact\", a space is reserved for additional text to appear adjacent to the space reserved for a QR code. This setting has no effect if the home screen theme is \"standard\".","example":"Scan to reserve"}},"description":"Scheduling Display Settings section includes performing Zoom Room reservations and setting the home screen theme on the Scheduling Display device."}}}]}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request \n\n **Error Code:** `200` <br>\n Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription.<br>\nAccess Restricted. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found \n\n **Error Code:** `4801` <br>\n Location not found: {locationId} <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:read:admin","zoom_rooms:read:location_settings:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["ZoomRooms:Read"],"x-macro-scopes":["room:read:admin"],"x-granular-scopes":["zoom_rooms:read:location_settings:admin"]}},"patch":{"tags":["Zoom Rooms Location"],"summary":"Update location settings","description":"Update meeting, alert, digital signage or scheduling display settings applied to Zoom Rooms located in a specific location. To update **Alert Settings**, specify `alert` as the value of the `setting_type` query parameter. Similarly, to update **Meeting Settings**, specify `meeting` as the value of the `setting_type` query parameter.      \n\n**Prerequisites:**   * Zoom Room licenses* Owner or Admin privileges on the Zoom Account.   \n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:update:location_settings:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"updateZRLocationSettings","parameters":[{"name":"locationId","in":"path","description":"Unique identifier of the location type. This can be retrieved using the [**List Zoom Room locations**](https://developers.zoom.us/docs/api/rest/reference/zoom-rooms/methods/#operation/getZRLocationSettings) (ID property in the response).","required":true,"schema":{"type":"string","example":"49D7a0xPQvGQ2DCMZgSe7w"}},{"name":"setting_type","in":"query","description":"The type of setting that you would like to update.  \n\n`alert`: Alert settings of the Zoom Rooms located in a specific location.\n \n`meeting`: Meeting settings of the Zoom Rooms located in a specific location.\n \n`signage`: Digital Signage settings of the Zoom Rooms located in a specific location.\n\n`scheduling_display`: Scheduling Display settings of the Zoom Rooms located in a specific location.","required":true,"schema":{"type":"string","example":"meeting","default":"meeting"}}],"requestBody":{"content":{"application/json":{"schema":{"oneOf":[{"title":"index0","type":"object","properties":{"meeting_security":{"type":"object","properties":{"encryption_type":{"type":"string","description":"Choose between enhanced encryption and [end-to-end encryption](https://support.zoom.us/hc/en-us/articles/360048660871) when starting or a meeting. When using end-to-end encryption, several features (e.g. cloud recording, phone/SIP/H.323 dial-in) will be **automatically disabled**.   \n   \n The value of this field can be one of the following:  \n \n`enhanced_encryption`: Enhanced encryption. Encryption is stored in the cloud if you enable this option.   \n \n\n`e2ee`: [End-to-end encryption](https://support.zoom.us/hc/en-us/articles/360048660871). The encryption key is stored in your local device and can not be obtained by anyone else. Enabling this setting also **disables** the following features: join before host, cloud recording, streaming, live transcription, breakout rooms, polling, 1:1 private chat, and meeting reactions.","example":"e2ee","enum":["enhanced_encryption","e2ee"]},"end_to_end_encrypted_meetings":{"type":"boolean","description":"Allow use of end-to-end encryption for meetings. If set to `true`, you can specify the encryption type in `encryption_type` field.","example":true},"auto_security":{"type":"boolean","description":"Whether to require that all meetings are secured with one security option. Require that all meetings are secured with one of the following security options: a passcode, Waiting Room, or &quot;Only authenticated users can join meetings&quot;. If no security option is enabled, Zoom will secure all meetings with Waiting Room.","example":true}}},"zoom_rooms":{"type":"object","properties":{"allow_multiple_content_sharing":{"type":"boolean","description":"Enable multiple participants to [share content simultaneously](https://support.zoom.us/hc/en-us/articles/360017767812-Sharing-Multiple-Screens-in-a-Zoom-Room) by default.","example":true},"audio_device_daily_auto_test":{"type":"boolean","description":"Enable [automated audio test](https://support.zoom.us/hc/en-us/articles/360000319683-Zoom-Rooms-Daily-Audio-Testing) to ensure high quality audio.","example":true},"auto_accept_incoming_call_and_fecc":{"type":"boolean","description":"Automatically accept incoming calls made from other Zoom Rooms or contacts in your account. Enabling this setting will also automatically allow far-end camera control.\n\nThis setting is returned only for location type - &quot;country&quot;.","example":true},"auto_direct_sharing":{"type":"boolean","description":"Enable participants in a Zoom Room to share their laptop screen on the Zoom Room TV without entering a meeting ID or sharing code.","example":true},"auto_start_scheduled_meeting":{"type":"boolean","description":"Automatically start scheduled meetings according to the start time listed on the calendar associated with the room. A meeting alert will appear 10 minutes prior to the scheduled time on the TV.","example":true},"auto_stop_scheduled_meeting":{"type":"boolean","description":"Automatically stop the meeting at the end time as scheduled and listed in the calendar associated with the room. ","example":true},"count_attendees_number_in_room":{"type":"boolean","description":"Use facial detection technology to [determine and display the attendees count](https://support.zoom.us/hc/en-us/articles/360031027111-Count-Attendees-in-Zoom-Rooms) after meetings on Dashboard.\n","example":true},"display_feedback_survey":{"type":"boolean","description":"Display a [survey](https://support.zoom.us/hc/en-us/articles/214193146-End-of-Meeting-Attendee-Feedback) at the end of each meeting regarding the audio and video quality on the Zoom Rooms Controller.","example":true},"display_meeting_list":{"type":"boolean","description":" Show the same information on the TV that is shown on the controller.","example":true},"display_top_banner":{"type":"boolean","description":"Allow to display room name, time and sharing key on the top portion of TV.","example":true},"encrypt_shared_screen_content":{"type":"boolean","description":"Encrypt screen and content shared in meetings.","example":true},"hide_id_for_private_meeting":{"type":"boolean","description":"If enabled, the meeting host and meeting ID (in addition to the meeting topic) are hidden from the Zoom Rooms display for private meetings. This affects meetings that were originally scheduled as private, as well as public meetings that were transformed to private.","example":true},"hide_self_view":{"type":"boolean","description":"If enabled, you will not see your own video but other people in the meeting can still see your video.\n\nThis setting is returned only for location type - &quot;country&quot;.","example":true},"lock_speaker_volume_control":{"type":"boolean","description":"Lock speaker volume control on controller.\n\nThis setting is returned only for location type - &quot;country&quot;.","example":true},"send_whiteboard_to_internal_contact_only":{"type":"boolean","description":"Restrict[ sending Whiteboard sessions](https://support.zoom.us/hc/en-us/articles/115004797286-Using-the-Whiteboard-in-Zoom-Rooms-for-Touch#h_781274b3-5237-4320-8826-be2120b00e21) to contacts or internal users only.","example":true},"show_alert_before_meeting":{"type":"boolean","description":"If enabled, the upcoming meeting alert message will be shown on the TV display. The value of the `upcoming_meeting_alert` field should be set to `true` to use this field. ","example":true},"show_call_history_in_room":{"type":"boolean","description":"Allow users to see call history of joined meetings and phone calls from the Zoom Rooms controller.\n","example":true},"show_contact_list_on_controller":{"type":"boolean","description":"If enabled, you can invite participants from the contact list during a meeting or when starting a meeting","example":true},"show_non_video_participants":{"type":"boolean","description":"When enabled, meeting participants that are audio only or have their video turned off will also be shown on the Zoom Rooms display by default.","example":true},"start_airplay_manually":{"type":"boolean","description":"Require the AirPlay service to be [started by an administrator](https://support.zoom.us/hc/en-us/articles/204726885-Screen-Share-Using-Airplay-Mirroring#h_a342ad38-4e46-47a8-a1d9-cded3b144b39) rather than always being available.","example":true},"start_airplay_mirroring":{"type":"boolean","description":"Allow users to share content via Apple Screen Mirroring (called Airplay on iOS 11 or earlier) in Zoom Rooms","example":true},"start_hdmi_content_share_manualy":{"type":"boolean","description":"Disable automatic detection and enable manual content sharing from a device to a Zoom Room. Learn more [here](https://support.zoom.us/hc/en-us/articles/201504265-Wired-HDMI-Screen-Share-via-Capture-Device).\n\nThis setting is returned only for location type - &quot;country&quot;.","example":true},"support_join_3rd_party_meeting":{"type":"boolean","description":"Integrate with Skype for Business, GoToMeeting, or WebEx and show the meeting dial-in button on the meeting list tab for Zoom Rooms Controllers.","example":true},"transform_meeting_to_private":{"type":"boolean","description":"If enabled, all meetings in this room will be treated as [private meetings](https://support.zoom.us/hc/en-us/articles/115001051063-Zoom-Rooms-Private-Meetings), and the Zoom Room will display &quot;Your Name's Meeting&quot; instead of the real meeting topic.","example":true},"upcoming_meeting_alert":{"type":"boolean","description":"If enabled, a reminder will display 10 minutes prior to the next scheduled meeting on the controller.","example":true},"voice_commands":{"type":"boolean","description":"Enable [voice commands](https://support.zoom.us/hc/en-us/articles/115000527983-Voice-Command-with-Zoom-Rooms) with Zoom Rooms.","example":true},"weekly_system_restart":{"type":"boolean","description":"[Restart](https://support.zoom.us/hc/en-us/articles/205418949-Zoom-Rooms-Weekly-System-Restart) the Zoom Rooms computer and controller once a week.","example":true},"incoming_meeting_request":{"type":"object","properties":{"automatically_accept_incoming_meeting_request":{"type":"boolean","description":"If enabled, the Zoom Room will automatically accept incoming meeting requests (calls), such as being invited to a meeting in progress","example":true},"automatically_unmute":{"type":"boolean","description":"If enabled, the Zoom Room will automatically unmute after it automatically accepts the incoming meeting request and joins the meeting","example":true}}},"automatically_accept_far_end_camera_control_request":{"type":"boolean","description":"If enabled, the Zoom Room will automatically accept incoming far end camera control (FECC) requests from other Zoom clients received during a Zoom meeting","example":true}}}}},{"title":"index1","type":"object","properties":{"client_alert":{"type":"object","properties":{"detect_bluetooth_microphone_error_alert":{"type":"boolean","description":"Display an alert message when an issue is detected with a bluetooth microphone.","example":true},"detect_bluetooth_speaker_error_alert":{"type":"boolean","description":"Display an alert message when an issue is detected with a bluetooth speaker.","example":true},"detect_camera_error_alert":{"type":"boolean","description":"Display an alert message when an issue is detected with a camera.","example":true},"detect_microphone_error_alert":{"type":"boolean","description":"Display an alert message when an issue is detected with microphone.","example":true},"detect_speaker_error_alert":{"type":"boolean","description":"Display an alert message when an issue is detected with a speaker.","example":true},"cpu_usage_high_detected_notification_on_zr_display":{"type":"boolean","description":"Display a notification message on the Zoom Room display when CPU usage is above 90%.","example":true},"network_unstable_detected_notification_on_zr_display":{"type":"boolean","description":"Display a notification message on the Zoom Room display low bandwidth network is detected","example":true}},"description":"The Client Alert Settings section includes alerts that display on the TV screen of the Zoom Room. Disable these settings if you have deliberately disconnected one or more peripheral devices or have never enabled them. "},"digital_signage":{"type":"object","properties":{"banner":{"type":"object","properties":{"banner_room_name":{"type":"boolean","example":true},"banner_sharing_key":{"type":"boolean","example":true},"banner_time":{"type":"boolean","example":true}}},"display_period":{"type":"object","properties":{"start_displaying_content":{"type":"integer","description":"Start displaying digital signage content after certain duration after the meeting ends. Specify the value of the duration in minutes in this field.","example":1},"stop_displaying_content":{"type":"integer","description":"Stop displaying content {certain_duration} before a meeting is scheduled to begin. Specify the value of duration in minutes in this field.","example":1}},"description":"Display period object lets you define the number of minutes before or after the scheduled meeting time you would like the content to display."},"enable_digital_signage":{"type":"boolean","description":"[Enable or disable digital signage](https://support.zoom.us/hc/en-us/articles/360000030683-Zoom-Rooms-digital-signage#h_767fbb33-82a8-45a8-8392-a1bfa9687edd).   \n \n`true`: enable  \n  `false`: disable","example":true},"layout":{"type":"string","description":"Set the [layout](https://support.zoom.us/hc/en-us/articles/360000030683-Zoom-Rooms-digital-signage#h_4e25ddf3-8f97-4957-8f8b-99725f940fa7). The value of this field can be either `standard` or `video_content`.\n\n`standard`: Standard Center  \n \n`video_content`: Video + Content","example":"standard"},"mute":{"type":"boolean","description":"Sound of all contents will be muted if the value of this field is set to `true`.","example":true},"play_list":{"maxItems":2,"type":"array","description":"Content list.","items":{"type":"object","properties":{"action":{"type":"string","description":"Specify an action for the content list. The value can be one of the following:  \n \n`add`: Add another content list.  \n \n`update`: Update existing content list.  \n \n`delete`: Delete content list.\n","example":"update","enum":["add","update","delete"]},"contents":{"maxItems":3,"type":"array","items":{"type":"object","properties":{"action":{"type":"string","description":"Specify an action for the content in the content list. The value can be one of the following:  \n \n`add`: Add another content to the content list.  \n \n`update`: Update existing content's information in the content list.  \n \n`delete`: Delete content from the content list.\n\n","example":"update"},"content_id":{"type":"string","description":"Content Id.","example":"blKfsfQ-QSW7V_LPjZrIdg"},"duration":{"type":"integer","description":"By default each content is display for 5 seconds. Using this field, specify how long you would like to display the content.","example":65},"id":{"type":"string","description":"Unique identifier of the content. This field is only required if you would like to remove or update the content information.","example":"blKfsfQ-QSW7V_LPjZrIdg"},"name":{"type":"string","description":"Name of the content.","example":"content name"},"order":{"type":"integer","description":"Order of the content in the display.","example":1}},"description":"Content list."}},"end_time":{"type":"string","description":"Specify the display end time for the content list in GMT.","example":"2021-03-18T05:41:36Z"},"id":{"type":"string","description":"Unique identifier of the content list. This field is only required if you would like to remove or update the content list.","example":"blKfsfQ-QSW7V_LPjZrIdg"},"name":{"type":"string","description":"Name of the content list.","example":"content list"},"start_time":{"type":"string","description":"Specify the display start time for the content list in GMT.","example":"2021-03-18T05:41:36Z"}}}}}},"notification":{"type":"object","properties":{"audio_meet_usability_threshold":{"type":"boolean","description":"Send an alert when the audio echo test result meets usability threshold.","example":true},"audio_not_meet_usability_threshold":{"type":"boolean","description":"Send an alert when the audio echo test result does not meet usability threshold.","example":true},"battery_is_charging":{"type":"boolean","description":"Send an alert when the battery starts charging.","example":true},"battery_low_and_not_charging":{"type":"boolean","description":"Send an alert when the battery of the controller or the scheduling display is low (at 20%) and is not being charged.","example":true},"battery_percentage":{"type":"string","description":"Specify a percentage so that an alert is sent when the battery is less than the {battery_percentage} that you specified.","example":"90"},"controller_scheduling_disconnected":{"type":"boolean","description":"Send an alert when the connection to the Controller or Scheduling Display cannot be detected.","example":true},"controller_scheduling_reconnected":{"type":"boolean","description":"Send an alert when the Controller or Scheduling Display can be detected again.","example":true},"cpu_usage_high_detected":{"type":"boolean","description":"Send an alert when CPU usage is above 90%.","example":true},"mic_speaker_camera_disconnected":{"type":"boolean","description":"Send an alert when the mic, speaker or camera is disconnected in the Zoom Room.","example":true},"mic_speaker_camera_reconnected":{"type":"boolean","description":"Send an alert when the mic, speaker or camera is reconnected.","example":true},"network_unstable_detected":{"type":"boolean","description":"Send an alert when low bandwidth network is detected","example":true},"sip_registration_failed":{"type":"boolean","description":"Send an alert when SIP registration stops working. ","example":true},"sip_registration_re_enabled":{"type":"boolean","description":"Send an alert after the SIP registration is re-enabled.","example":true},"zoom_room_come_back_online":{"type":"boolean","description":"Send an alert when the Zoom Room is online after previously being offline.","example":true},"zoom_room_display_disconnected":{"type":"boolean","description":"Send an alert when the TV display is disconnected","example":true},"zoom_room_offline":{"type":"boolean","description":"Send an alert when the machine hosting the Zoom Room application has a network issue or cannot connect with the Controller.","example":true}},"description":"[Notifications Settings](https://support.zoom.us/hc/en-us/articles/205394099-Zoom-Room-Alerts#h_b430b5f2-5150-4522-9c96-c77f22ab70bc) includes the circumstances in which the room sends an email alert to the support team to notify them of a potentially urgent issue. These issues can affect the operation of the room, but do not display on the TV screen. The email alert is sent to the email address specified in the Notification Email Recipients section. "},"scheduling_display":{"type":"object","properties":{"instant_room_reservation":{"type":"boolean","description":"If enabled, the Zoom Room Scheduling Display will allow a user to perform an instant room reservation on the device.","example":true},"reserve_other_rooms":{"type":"object","properties":{"allow_to_reserve_other_rooms":{"type":"boolean","description":"If enabled, the Zoom Room Scheduling Display will allow a user to perform instant room reservations of other rooms on the device.","example":true},"location_types":{"type":"string","description":"The Zoom Room Scheduling Display will allow a user to find other rooms to reserve in the same parent Zoom Rooms Location Hierarchy Location as this device, and higher Location levels if so configured. Use the API [Get Zoom Room Location Structure](https://developers.zoom.us/docs/api/rest/reference/zoom-rooms/methods/#operation/getZRLocationStructure) to determine valid Location levels.","example":"floor","enum":["city","campus","building","floor"]}},"description":"Contains settings that allows Zoom Room Scheduling Display to reserve other Zoom Rooms."},"set_scheduling_display_background_image_to_zoom_room_background":{"type":"boolean","description":"If enabled, the Zoom Room Scheduling Display will use the same background image as the Zoom Room. Note: Some Zoom Rooms Scheduling displays use a different display aspect ratio than standard 16:9; the background image will be scaled to fit the Scheduling Display's display, with any excess cropped.","example":true},"home_screen_theme":{"type":"string","description":"The Zoom Room Scheduling Display UI theme.","example":"compact","enum":["standard","compact"]},"home_screen_qr_code_url":{"type":"string","description":"If the Zoom Rooms Scheduling Display home screen theme is \"compact\", a space is reserved for a QR code to be displayed. You may optionally provide a URL which Zoom will use to automatically generate the corresponding QR code image. If you provide a URL that exceeds 100 characters in total length, Zoom will automatically use the Zoom URL shortening service to generate a shortened URL that will redirect to your actual URL; the URL is shortened to increase QR code scan reliability. This setting has no effect if the home screen theme is \"standard\".","example":"https://example.com"},"home_screen_qr_code_supporting_text":{"type":"string","description":"If the Zoom Rooms Scheduling Display home screen theme is \"compact\", a space is reserved for additional text to appear adjacent to the space reserved for a QR code. This setting has no effect if the home screen theme is \"standard\".","example":"Scan to reserve"}},"description":"Scheduling Display Settings section includes performing Zoom Room reservations and setting the home screen theme on the Scheduling Display device."}}}]}}}},"responses":{"204":{"description":"**HTTP Status Code:** `204` **No Content**  \n \nLocation settings updated successfully."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request \n\n **Error Code:** `200` <br>\n Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription.<br>\nAccess restricted. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found \n\n **Error Code:** `4801` <br>\n Location not found: {locationId} <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:update:location_settings:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["ZoomRooms:Edit"],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:update:location_settings:admin"]}}},"/rooms/locations/{locationId}/tags":{"patch":{"tags":["Zoom Rooms Tags"],"summary":"Assign Tags to Zoom Rooms By Location ID","description":"Use this API to assign Tags to Zoom Rooms by location ID  **Prerequisites:** * A Pro or a higher plan with a [Zoom Rooms](https://zoom.us/zoomrooms) license.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:update:room_tag:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"AssignTagsToZoomRoomsByLocationID","parameters":[{"name":"locationId","in":"path","description":"The location ID where all Zoom Rooms under this location to be assigned with tags. ","required":false,"schema":{"type":"string","example":"_-F-P0QEQVuilUQ0mSpx6w"}}],"requestBody":{"content":{"application/json":{"schema":{"required":["tag_ids"],"type":"object","properties":{"tag_ids":{"type":"array","description":"The Zoom Rooms Tag IDs to assign to the Zoom Room.","items":{"type":"string","description":"The Zoom Rooms Tag ID to assign to the Zoom Room.","example":"ad82de3afb6d4738a736d13d551afdea"}}}}}}},"responses":{"204":{"description":"**HTTP Status Code:** `204`     Tag(s) assigned to rooms under this location."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `200` <br>\n Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription. <br>\n**Error Code:** `8301` <br>\n General Room Tag API failure error code. <br>\n**Error Code:** `8303` <br>\n Number of Tags per Room exceed 10. <br>\n**Error Code:** `8308` <br>\n Location has No Rooms. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `8307` <br>\n locationId is invalid. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:update:room_tag:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["ZoomRooms:Edit"],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:update:room_tag:admin"]}}},"/rooms/tags":{"get":{"tags":["Zoom Rooms Tags"],"summary":"List all Zoom Room Tags","description":"List all Zoom Rooms Tags  **Prerequisites:** * A Pro or a higher plan with a [Zoom Rooms](https://zoom.us/zoomrooms) license.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:read:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:read:list_tags:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"listZoomRoomTags","parameters":[{"name":"page_size","in":"query","description":"The number of records returned within a single API call.","required":false,"schema":{"type":"integer","example":10,"default":30}},{"name":"next_page_token","in":"query","description":"The next page token is used to paginate through large result sets. A next page token will be returned whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes.","required":true,"schema":{"type":"string","example":"IAfJX3jsOLW7w3dokmFl84zOa0MAVGyMEB2"}}],"responses":{"200":{"description":"**HTTP Status Code:** `200` **OK**  \n \nZoom Rooms Tags resources successfully returned.","content":{"application/json":{"schema":{"type":"object","properties":{"next_page_token":{"type":"string","description":"The next page token is used to paginate through large result sets. A next page token will be returned whenever the set of available results exceeds the current page size. The expiration period for this token is 15 minutes.","example":"At6eWnFZ1FB3arCXnRxqHLXKhbDW18yz2i2"},"page_size":{"type":"integer","description":"The number of records returned within a single API call.","example":30},"tags":{"type":"array","description":"List of current Zoom Room Tags.","items":{"type":"object","properties":{"id":{"type":"string","description":"The Zoom Room Tag ID.","example":"5bfc6df7a11445ef81513b2c3b4c8d5d"},"name":{"type":"string","description":"The name of the Tag.","example":"Sports"},"description":{"type":"string","description":"A short description of the Zoom Room Tag.","example":"A tag for Zoom Rooms for Sports"},"num_of_rooms":{"type":"integer","description":"The number of Zoom Rooms associated with this Tag.","example":11}}}}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `200` <br>\n Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription. <br>\n**Error Code:** `8301` <br>\n General Room Tag API Failure. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:read:admin","zoom_rooms:read:list_tags:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["room:read:admin"],"x-granular-scopes":["zoom_rooms:read:list_tags:admin"]}},"post":{"tags":["Zoom Rooms Tags"],"summary":"Create a new Zoom Rooms Tag","description":"Creates a new Zoom Rooms Tag.  **Prerequisites:** * A Pro or a higher plan with a [Zoom Rooms](https://zoom.us/zoomrooms) license.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:write:tag:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"createZoomRoomTag","requestBody":{"content":{"application/json":{"schema":{"required":["description","name"],"type":"object","properties":{"name":{"type":"string","description":"The name of the Tag.","example":"Sports Room "},"description":{"type":"string","description":"The short description of the Zoom Rooms Tag.","example":"A tag for Zoom Rooms for Sports"}}}}}},"responses":{"201":{"description":"**HTTP Status Code:** `201` **Created**  \n \nZoom Rooms Tag created.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"The Zoom Rooms Tag ID.","example":"5bfc6df7a11445ef81513b2c3b4c8d5d"}}}}}},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `200` <br>\n Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription. <br>\n**Error Code:** `8302` <br>\n * Tag name length is greater than 255 characters. \n* Tag name contains comma (,). \n* Duplicate Tag Name. <br>\n**Error Code:** `8301` <br>\n General Room Tag API Failure. <br>\n**Error Code:** `8303` <br>\n Tag description length is greater than 255 characters. <br>\n**Error Code:** `8304` <br>\n Number of Tags per account exceed 500. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:write:tag:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:write:tag:admin"]}}},"/rooms/tags/{tagId}":{"delete":{"tags":["Zoom Rooms Tags"],"summary":"Delete Tag","description":"Deletes Tag.  **Prerequisites:** * A Pro or a higher plan with a [Zoom Rooms](https://zoom.us/zoomrooms) license.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:delete:tag:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"deleteZoomRoomTag","parameters":[{"name":"tagId","in":"path","description":"The Zoom Room Tag ID to be deleted.","required":true,"schema":{"type":"string","example":"ad82de3afb6d4738a736d13d551afdea"}}],"responses":{"204":{"description":"**HTTP Status Code:** `204`   \n \n Tag deleted."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `200` <br>\n Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription. <br>\n**Error Code:** `8301` <br>\n Request contains empty tag ID. General Room Tag API failure error code. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `8306` <br>\n Tag ID is not exist. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:delete:tag:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:delete:tag:admin"]}},"patch":{"tags":["Zoom Rooms Tags"],"summary":"Edit Tag","description":"Edits Tag.  **Prerequisites:** * A Pro or a higher plan with a [Zoom Rooms](https://zoom.us/zoomrooms) license.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:update:tag:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"editZoomRoomTag","parameters":[{"name":"tagId","in":"path","description":"The Zoom Room Tag ID to be edited.","required":true,"schema":{"type":"string","example":"ad82de3afb6d4738a736d13d551afdea"}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"The new name of the Zoom Rooms Tag to be edit. If provided it must not be empty.","example":"New tag name "},"description":{"type":"string","description":"The new description of the Zoom Rooms Tag to be updated. Optional and can be empty string.","example":"New tag description"}}}}}},"responses":{"204":{"description":"**HTTP Status Code:** `204`   \n \n Tag edit successfully."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `200` <br>\n Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription. <br>\n**Error Code:** `8301` <br>\n General Room Tag API failure. <br>\n**Error Code:** `8305` <br>\n Nothing to update. <br>\n**Error Code:** `8302` <br>\n Tag name illegal. <br>\n**Error Code:** `8303` <br>\n Tag description illegal. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `8306` <br>\n Tag ID is not exist. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:update:tag:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:update:tag:admin"]}}},"/rooms/{roomId}/tags":{"delete":{"tags":["Zoom Rooms Tags"],"summary":"Un-assign Tags from a Zoom Room","description":"Un-assign Tags from a Zoom Room  **Prerequisites:** * A Pro or a higher plan with a [Zoom Rooms](https://zoom.us/zoomrooms) license.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:delete:room_tag:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"unassignZoomRoomTag","parameters":[{"name":"roomId","in":"path","description":"Unique identifier of the Zoom Room. This can be retrieved from the response of the [**List Zoom Rooms**](/docs/api-reference/zoom-api/methods#operation/listZoomRooms) API, this API support both roomId and ID","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}},{"name":"tag_ids","in":"query","description":"The Tag ID(s) to un-assign from the Zoom Room.  Enter `all` to un-assign all tags from a Zoom Room.  Currently, only one Tag ID per request is allowed.","required":true,"schema":{"type":"string","example":"ad82de3afb6d4738a736d13d551afdea"}}],"responses":{"204":{"description":"**HTTP Status Code:** `204`   \n \n Tag(s) un-assigned from Room."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request  \n\n **Error Code:** `200` <br>\n Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription. <br>\n**Error Code:** `8301` <br>\n Empty Request and General Room Tag API failure error code. <br>\n**Error Code:** `8307` <br>\n roomUserId is invalid. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found  \n\n **Error Code:** `1012` <br>\n Room not found: {roomId}. <br>\n**Error Code:** `8306` <br>\n tagId is invalid. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:delete:room_tag:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":[],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:delete:room_tag:admin"]}},"patch":{"tags":["Zoom Rooms Tags"],"summary":"Assign Tags to a Zoom Room","description":"Use this API to assign Tags to a Zoom Room \n\n **Prerequisites:** \n* A Pro or a higher plan with a [Zoom Rooms](https://zoom.us/zoomrooms) license.\n\n**[Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `room:write:admin`\n\n**[Granular Scopes](https://developers.zoom.us/docs/integrations/oauth-scopes-overview/):** `zoom_rooms:update:room_tag:admin`\n\n**[Rate Limit Label](https://marketplace.zoom.us/docs/api-reference/rate-limits#rate-limits):** `MEDIUM`","operationId":"AssignTagsToAZoomRoom","parameters":[{"name":"roomId","in":"path","description":"The unique identifier of the Zoom Room. This can be retrieved from the response of the [**List Zoom Rooms**](/docs/api-reference/zoom-api/methods#operation/listZoomRooms) API, this API support both roomId and ID.","required":true,"schema":{"type":"string","example":"qMOLddnySIGGVycz8aX_JQ"}}],"requestBody":{"content":{"application/json":{"schema":{"required":["tag_ids"],"type":"object","properties":{"tag_ids":{"type":"array","description":"The Zoom Rooms Tag IDs to assign to the Zoom Room.","items":{"type":"string","description":"The Zoom Room Tag ID  to assign to the Zoom Room.","example":"ad82de3afb6d4738a736d13d551afdea"}}}}}}},"responses":{"204":{"description":"**HTTP Status Code:** `204`   \n \n Tag(s) assigned to Room."},"400":{"description":"**HTTP Status Code:** `400` <br>\n Bad Request \n\n **Error Code:** `200` <br>\n Zoom Room subscription not found. Try again after purchasing a Zoom Room subscription. <br>\n**Error Code:** `8307` <br>\n At least 1 roomUserId is invalid. <br>\n**Error Code:** `8301` <br>\n Request contains empty tag ID list and General Room Tag API failure error code. <br>\n**Error Code:** `8305` <br>\n Nothing to update. <br>\n**Error Code:** `8304` <br>\n Number of Tags per account exceed 500. <br>\n**Error Code:** `8308` <br>\n Number of Tags per Room exceed 10. <br>\n"},"404":{"description":"**HTTP Status Code:** `404` <br>\n Not Found \n\n **Error Code:** `1012` <br>\n Room not found: {roomId}. <br>\n**Error Code:** `8306` <br>\n At least 1 tagId is invalid. <br>\n"},"429":{"description":"**HTTP Status Code:** `429` <br>\n Too Many Requests. For more information, see [rate limits](https://developers.zoom.us/docs/api/rest/rate-limits/). \n\n "}},"security":[{"openapi_oauth":["room:write:admin","zoom_rooms:update:room_tag:admin"],"openapi_authorization":[]}],"x-extensions":{"x-permissions":["ZoomRooms:Edit"],"x-macro-scopes":["room:write:admin"],"x-granular-scopes":["zoom_rooms:update:room_tag:admin"]}}}},"components":{"securitySchemes":{"openapi_authorization":{"type":"apiKey","name":"Authorization","in":"header"},"openapi_oauth":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"/","tokenUrl":"","refreshUrl":"","scopes":{"room:write:admin":"room:write:admin","room:master":"room:master","zoom_rooms:write:zoom_apps:admin":"zoom_rooms:write:zoom_apps:admin","visitor_management:write:admin":"visitor_management:write:admin","visitor_management:write:invitation":"visitor_management:write:invitation","visitor_management:write:invitation:admin":"visitor_management:write:invitation:admin","visitor_management:read":"visitor_management:read","visitor_management:read:list_invitations":"visitor_management:read:list_invitations","visitor_management:read:list_invitations:admin":"visitor_management:read:list_invitations:admin","visitor_management:read:invitation_details":"visitor_management:read:invitation_details","visitor_management:read:invitation_details:admin":"visitor_management:read:invitation_details:admin","visitor_management:write":"visitor_management:write","visitor_management:delete:invitation":"visitor_management:delete:invitation","visitor_management:delete:invitation:admin":"visitor_management:delete:invitation:admin","visitor_management:update:invitation":"visitor_management:update:invitation","visitor_management:update:invitation:admin":"visitor_management:update:invitation:admin","visitor_management:write:check_in":"visitor_management:write:check_in","visitor_management:write:check_in:admin":"visitor_management:write:check_in:admin","workspace:read":"workspace:read","workspace:read:admin":"workspace:read:admin","workspace:read:list_workspaces":"workspace:read:list_workspaces","workspace:read:list_workspaces:admin":"workspace:read:list_workspaces:admin","workspace:write:admin":"workspace:write:admin","workspace:write:workspace:admin":"workspace:write:workspace:admin","workspace:write:asset:admin":"workspace:write:asset:admin","workspace:read:asset:admin":"workspace:read:asset:admin","workspace:update:asset:admin":"workspace:update:asset:admin","workspace:delete:asset:admin":"workspace:delete:asset:admin","workspace:write:events":"workspace:write:events","workspace:write:events:admin":"workspace:write:events:admin","workspace:write:location":"workspace:write:location","workspace:write:location:admin":"workspace:write:location:admin","dashboard:read:admin":"dashboard:read:admin","workspace:read:list_floor_workspace_reservations:admin":"workspace:read:list_floor_workspace_reservations:admin","workspace:read:list_floor_workspace_reservations:master":"workspace:read:list_floor_workspace_reservations:master","workspace:read:location":"workspace:read:location","workspace:read:location:admin":"workspace:read:location:admin","workspace:delete:neighborhood:admin":"workspace:delete:neighborhood:admin","workspace:read:neighborhood:admin":"workspace:read:neighborhood:admin","workspace:read:workspace_reservation_questionnaire_response:admin":"workspace:read:workspace_reservation_questionnaire_response:admin","workspace:read:workspace_reservation_questionnaire_response:master":"workspace:read:workspace_reservation_questionnaire_response:master","room:read:admin":"room:read:admin","zoom_rooms:read:list_release_infos:admin":"zoom_rooms:read:list_release_infos:admin","workspace:read:list_reservations:admin":"workspace:read:list_reservations:admin","workspace:read:list_reservations:master":"workspace:read:list_reservations:master","workspace:write":"workspace:write","workspace:update:setting:admin":"workspace:update:setting:admin","workspace:update:setting:master":"workspace:update:setting:master","workspace:delete:photo:admin":"workspace:delete:photo:admin","workspace:read:usage":"workspace:read:usage","workspace:read:usage:admin":"workspace:read:usage:admin","workspace:read:workspace:admin":"workspace:read:workspace:admin","workspace:delete:workspace:admin":"workspace:delete:workspace:admin","workspace:update:workspace:admin":"workspace:update:workspace:admin","workspace:read:assignment":"workspace:read:assignment","workspace:read:assignment:admin":"workspace:read:assignment:admin","workspace:delete:assignment:admin":"workspace:delete:assignment:admin","workspace:write:assignment:admin":"workspace:write:assignment:admin","workspace:read:qr:admin":"workspace:read:qr:admin","workspace:write:reservation":"workspace:write:reservation","workspace:write:reservation:admin":"workspace:write:reservation:admin","workspace:read:list_reservations":"workspace:read:list_reservations","workspace:read:reservation":"workspace:read:reservation","workspace:read:reservation:admin":"workspace:read:reservation:admin","workspace:update:reservation":"workspace:update:reservation","workspace:update:reservation:admin":"workspace:update:reservation:admin","workspace:delete:reservation":"workspace:delete:reservation","workspace:delete:reservation:admin":"workspace:delete:reservation:admin","workspace:read:reservation:master":"workspace:read:reservation:master","zoom_rooms:write:room:admin":"zoom_rooms:write:room:admin","zoom_rooms:read:list_rooms:admin":"zoom_rooms:read:list_rooms:admin","zoom_rooms:update:room_controls:admin":"zoom_rooms:update:room_controls:admin","zoom_rooms:update:room_control:admin":"zoom_rooms:update:room_control:admin","zoom_rooms:read:room_settings:admin":"zoom_rooms:read:room_settings:admin","zoom_rooms:update:room_settings:admin":"zoom_rooms:update:room_settings:admin","zoom_rooms:read:room:admin":"zoom_rooms:read:room:admin","zoom_rooms:delete:room:admin":"zoom_rooms:delete:room:admin","zoom_rooms:update:room:admin":"zoom_rooms:update:room:admin","zoom_rooms:read:list_device_profiles:admin":"zoom_rooms:read:list_device_profiles:admin","zoom_rooms:write:device_profile:admin":"zoom_rooms:write:device_profile:admin","zoom_rooms:read:device_profile:admin":"zoom_rooms:read:device_profile:admin","zoom_rooms:update:device_profile:admin":"zoom_rooms:update:device_profile:admin","zoom_rooms:delete:device_profile:admin":"zoom_rooms:delete:device_profile:admin","zoom_rooms:read:list_devices:admin":"zoom_rooms:read:list_devices:admin","zoom_rooms:update:room_location:admin":"zoom_rooms:update:room_location:admin","zoom_rooms:read:sensor_data:admin":"zoom_rooms:read:sensor_data:admin","zoom_rooms:read:virtual_controller:admin":"zoom_rooms:read:virtual_controller:admin","zoom_rooms:read:account_profile:admin":"zoom_rooms:read:account_profile:admin","zoom_rooms:update:account_profile:admin":"zoom_rooms:update:account_profile:admin","zoom_rooms:read:account_settings:admin":"zoom_rooms:read:account_settings:admin","zoom_rooms:update:account_settings:admin":"zoom_rooms:update:account_settings:admin","zoom_rooms:read:list_calendar_services:admin":"zoom_rooms:read:list_calendar_services:admin","zoom_rooms:delete:calendar_service:admin":"zoom_rooms:delete:calendar_service:admin","zoom_rooms:write:calendar_resource:admin":"zoom_rooms:write:calendar_resource:admin","zoom_rooms:read:list_calendar_resources:admin":"zoom_rooms:read:list_calendar_resources:admin","zoom_rooms:read:calendar_resource:admin":"zoom_rooms:read:calendar_resource:admin","zoom_rooms:delete:calendar_resource:admin":"zoom_rooms:delete:calendar_resource:admin","zoom_rooms:update:calendar_service:admin":"zoom_rooms:update:calendar_service:admin","zoom_rooms:read:background_library_content:admin":"zoom_rooms:read:background_library_content:admin","zoom_rooms:delete:background_library_content:admin":"zoom_rooms:delete:background_library_content:admin","zoom_rooms:read:background_library_folder:admin":"zoom_rooms:read:background_library_folder:admin","zoom_rooms:write:background_library_folder:admin":"zoom_rooms:write:background_library_folder:admin","zoom_rooms:delete:background_library_folder:admin":"zoom_rooms:delete:background_library_folder:admin","zoom_rooms:update:background_library_folder:admin":"zoom_rooms:update:background_library_folder:admin","zoom_rooms:read:digital_signage_library_contents:admin":"zoom_rooms:read:digital_signage_library_contents:admin","zoom_rooms:write:digital_signage_library_contents:admin":"zoom_rooms:write:digital_signage_library_contents:admin","room:write:master":"room:write:master","room:read:master":"room:read:master","zoom_rooms:write:digital_signage_library_playlists:admin":"zoom_rooms:write:digital_signage_library_playlists:admin","zoom_rooms:read:digital_signage_library_playlists:admin":"zoom_rooms:read:digital_signage_library_playlists:admin","zoom_rooms:write:background_library_content:admin":"zoom_rooms:write:background_library_content:admin","zoom_rooms:update:background_library_content:admin":"zoom_rooms:update:background_library_content:admin","zoom_rooms:delete:device:admin":"zoom_rooms:delete:device:admin","zoom_rooms:update:device_app_version:admin":"zoom_rooms:update:device_app_version:admin","zoom_rooms:read:list_locations:admin":"zoom_rooms:read:list_locations:admin","zoom_rooms:write:location:admin":"zoom_rooms:write:location:admin","zoom_rooms:update:location_hierarchy:admin":"zoom_rooms:update:location_hierarchy:admin","zoom_rooms:read:location_hierarchy:admin":"zoom_rooms:read:location_hierarchy:admin","zoom_rooms:update:location:admin":"zoom_rooms:update:location:admin","zoom_rooms:read:location:admin":"zoom_rooms:read:location:admin","zoom_rooms:read:location_settings:admin":"zoom_rooms:read:location_settings:admin","zoom_rooms:update:location_settings:admin":"zoom_rooms:update:location_settings:admin","zoom_rooms:update:room_tag:admin":"zoom_rooms:update:room_tag:admin","zoom_rooms:write:tag:admin":"zoom_rooms:write:tag:admin","zoom_rooms:read:list_tags:admin":"zoom_rooms:read:list_tags:admin","zoom_rooms:delete:tag:admin":"zoom_rooms:delete:tag:admin","zoom_rooms:update:tag:admin":"zoom_rooms:update:tag:admin","zoom_rooms:delete:room_tag:admin":"zoom_rooms:delete:room_tag:admin"}}}}}}}