API Keys

Overview

How to Generate an API Key

1. Click on the User icon in the top right and select “My Account”

2. On the My Account Page, Click “New Key” in the API Keys section

3. Fill in the dialog and click “Generate Key”

4. Copy and save the generated key. You will never be shown this key again.

API endpoints

activators

• GET /activators - Get all the activators for a customer

• GET activators/{activatorId} - Get the activator by ID

• PATCH activators/{activatorId} - Update the activator by ID

• DELETE activators/{activatorId} - Delete the Activator by ID

activation_group

• GET /activationGroups - Get all activation groups for customer

• GET /activationGroups/{activationGroupId} - Gets requested activation group details for customer

• POST /activationGroups

• PATCH /activationGroups/{activationGroupId} - Patch Customer Activation Group

• DELETE /activationGroups/{activationGroupId} - Delete Customer Activation Group

alerts

• GET /alert-categories - get alert categories

• GET /alert-codes - Get alert codes

• GET /alerts - Get Edge alerts

• GET alerts/meta - Get meta datat of the edge alerts query

assets

• GET /assets - Gets assets from the most recent discovery scan

• POST /assets - Add a manual Asset

• POST /assets/from-template - Add a manual Asset using a template

• PUT /asset/scan - Run a discovery scan for Assets

• PATCH /assets/{assetId} - Add resources or update metadata for Assets

• DELETE //assets/{assetId} - Delete an Asset

• PATCH /assets/{assetId}/{resourceId} - modify resource information for an Asset

• DELETE /assets/{assetId}/{resourceId} - Delete a resource from an Asset

asset-templates

• GET /asset-templates - Gets Asset templates

• POST /asset-templates - Add a new Asset template

• PATCH /asset-templates/{templateId}- Modify an asset template

• DELETE /asset-templates/{templateId} - Delete an Asset template

api-keys

• GET /users/{userUuid}/api-keys - Gets all of the specified users API keys

• DELETE /users/{userUuid}/api-keys/{keyUuid} - Deletes the specified API key from the specified user

• GET /users/current/api-keys- Gets all of the current user’s API keys

• POST /users/current/api-keys - Generate an API key for the current user

• DELETE /users/current/api-keys/{keyUuid} - Delete one of the current user’s API keys

edges

• GET /edges - Gets all Edges registered to the customer

• PATCH /edges/{edgeId} - Update the Edge’s details

• GET /edges/{edgeId}/recovery - Gets the manual factory reset token for the specified Edge

• PATCH /edges/{edgeId}/deactivate- release the license for the specified Edge

• PATCH /edges/{edgeId}/reboot- reboot the specified Edge (for online Edges only)

• PUT /edges/refresh-system-info - Refresh the Edge’s system info

guests

• GET /sl-guests- Get all SL Guests

• POST /sl-guests/{guestID} - Create an SL Guest

• PATCH /sl-guests/{guestID} - Modify an SL Guest

• DELETE /sl-guests/{guestID} - Delete an SL Guest

• PUT /sl-guests/{guestID}/send-ovpn - Resend the SL Guest their OVPN file.

policies

• GET /policies- Get all policies

• POST /policies - Create a policy

• GET /policies/{policyId}- Get a policy’s details

• PATCH /policies/{policyId} - Modify a policy

• DELETE /policies/{policyId} - Delete a policy

• GET /policies/network/validate- Takes a policy’s microsegment network structure and confirms the IP do not clash with other zones

users

• GET /users - Get all Users

• POST /users - Create a new User

• PATCH /users/{userUuid} - Modify a User

• DELETE /users/{userUuid} - Delete a User

• PUT /users/{userUuid}/reset-2fa - Reset User’s 2FA

• PUT /users/{userUuid}/reset-password - Reset User’s password

• GET /users/roles - Get all Users roles

• GET /users/current - Get info about the current User

• PATCH /users/current - Modify current User’s details

• PUT /users/current/reset-2fa - Reset Current User’s 2FA

• PUT /users/current/reset-2fa - Reset Current User’s password

zones

• GET /zones- Get all zones

• POST /zones - Create a zone

• GET /zones/network/validate- Takes a Zone’s network structure and confirms the IP do not clash with other zones

• GET /zones/{zoneId}- Get a zone’s details

• PATCH /zones/{zoneId} - Modify a zone

• DELETE /zones/{zoneId} - Delete a Zone

Using API Keys in Postman

1. Select "API Key" from the drop-down list.

2. Enter "Authorization" in the Key field.

3. Input the generated API key in the Value field.

4. Select "Header" from the drop-down list in the Add to field.

1. GET /edges?customerid

1. POST /policies