API Keys

Updated 3 months ago by Michael Cretzman

To integrate Harness with some third party apps, you need to register Harness with the app and then supply a Harness API key. The API key is a simple encrypted string that other applications can use to access Harness without a private Harness account.

Once you have generated an API key in Harness, deployment status can be tracked by making a REST call to Harness. For more information, see Add a Trigger.

Intended Audience

  • Developers
  • DevOps

Create an API Key

The following procedure creates, copies, and deletes an API Key.

To use a Harness API key, do the following:

  1. Mouseover Continuous Security, and click Access Management. The Access Management page appears.
  2. Click API Keys. The API Keys section is displayed.
  3. To add a new API key, click Add API Key. When you are prompted to confirm, click Confirm. The new API key is created.
  4. To copy the API key, click Show. The API key is displayed.
  5. Click the copy icon at the end of the key to copy it.
    Now you can paste the key into your third party app to enable it to make API calls to Harness.
  6. To delete an API key, click the Delete icon.

Use an API Key and REST

You can use the Harness API to track the details of your Harness deployments. An API key is required in the call header in the API requests to Harness. The API key uniquely identifies your Harness account and authorizes access to your account data.

Once you have generated an API key in Harness, deployment status can be tracked by making a REST call to Harness. For more information, see Add a Trigger.

Troubleshooting

The Harness API has a usage rate limit of 1 query per second per API Key. If the rate limit is reached, you will receive this response in the API call:

Too Many requests. Throttled. Max QPS: 1.0


How did we do?