The Server & Workload Protection API enables you to automate operational tasks, thereby increasing the productivity
of your value stream and improving the security services that you support:
- Configure policies and protect computers
- Discover vulnerabilities and patch them
- Perform routine maintenance tasks
The API and SDK
The Server & Workload Protection API is a RESTful API that you use to make HTTP requests to interact with Server & Workload Protection. The SDK includes a Python package that makes it easy to use the API in Python.
The API Reference provides information about
each resource that you interact with:
- Descriptions of operations that you can perform on each resource (GET, POST, etc)
- Request paths, headers, and payloads
- Example requests and response messages
Guides, such as this one, describe how to use the SDKs via examples of how to automate
typical Server & Workload Protection operational tasks.
API versions
The API is versioned. Each request that you make must include the version to use in
the
api-version
header. The first version is v1
.Although new versions are rarely released, you must ensure that the API version you
are using is compatible with Server & Workload Protection. However, Server & Workload Protection is backward-compatible with all versions of the API. For example, if your code uses
the
v1
API and you upgrade the manager, your code behavior does not change. However, you
should always use the latest available version of the API.Legacy REST and SOAP APIs
NoteThe REST and SOAP APIs that were provided before Deep Security 11.1 have not changed.
They have been deprecated, so new features will not be added but the existing API
functionality will continue to function as usual.
|
Server & Workload Protection still includes the legacy Deep Security REST and SOAP APIs. For guidance on using
them, see the following guides: