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.
https://domain.chaossearch.io/user/credential/apiKey/create
POST : provision
Response: 201 CREATED
Body { “keyId” : String , “secretKey” : String }
OR
503 Internal Server Error
Example:
curl 'https://<mycompany>.chaossearch.io/User/credential/apiKey/create' \
{"keyId":"EFGKEY4SQQUUTBBMXVWD","secretKey":"dhABCFszdhwcqR4Ni+tO5yQzGW2vGmirf7nI9ALW"}
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:
https://domain.chaossearch.io/user/credential/apiKey/list
GET : enumerate
Response: 200 OK
Body: { “keyIds”: [ id : String ] }
OR
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 'https://sumo.chaossearch.io/User/credential/apiKey/list' \
-X GET \
{"keyIds":["XYZ6UW7G3R8XHGZROABC","ABCX08KS0A3MTQCJPVXC",
"EFGKEY4SQQUUTBBMXVWD"]}
NOTE:
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:
https://domain.chaossearch.io/user/credential/apiKey/delete?keyId=<keyId>
DELETE : deprovision
PATH : keyId=<STRING>
The keyId
is the ID string that you want to remove (deprovision)
Response: 200 OK
| 404 Not Found
curl 'https://sumo.chaossearch.io/User/credential/apiKey/delete?keyId=EFGKEY4SQQUUTBBMXVWD' \
-X DELETE \
{"keyId":"EFGKEY4SQQUUTBBMXVWD"}
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.
Updated 15 days ago