DocumentationBlogSupport
Log inSign up
Log inSign up
BlogSupport
Build
Getting StartedPlatform Introduction
Embedded Apps
What's NewOverviewDeveloper GuideSidebar API Quick StartSubmission Checklist for Embedded Apps
Design Guidelines
MessagingMeetingsDevicesSidebarSidebar on Mobile
API Reference
BotsButtons and CardsIntegrationsBYODSService AppsService App GuestsService Apps G2GGuest IssuerWidgetsWebex ConnectLogin with WebexInstant ConnectInstant Connect Meeting LinksDeveloper SandboxBeta ProgramSubmit Your AppSupport PolicyFAQs
APIs
API Behavior ChangesPartners API GuideXML API DeprecationAccess the APIREST API BasicsCompliance
Webex APIs
Reference
Data Sources
Admin
OverviewAdmin APIsHybrid ServicesAuthentication
Guides
Hybrid ServicesWebhooksReal-time File DLP BasicsProvisioning APIsBackground ImagesAudit Events Error Reference
Reference
Admin Audit EventsAuthorizationsEventsGroupsHistorical AnalyticsHybrid ClustersHybrid ConnectorsLicensesMeeting QualitiesOrganization ContactsOrganizationsPartner ManagementPartner Reports/TemplatesPartner TagsPeopleRecording ReportRecordingsReport TemplatesReportsResource Group MembershipsResource GroupsRolesSecurity Audit EventsSession TypesSettingsSpace ClassificationsTracking CodesWorkspace LocationsWorkspace Metrics
Webex Calling Beta
Overview
Guides
Integrations and AuthorizationMetadata and Samples
Webex Calling
OverviewSDKs and ToolsWhat's New
Guides
Integrations and AuthorizationProvisioning APIsMetadata and SamplesBackground Images
Reference
Call ControlsCall RoutingCall Settings For MeCalling Service SettingsClient Call SettingsConference ControlsConverged RecordingsDECT Devices SettingsDevice Call Settings
GETGet Device Members
PUTUpdate Members on the device
GETSearch Members
POSTApply Changes for a specific device
GETGet Device Settings
PUTUpdate device settings
GETGet Location Device Settings
GETGet Webex Calling Device Details
PUTUpdate Third Party Device
GETGet Person Devices
PUTModify Hoteling Settings for a Person's Primary Devices
GETGet Workspace Devices
PUTModify Workspace Devices
GETRead the List of Supported Devices
GETRead the device override settings for a organization
POSTCreate a Line Key Template
GETRead the list of Line Key Templates
GETGet details of a Line Key Template
PUTModify a Line Key Template
DELETEDelete a Line Key Template
POSTPreview Apply Line Key Template
POSTApply a Line Key Template
GETGet List of Apply Line Key Template jobs
GETGet the job status of an Apply Line Key Template job
GETGet job errors for an Apply Line Key Template job
GETRead the DECT device type list - Deprecated
GETRead the DECT device type list
POSTValidate a list of MAC address
POSTChange Device Settings Across Organization Or Location Job
GETList Change Device Settings Jobs
GETGet Change Device Settings Job Status
GETList Change Device Settings Job Errors
GETGet Device Layout by Device ID
PUTModify Device Layout by Device ID
POSTRebuild Phones Configuration
GETList Rebuild Phones Jobs
GETGet the Job Status of a Rebuild Phones Job
GETGet Job Errors for a Rebuild Phones Job
GETGet Device Settings for a Person
PUTUpdate Device Settings for a Person
GETGet Device Settings for a Workspace
PUTUpdate Device Settings for a Workspace
GETRead the List of Background Images
POSTUpload a Device Background Image
DELETEDelete Device Background Images
GETGet User Devices Count
DevicesEmergency Services SettingsFeatures: Announcement PlaylistFeatures: Announcement RepositoryFeatures: Auto AttendantFeatures: Call ParkFeatures: Call PickupFeatures: Call QueueFeatures: Call RecordingFeatures: Customer Experience EssentialsFeatures: Hunt GroupFeatures: Operating ModesFeatures: Paging GroupFeatures: Single Number ReachLocation Call SettingsLocation Call Settings: Call HandlingLocation Call Settings: SchedulesLocation Call Settings: VoicemailLocationsNumbersPSTNPartner Reports/TemplatesPeopleRecording ReportReportsReports: Detailed Call HistorySend Activation EmailUser Call SettingsVirtual Line Call SettingsWorkspace Call SettingsWorkspaces
Webex for Broadworks
Overview
Guides
Integrations and AuthorizationDeveloper's Guide
Reference
BroadWorks Billing ReportsBroadWorks EnterprisesBroadWorks SubscribersBroadWorks Workspaces
Webex for Wholesale
Overview
Guides
Developer's Guide
Reference
Wholesale Billing ReportsWholesale Provisioning
Webex for UCM
Guides
Integrations and Authorization
Reference
UCM Profile
Contact Center
Overview
Reference
Data Sources
Customer Journey Data
Overview
Guides
Getting StartedFAQ
Devices
Overview
Guides
Devices
Reference
Device Call Settings
GETGet Device Members
PUTUpdate Members on the device
GETSearch Members
POSTApply Changes for a specific device
GETGet Device Settings
PUTUpdate device settings
GETGet Location Device Settings
GETGet Webex Calling Device Details
PUTUpdate Third Party Device
GETGet Person Devices
PUTModify Hoteling Settings for a Person's Primary Devices
GETGet Workspace Devices
PUTModify Workspace Devices
GETRead the List of Supported Devices
GETRead the device override settings for a organization
POSTCreate a Line Key Template
GETRead the list of Line Key Templates
GETGet details of a Line Key Template
PUTModify a Line Key Template
DELETEDelete a Line Key Template
POSTPreview Apply Line Key Template
POSTApply a Line Key Template
GETGet List of Apply Line Key Template jobs
GETGet the job status of an Apply Line Key Template job
GETGet job errors for an Apply Line Key Template job
GETRead the DECT device type list - Deprecated
GETRead the DECT device type list
POSTValidate a list of MAC address
POSTChange Device Settings Across Organization Or Location Job
GETList Change Device Settings Jobs
GETGet Change Device Settings Job Status
GETList Change Device Settings Job Errors
GETGet Device Layout by Device ID
PUTModify Device Layout by Device ID
POSTRebuild Phones Configuration
GETList Rebuild Phones Jobs
GETGet the Job Status of a Rebuild Phones Job
GETGet Job Errors for a Rebuild Phones Job
GETGet Device Settings for a Person
PUTUpdate Device Settings for a Person
GETGet Device Settings for a Workspace
PUTUpdate Device Settings for a Workspace
GETRead the List of Background Images
POSTUpload a Device Background Image
DELETEDelete Device Background Images
GETGet User Devices Count
Device ConfigurationsDevicesWorkspace LocationsWorkspace MetricsWorkspace PersonalizationWorkspacesxAPI
Directory Services
Reference
Domain ManagementIdentity Organization
Meetings
Overview
Guides
Integrations and AuthorizationWebhooksWebinar GuideMeeting Resource Guide
Reference
Meeting ChatsMeeting Closed CaptionsMeeting InviteesMeeting MessagesMeeting ParticipantsMeeting PollsMeeting PreferencesMeeting Q and AMeeting QualitiesMeeting TranscriptsMeetingsMeetings Summary ReportPeopleRecording ReportRecordingsSession TypesTracking CodesVideo MeshWebhooks
Messaging
Overview
Guides
BotsIntegrations and AuthorizationWebhooksButtons and Cards
Reference
Attachment ActionsEventsMembershipsMessagesPeopleRoom TabsRoomsTeam MembershipsTeamsWebhooks
SCIM 2
Overview
Reference
SCIM 2 BulkSCIM 2 GroupsSCIM 2 Users
Workspace Integrations
OverviewTechnical DetailsControl Hub Features
Webex Status API
Full API Reference
Admin Audit EventsAttachment ActionsAuthorizationsBroadWorks Billing ReportsBroadWorks EnterprisesBroadWorks SubscribersBroadWorks WorkspacesCall ControlsCall RoutingCall Settings For MeCalling Service SettingsClient Call SettingsConference ControlsConverged RecordingsDECT Devices SettingsData SourcesDevice Call Settings
GETGet Device Members
PUTUpdate Members on the device
GETSearch Members
POSTApply Changes for a specific device
GETGet Device Settings
PUTUpdate device settings
GETGet Location Device Settings
GETGet Webex Calling Device Details
PUTUpdate Third Party Device
GETGet Person Devices
PUTModify Hoteling Settings for a Person's Primary Devices
GETGet Workspace Devices
PUTModify Workspace Devices
GETRead the List of Supported Devices
GETRead the device override settings for a organization
POSTCreate a Line Key Template
GETRead the list of Line Key Templates
GETGet details of a Line Key Template
PUTModify a Line Key Template
DELETEDelete a Line Key Template
POSTPreview Apply Line Key Template
POSTApply a Line Key Template
GETGet List of Apply Line Key Template jobs
GETGet the job status of an Apply Line Key Template job
GETGet job errors for an Apply Line Key Template job
GETRead the DECT device type list - Deprecated
GETRead the DECT device type list
POSTValidate a list of MAC address
POSTChange Device Settings Across Organization Or Location Job
GETList Change Device Settings Jobs
GETGet Change Device Settings Job Status
GETList Change Device Settings Job Errors
GETGet Device Layout by Device ID
PUTModify Device Layout by Device ID
POSTRebuild Phones Configuration
GETList Rebuild Phones Jobs
GETGet the Job Status of a Rebuild Phones Job
GETGet Job Errors for a Rebuild Phones Job
GETGet Device Settings for a Person
PUTUpdate Device Settings for a Person
GETGet Device Settings for a Workspace
PUTUpdate Device Settings for a Workspace
GETRead the List of Background Images
POSTUpload a Device Background Image
DELETEDelete Device Background Images
GETGet User Devices Count
Device ConfigurationsDevicesDomain ManagementEmergency Services SettingsEventsFeatures: Announcement PlaylistFeatures: Announcement RepositoryFeatures: Auto AttendantFeatures: Call ParkFeatures: Call PickupFeatures: Call QueueFeatures: Call RecordingFeatures: Customer Experience EssentialsFeatures: Hunt GroupFeatures: Operating ModesFeatures: Paging GroupFeatures: Single Number ReachGroupsGuests ManagementHistorical AnalyticsHybrid ClustersHybrid ConnectorsIdentity OrganizationIssuesLicensesLocation Call SettingsLocation Call Settings: Call HandlingLocation Call Settings: SchedulesLocation Call Settings: VoicemailLocationsMeeting ChatsMeeting Closed CaptionsMeeting InviteesMeeting MessagesMeeting ParticipantsMeeting PollsMeeting PreferencesMeeting Q and AMeeting QualitiesMeeting TranscriptsMeetingsMeetings Summary ReportMembershipsMessagesNumbersOrganization ContactsOrganizationsPSTNPartner ManagementPartner Reports/TemplatesPartner TagsPeopleRecording ReportRecordingsReport TemplatesReportsReports: Detailed Call HistoryResource Group MembershipsResource GroupsRolesRoom TabsRoomsSCIM 2 BulkSCIM 2 GroupsSCIM 2 UsersSecurity Audit EventsSend Activation EmailSession TypesSettingsSiteSpace ClassificationsTeam MembershipsTeamsTracking CodesUCM ProfileUser Call SettingsVideo MeshVirtual Line Call SettingsWebhooksWholesale Billing ReportsWholesale ProvisioningWorkspace Call SettingsWorkspace LocationsWorkspace MetricsWorkspace PersonalizationWorkspacesxAPI
API Changelog
SDKs
Space Meetings Migration
Calling
Introduction
Platform
Web
IntroductionQuickstart
Basics
AuthorizationCore ConceptsCalls
Advanced Features
Call SettingsContactsSupplementary ServicesVoicemailBackground Noise Reduction
Kitchen Sink
Meetings
Introduction
Platform
Web
IntroductionQuickstart
Basics
AuthorizationJoin a MeetingMigration To Improved MeetingsPasswords & CaptchasUnified Space Meetings
Advanced Features
Advanced ControlsDialing In and OutStreams & EffectsVideo Resolution
Multistream
Multistream Comprehensive GuideMultistream Quickstart
Migrating SDK V2 to V3
iOSAndroidBrowserNode.jsClick to Call
Developer CommunityCertifications

