Live Workshop: Integrate Google SecOps with Bindplane - Join Us on January 29th at 11 AM ET!Sign Up Now

API Keys

Create an API Key to access resources in BindPlane OP with the CLI or REST API

note

📘 API Keys are available in BindPlane OP Enterprise edition and BindPlane OP Cloud.

Create an API Key

API Keys can be created from the UI by visiting the Project page, found in the top-right settings menu.

observIQ docs - API Keys - image 1

Navigate to the API Key tab and click "Generate New API Key".

observIQ docs - API Keys - image 2

A window will show you your new API Key. This will be the only time this key is available to you. If you do not copy the key now you will have to regenerate another API key.

note

📘 Each user can have one API key per project.

observIQ docs - API Keys - image 3

Using your API Key with the CLI

You can set the API Key value in your configuration by using the bindplane profile command. e.g.

shell
1bindplane profile set default --api-key 4689832f-1725-4eeb-8f9d-3e78cb0155ec

This sets your "default" profile to use the API key you just received. You may also need to set your remote-url to the correct endpoint, for app.bindplane.com users:

bindplane
1bindplane profile set default --remote-url https://app.bindplane.com

Make sure you are using the default profile

bindplane
1bindplane profile use default

Now verify you can retrieve resources, say Source Types

bindplane
1bindplane get source-types

Using your API Key with the REST API

You can use your API with the REST API by setting the X-Bindplane-Api-Key header. An example using curl with BindPlane OP Cloud:

curl
1curl -X GET -H 'X-Bindplane-Api-Key: 4689832f-1725-4eeb-8f9d-3e78cb0155ec' https://app.bindplane.com/v1/source-types