ChaosSearch API Key Endpoints

Users can also manage their ChaosSearch API keys using three API endpoints.

Creating a ChaosSearch API Key

To create an API access key and its associated secret key, you can use the apiKey/create endpoint. Make sure that you have your user authorization and security values, which you can get in several ways, including by creating a JWT.
POST : provision

Response: 201 CREATED
Body { “keyId” : String , “secretKey” : String }

503 Internal Server Error


curl 'https://<mycompany>' \


Listing the ChaosSearch API Keys

To display a list of all the key IDs associated with your user account, you use the apiKeys/list endpoint:
GET : enumerate

Response: 200 OK
Body: { “keyIds”: [ id : String ] }

503 Internal Server Error

If you are authenticated as the tenant user, the list command displays a list of all of the keys created for all subaccount users and the root user. A subaccount user sees a list of the keys created specifically for their subaccount.

curl '' \
  -X GET \




The list command displays only the key IDs, never the secret keys.

Deleting a ChaosSearch API Key

To delete a ChaosSearch API key and its associated secret key, you use the apiKey/delete endpoint:<keyId>
DELETE : deprovision

The keyId is the ID string that you want to remove (deprovision)
Response: 200 OK | 404 Not Found

curl '' \


When you delete a key, a successful response displays the key ID value. If you list the keys, the deleted key should no longer appear in the list of keys for your user account.