API

Dropzone API

You can interact with your Dropzone instance via API for various actions, such as managing alerts and investigations, context memory, and response actions.

API key creation is available to Dropzone "Admin" users.

Managing Keys

• Navigate to your Dropzone AI tenant home page e.g. https://mycompany.dropzone.app
• In the bottom left hand corner, navigate to Settings > API Keys

You'll now be on the API Keys page. From here you can see existing keys, create new ones, and revoke existing ones.

Creating Keys

• Find the "Add New API Key" section in the upper left
• Give your new key a name and optional expiration date
• Hit Create Key
• Store your API key value somewhere safe - you will not be able to see it again

The Api-Key prefix is part of your api key - be sure it is included in the Authorization header, e.g.

curl -L \
  --url '/app/api/v1/ping' \
  --header 'Authorization: Api-Key Tm8gc2Vcm...' \
  --header 'Accept: */*'
  ...

Swagger API UI

You can view the API spec from within the Dropzone UI via a Swagger UI, and even make API calls directly by using your API key in the Swagger interface.

From the main API key page, click "Dropzone API Swagger UI" link in the upper right

This will open a new tab with the Swagger UI.

Online API Documentation

The pages in this section detail the APIs for Dropzone AI. Note that these documents may lag actual product functionality - see the Swagger UI for the official list of APIs available to you.