Base URL

https://[region-code].jsonsilo.com/api/v1/manage/

Regions code list

Singapore and the United States regions are available only on paid plans.

For more info about supported region, please check here.

NameCodeExample
Germanyapihttps://api.jsonsilo.com/api/v1/
Singaporesg-01-apihttps://sg-01-api.jsonsilo.com/api/v1/
United States (Central)usc-01-apihttps://usc-01-api.jsonsilo.com/api/v1/

Authentication

API Keys

The JSONSilo Manage API uses API keys for authentication. Every request to the API must include your API key, used to authenticate your requests.

Remember that your API key is a secret. Do not share it with others or expose it in any client-side code (browsers, apps).

All API requests should include your API key in an X-MAN-API or x-man-api HTTP header as follows:

x-man-api: API_KEY

Generate Manage API Key

To generate or manage an API key, from the console screen, select Key from the drawer menu. This page will list all the keys, including the Access Key used to access the private silo.

Please do not confuse the Access Key with the Manage Key.

  • Access Key: To access private silo
  • Manage Key: To mange silo via API

Step 1: Create a new key

Click the +Add button to add a new key.

Step 2: Generate Key

  1. Enter a key name (this field is optional; the default value is Secret Key).
  2. Select the key duration. For the free plan, only 1 month is available. Upgrade your plan if you want to increase the key duration.
  3. Click the Create button to generate the new key.

Step 3: Save Key

  1. Generated secret key; Please save this secret key somewhere safe and accessible. For security reasons, you won’t be able to view it again through your account.
  2. Copy the generated key.
  3. You can safely close the dialog once save the key.

Revoke Key

To revoke the key, click the Revoke button. This will revoke your key and will affect any active silo currently using the key.

Making a requests

To revoke the key, click the Revoke button. Please ensure that no silos are using the key, as this will interrupt the operation of any silos using it.

curl -X GET \
    -H 'X-MAN-API: YOUR_API_KEY' \
    -H 'Content-Type: application/json' \
    https://api.jsonsilo.com/api/v1/manage/[FILE_UUID]