toc

• API reference
  • Authentication
  • Run a Cage
  • List Cages

API reference

A full reference of the Evervault API.

Authentication

The Evervault API is authenticated using an API key. You can find your key in the Settings page for your team. Each key is scoped per team.

To authenticate requests, append an API-KEY header to your request with the value set to the API key copied from the previous step.

Run a Cage

Run a Cage by POSTing a payload to the following URL:

bash
POST https://cage.run/:cageName

Here’s how to run with cURL:

bash
curl --request POST \
     --url https://cage.run/demo-cage \
     --header 'API-KEY: <YOUR_API_KEY>' \
     --header 'Content-Type: application/json' \
     --data '{
       "email": "superhans@big-beat-manifesto.com",
       "songs": ["Powerful Sense Of Dread", "Very Moreish"]
     }'

This command will not encrypt your data before sending it to the Cage.

List Cages

List all the Cages for a team by sending a GET request:

bash
GET https://api.evervault.com/cages

Here’s how to run with cURL:

bash
curl --request GET \
     --url https://api.evervault.com/cages \
     --header 'API-KEY: <YOUR_API_KEY>'