Switch Management API¶
Manage network switch configuration.
See the guide for a narrative walkthrough of this API.
Base URL¶
https://api-{dataRegion}.central.sophos.com/switch/v1 — Regional service in the production environment.
| Variable | Description | Default | Allowed values |
|---|---|---|---|
dataRegion | The data region where tenant data is stored. | eu01 | eu01, eu02, us01, us03, ca01, au01, jp01, in01, br01, ae01 |
Authentication¶
Every request carries an Authorization: Bearer header with an access token obtained through the client-credentials flow — see Get started.
Required permissions¶
This API's operations require one or more of the following, depending on the operation — see each operation's own page for the exact requirement:
cswitch.config:readcswitch.config:write
Operations¶
MacFiltering¶
- Retrieve MAC filter
GET/settings/mac-filtering - Update MAC filter
PUT/settings/mac-filtering
Tasks¶
- Retrieve tasks
GET/tasks
Download¶