The Carbon Black App Control API is intended for programmers who want to write code to interact with Carbon Black App Control, either using custom scripts or from other applications. It is a RESTful API that can be consumed over HTTPS protocol using any language that can create get URI requests and post/put JSON requests as well as interpret JSON responses.

Actions performed through the Carbon Black App Control API create an audit trail just as the same action performed from the console would. The appropriate API user taking the action is referenced in event.

The current version of the Carbon Black App Control API is v1. All API calls are based at the following address: https://<your server name> /api/bit9platform/v1.

This section contains the following content:

  • API Authentication and Access Control – Describes how to create an API user account and get the API Token necessary for API authentication of clients. It also describes how to configure permissions for the login accounts needed for such access.
  • Available Objects – A listing and brief description of the objects you can access through the Carbon Black App Control API.

This section is a summary only. The full API documentation is available in two locations:

The following additional resources are available for Carbon Black API developers:

  • Carbon Black provides a Python module that developers can use for easy access to the REST APIs for Carbon Black App Control, VMware Carbon Black EDR, and VMware Carbon Black Cloud. The documentation for this module is available at https://cbapi.readthedocs.io.
  • The source code for the CB API module (cbapi) for Carbon Black products is located at https://github.com/carbonblack/cbapi-python.
  • Tutorials, blogs, and other CB API resources for Carbon Black App Control, Carbon Black EDR, andCarbon Black Cloud are available on the VMware Carbon Black Developer Network site at https://developer.carbonblack.com.
Note: Carbon Black App Control also includes a Live Inventory SDK, which provides read-only public views into the database. You can create your own reporting and data analysis solutions through the use of these public views. See Live Inventory SDK: Database Views for more information.