topic API for Modifying Device Layout by Device ID in Webex for Developers

API for Modifying Device Layout by Device ID

rachelro — Wed, 26 Feb 2025 11:51:06 GMT

Hi,

When sending the API request to modify the device layout, all lineKeys button configurations must be sent; all 10 buttons need to be included; otherwise, it will not be possible to manually configure the buttons that were not sent through the API.

My question is whether the same applies to kemKeys button configurations. Do I need to send all available buttons according to the kemModuleType field? This could involve a large number of buttons.

If I only send the buttons I want to configure, will I be able to add more buttons manually through the control hub or directly on the device in the future?

Thanks!

Re: API for Modifying Device Layout by Device ID

Janos Benyovszki — Tue, 04 Mar 2025 13:00:41 GMT

@rachelro according to https://developer.webex.com/docs/api/v1/device-call-settings/modify-device-layout-by-device-id only the lineKeys array is mandatory, but if you are sending KemKeys as well, then there are a few mandatory parameters. Are you able to make a PUT request without specifying the "kemKeys" array?

Re: API for Modifying Device Layout by Device ID

rachelro — Tue, 04 Mar 2025 13:19:27 GMT

Hi @Janos Benyovszki ,

I know only the lineKeys array is required. And yes I can make a PUT request without specifying the "kemKeys" array.
but I ask if I must send all the available buttons according to the module type I chose for example KEM_14_KEYS
because if I don't send all the buttons there will be no time to change later.
And this is also the case with the lineKey setting, you must send all available buttons according to the model of the device because if, for example, I send only 7 out of 10, then the remaining three will be blocked.
So if it is really that I need to send all the available buttons? in the lineKey and in the kemKey configure
Thanks!

Re: API for Modifying Device Layout by Device ID

Janos Benyovszki — Wed, 05 Mar 2025 11:24:42 GMT

@rachelro thanks for clarifying it. Indeed, it seems like you will need to send all available keys, but let me check with engineering to confirm and maybe enhance the docs.

Re: API for Modifying Device Layout by Device ID

Janos Benyovszki — Thu, 06 Mar 2025 08:24:23 GMT

@rachelro we got confirmation from engineering that the behaviour is by design and they will enhance the docs to reflect the same. It will be updated as soon as possible.

Re: API for Modifying Device Layout by Device ID

rachelro — Thu, 06 Mar 2025 08:27:31 GMT

Thank you very much!

I'd love an update when it's fixed