Device Call Settings

These APIs manage Webex Calling settings for devices of the Webex Calling type.

Viewing these read-only device settings requires a full, device, or read-only administrator auth token with a scope of spark-admin:telephony_config_read.

Modifying these device settings requires a full or device administrator auth token with a scope of spark-admin:telephony_config_write.

Method
Description
GEThttps://webexapis.com/v1/telephony/config/devices/{deviceId}/members
Get Device Members
https://webexapis.com/v1/telephony/config/devices/{deviceId}/members
GETGet Device Members
PUThttps://webexapis.com/v1/telephony/config/devices/{deviceId}/members
Update Members on the device
https://webexapis.com/v1/telephony/config/devices/{deviceId}/members
PUTUpdate Members on the device
GEThttps://webexapis.com/v1/telephony/config/devices/{deviceId}/availableMembers
Search Members
https://webexapis.com/v1/telephony/config/devices/{deviceId}/availableMembers
GETSearch Members
POSThttps://webexapis.com/v1/telephony/config/devices/{deviceId}/actions/applyChanges/invoke
Apply Changes for a specific device
https://webexapis.com/v1/telephony/config/devices/{deviceId}/actions/applyChanges/invoke
POSTApply Changes for a specific device
GEThttps://webexapis.com/v1/telephony/config/devices/{deviceId}/settings
Get Device Settings
https://webexapis.com/v1/telephony/config/devices/{deviceId}/settings
GETGet Device Settings
PUThttps://webexapis.com/v1/telephony/config/devices/{deviceId}/settings
Update device settings
https://webexapis.com/v1/telephony/config/devices/{deviceId}/settings
PUTUpdate device settings
GEThttps://webexapis.com/v1/telephony/config/locations/{locationId}/devices/settings
Get Location Device Settings
https://webexapis.com/v1/telephony/config/locations/{locationId}/devices/settings
GETGet Location Device Settings
GEThttps://webexapis.com/v1/telephony/config/devices/{deviceId}
Get Webex Calling Device Details
https://webexapis.com/v1/telephony/config/devices/{deviceId}
GETGet Webex Calling Device Details
PUThttps://webexapis.com/v1/telephony/config/devices/{deviceId}
Update Third Party Device
https://webexapis.com/v1/telephony/config/devices/{deviceId}
PUTUpdate Third Party Device
GEThttps://webexapis.com/v1/telephony/config/people/{personId}/devices
Get Person Devices
https://webexapis.com/v1/telephony/config/people/{personId}/devices
GETGet Person Devices
PUThttps://webexapis.com/v1/telephony/config/people/{personId}/devices/settings/hoteling
Modify Hoteling Settings for a Person's Primary Devices
https://webexapis.com/v1/telephony/config/people/{personId}/devices/settings/hoteling
PUTModify Hoteling Settings for a Person's Primary Devices
GEThttps://webexapis.com/v1/telephony/config/workspaces/{workspaceId}/devices
Get Workspace Devices
https://webexapis.com/v1/telephony/config/workspaces/{workspaceId}/devices
GETGet Workspace Devices
PUThttps://webexapis.com/v1/telephony/config/workspaces/{workspaceId}/devices
Modify Workspace Devices
https://webexapis.com/v1/telephony/config/workspaces/{workspaceId}/devices
PUTModify Workspace Devices
GEThttps://webexapis.com/v1/telephony/config/supportedDevices
Read the List of Supported Devices
https://webexapis.com/v1/telephony/config/supportedDevices
GETRead the List of Supported Devices
GEThttps://webexapis.com/v1/telephony/config/devices/settings
Read the device override settings for a organization
https://webexapis.com/v1/telephony/config/devices/settings
GETRead the device override settings for a organization
POSThttps://webexapis.com/v1/telephony/config/devices/lineKeyTemplates
Create a Line Key Template
https://webexapis.com/v1/telephony/config/devices/lineKeyTemplates
POSTCreate a Line Key Template
GEThttps://webexapis.com/v1/telephony/config/devices/lineKeyTemplates
Read the list of Line Key Templates
https://webexapis.com/v1/telephony/config/devices/lineKeyTemplates
GETRead the list of Line Key Templates
GEThttps://webexapis.com/v1/telephony/config/devices/lineKeyTemplates/{templateId}
Get details of a Line Key Template
https://webexapis.com/v1/telephony/config/devices/lineKeyTemplates/{templateId}
GETGet details of a Line Key Template
PUThttps://webexapis.com/v1/telephony/config/devices/lineKeyTemplates/{templateId}
Modify a Line Key Template
https://webexapis.com/v1/telephony/config/devices/lineKeyTemplates/{templateId}
PUTModify a Line Key Template
DELETEhttps://webexapis.com/v1/telephony/config/devices/lineKeyTemplates/{templateId}
Delete a Line Key Template
https://webexapis.com/v1/telephony/config/devices/lineKeyTemplates/{templateId}
DELETEDelete a Line Key Template
POSThttps://webexapis.com/v1/telephony/config/devices/actions/previewApplyLineKeyTemplate/invoke
Preview Apply Line Key Template
https://webexapis.com/v1/telephony/config/devices/actions/previewApplyLineKeyTemplate/invoke
POSTPreview Apply Line Key Template
POSThttps://webexapis.com/v1/telephony/config/jobs/devices/applyLineKeyTemplate
Apply a Line Key Template
https://webexapis.com/v1/telephony/config/jobs/devices/applyLineKeyTemplate
POSTApply a Line Key Template
GEThttps://webexapis.com/v1/telephony/config/jobs/devices/applyLineKeyTemplate
Get List of Apply Line Key Template jobs
https://webexapis.com/v1/telephony/config/jobs/devices/applyLineKeyTemplate
GETGet List of Apply Line Key Template jobs
GEThttps://webexapis.com/v1/telephony/config/jobs/devices/applyLineKeyTemplate/{jobId}
Get the job status of an Apply Line Key Template job
https://webexapis.com/v1/telephony/config/jobs/devices/applyLineKeyTemplate/{jobId}
GETGet the job status of an Apply Line Key Template job
GEThttps://webexapis.com/v1/telephony/config/jobs/devices/applyLineKeyTemplate/{jobId}/errors
Get job errors for an Apply Line Key Template job
https://webexapis.com/v1/telephony/config/jobs/devices/applyLineKeyTemplate/{jobId}/errors
GETGet job errors for an Apply Line Key Template job
GEThttps://webexapis.com/v1/telephony/config/devices/dects/supportedDevices
Read the DECT device type list - Deprecated
https://webexapis.com/v1/telephony/config/devices/dects/supportedDevices
GETRead the DECT device type list - Deprecated
GEThttps://webexapis.com/v1/telephony/config/devices/dectNetworks/supportedDevices
Read the DECT device type list
https://webexapis.com/v1/telephony/config/devices/dectNetworks/supportedDevices
GETRead the DECT device type list
POSThttps://webexapis.com/v1/telephony/config/devices/actions/validateMacs/invoke
Validate a list of MAC address
https://webexapis.com/v1/telephony/config/devices/actions/validateMacs/invoke
POSTValidate a list of MAC address
POSThttps://webexapis.com/v1/telephony/config/jobs/devices/callDeviceSettings
Change Device Settings Across Organization Or Location Job
https://webexapis.com/v1/telephony/config/jobs/devices/callDeviceSettings
POSTChange Device Settings Across Organization Or Location Job
GEThttps://webexapis.com/v1/telephony/config/jobs/devices/callDeviceSettings
List Change Device Settings Jobs
https://webexapis.com/v1/telephony/config/jobs/devices/callDeviceSettings
GETList Change Device Settings Jobs
GEThttps://webexapis.com/v1/telephony/config/jobs/devices/callDeviceSettings/{jobId}
Get Change Device Settings Job Status
https://webexapis.com/v1/telephony/config/jobs/devices/callDeviceSettings/{jobId}
GETGet Change Device Settings Job Status
GEThttps://webexapis.com/v1/telephony/config/jobs/devices/callDeviceSettings/{jobId}/errors
List Change Device Settings Job Errors
https://webexapis.com/v1/telephony/config/jobs/devices/callDeviceSettings/{jobId}/errors
GETList Change Device Settings Job Errors
GEThttps://webexapis.com/v1/telephony/config/devices/{deviceId}/layout
Get Device Layout by Device ID
https://webexapis.com/v1/telephony/config/devices/{deviceId}/layout
GETGet Device Layout by Device ID
PUThttps://webexapis.com/v1/telephony/config/devices/{deviceId}/layout
Modify Device Layout by Device ID
https://webexapis.com/v1/telephony/config/devices/{deviceId}/layout
PUTModify Device Layout by Device ID
POSThttps://webexapis.com/v1/telephony/config/jobs/devices/rebuildPhones
Rebuild Phones Configuration
https://webexapis.com/v1/telephony/config/jobs/devices/rebuildPhones
POSTRebuild Phones Configuration
GEThttps://webexapis.com/v1/telephony/config/jobs/devices/rebuildPhones
List Rebuild Phones Jobs
https://webexapis.com/v1/telephony/config/jobs/devices/rebuildPhones
GETList Rebuild Phones Jobs
GEThttps://webexapis.com/v1/telephony/config/jobs/devices/rebuildPhones/{jobId}
Get the Job Status of a Rebuild Phones Job
https://webexapis.com/v1/telephony/config/jobs/devices/rebuildPhones/{jobId}
GETGet the Job Status of a Rebuild Phones Job
GEThttps://webexapis.com/v1/telephony/config/jobs/devices/rebuildPhones/{jobId}/errors
Get Job Errors for a Rebuild Phones Job
https://webexapis.com/v1/telephony/config/jobs/devices/rebuildPhones/{jobId}/errors
GETGet Job Errors for a Rebuild Phones Job
GEThttps://webexapis.com/v1/telephony/config/people/{personId}/devices/settings
Get Device Settings for a Person
https://webexapis.com/v1/telephony/config/people/{personId}/devices/settings
GETGet Device Settings for a Person
PUThttps://webexapis.com/v1/telephony/config/people/{personId}/devices/settings
Update Device Settings for a Person
https://webexapis.com/v1/telephony/config/people/{personId}/devices/settings
PUTUpdate Device Settings for a Person
GEThttps://webexapis.com/v1/telephony/config/workspaces/{workspaceId}/devices/settings
Get Device Settings for a Workspace
https://webexapis.com/v1/telephony/config/workspaces/{workspaceId}/devices/settings
GETGet Device Settings for a Workspace
PUThttps://webexapis.com/v1/telephony/config/workspaces/{workspaceId}/devices/settings
Update Device Settings for a Workspace
https://webexapis.com/v1/telephony/config/workspaces/{workspaceId}/devices/settings
PUTUpdate Device Settings for a Workspace
GEThttps://webexapis.com/v1/telephony/config/devices/backgroundImages
Read the List of Background Images
https://webexapis.com/v1/telephony/config/devices/backgroundImages
GETRead the List of Background Images
POSThttps://webexapis.com/v1/telephony/config/devices/{deviceId}/actions/backgroundImageUpload/invoke
Upload a Device Background Image
https://webexapis.com/v1/telephony/config/devices/{deviceId}/actions/backgroundImageUpload/invoke
POSTUpload a Device Background Image
DELETEhttps://webexapis.com/v1/telephony/config/devices/backgroundImages
Delete Device Background Images
https://webexapis.com/v1/telephony/config/devices/backgroundImages
DELETEDelete Device Background Images
GEThttps://webexapis.com/v1/telephony/config/people/{personId}/devices/count
Get User Devices Count
https://webexapis.com/v1/telephony/config/people/{personId}/devices/count
GETGet User Devices Count

Connect

Support

Developer Community

Developer Events

Contact Sales

Handy Links

Webex Ambassadors

Webex App Hub

Resources

Open Source Bot Starter Kits

Download Webex

DevNet Learning Labs

Terms of Service

Privacy Policy

Cookie Policy

Trademarks

© 2025 Cisco and/or its affiliates. All rights reserved.