SoftwareCentral · Web services

Web Services

SoftwareCentral has an API made of web services. Each one does a single job, such as adding a computer to a collection or installing an Intune application, and you call it from a script or another tool.

SOAP, REST and JSON Settings › Web Services Manage: General, Security, Test

1 What the web services are

A web service is an address that you call with a few parameters, and that does one job in SoftwareCentral.

SoftwareCentral offers an API made of a wide range of web services. You call them from a script or from a third-party tool, for example to add a computer to a collection, clone a computer, set the price of a shop item, create an Intune application group or install software on many Intune devices at once.

All web services support both SOAP and REST (HTTP GET and POST), and they can also be called with JSON. By default they are secured with Windows Authentication, but they can also be set up to use Basic Authentication, anonymous access or a Microsoft access token. See Security.

2 Open the list of web services

Click Settings in the top menu, then Web Services.

The Settings menu with Web Services at the bottom of the list
The Settings menu. Web Services is in the group with Health Check, Service Manager and Password Manager.
The Web Services page: a search box on the left and a grid with Name, Description and Manage
Settings › Web Services. The names follow the pattern Area - Action, so the list is sorted by area.

The grid has three columns:

ColumnWhat it tells you
NameThe area and the action, for example Devices - Clone Computer. Click the name to open Manage.
DescriptionWhat the web service does, and in some cases the format a value must have.
ManageOpens the window where you see the address, copy a sample, set the security and test the call.

To find a web service, type part of its name in the search box and press Enter. Type more words to narrow the list: a web service must match all of them. Use the page size at the bottom (20, 50 or 100) to see more rows at a time.

3 Manage a web service

Click Manage next to a web service to open its window. It has three tabs.

TabUse it to
GeneralSee the web service name, the description with its parameters, and the address. It also has ready-made PowerShell and VBScript samples and a link to the Samples page. See Call a Web Service.
SecurityChoose which security roles may call the web service, and turn anonymous access on or off. See Security.
TestRun the web service from the browser, in your own context. See Call a Web Service.
What you see depends on your setup A SoftwareCentral that only manages Intune lists only the Intune web services. If your organisation uses Microsoft Entra ID only, the Active Directory web services are not listed. In SoftwareCentral Cloud the anonymous access setting is not shown, and the samples include a log in and a log out.

4 Where to go next

5 Best practice

  • Tick only the roles that need the web service. The Security tab saves the roles that may call that one web service. Other web services are not changed.
  • Test a call on the Test tab before you script it. The Test tab runs the web service with the values you enter, so you see the answer first.
  • Copy the sample, then change the values. The General tab builds its PowerShell sample from the web service's own parameters.

6 Troubleshooting

SymptomCauseWhat to do
There is no Security tab on Cloud - Log in or Cloud - Log out. These two web services are how a caller signs in, so they have no security roles. Nothing to do.
There is no Enable anonymous access checkbox. SoftwareCentral Cloud does not offer anonymous access, so the setting is hidden. Nothing to do.