API keys authenticate programmatic access to the platform. You manage them on the API Keys page, under the Admin section, which lists your existing keys with the date each was created and last modified. From this page you can create a new key, rename it, rotate it, or delete it.

New and rotated keys take up to 15 minutes to become active. If you receive authentication errors right after creating or rotating a key, wait a few minutes and try again.

Creating a Key

1. On the API Keys page, click the add (+) button in the top right. The Create API Key modal opens.
2. Enter a name for the key, or leave the field blank to have on generated for you.
3. Click Create API Key. To close the modal without creating a key, click Cancel.

The new key appears in the list, and a confirmation message notes that it may take up to 15 minutes to become active.

Managing a Key

Each key has an overflow menu, opened from the control at the end of its row, with three actions: Edit, Rotate, and Delete.

Renaming a Key

1. Open the key's overflow menu and select Edit. The Edit modal opens.
2. Enter a new name.
3. Click Update to save the new name, or Cancel to discard.

Rotating a Key

Rotating a key replaces it with a newly generated key.

1. Open the key's overflow menu and select Rotate. A confirmation dialog opens, noting that you will not be able ot use the old key once the rotation takes effect.
2. Click Rotate to confirm, or Cancel to keep the current key.

After you rotate, a confirmation message appears. The new key takes up to 15 minutes to become active, and the old key continues to work during that window. Once the new key is active, the old key stops working.

Deleting a Key

1. Open the key's overflow menu and select Delete.
2. Confirm the deletion.

Any application using a deleted key can no longer authenticate with it.