> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jsonsilo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Understand general concepts, response codes, and authentication strategies.

## JSONSilo Manage API

The JSONSilo Manage API allows you to programmatically manage your JSON silos, including creating, updating, deleting silos, and managing files within those silos.

### Base URL

The base URL for the JSONSilo Manage API is structured as follows:

```bash theme={null}
https://[region-code].jsonsilo.com/api/v1/manage/
```

> Replace `[region-code]` with the appropriate region code for your silo, and `[file-uuid]` with the unique identifier assigned to your JSON file.
>
> * [Retrieving your file uuid and region code](/quick-start#retrieving-your-file-uuid-and-region-code)

### Endpoints

The JSONSilo Manage API provides the following endpoints:

| Endpoint            | Method   | Description                                                                  |
| ------------------- | -------- | ---------------------------------------------------------------------------- |
| `/`                 | `POST`   | [Create a new silo](/api-reference/endpoint/create-silo)                     |
| `/{file_uuid}`      | `DELETE` | [Delete a specific silo](/api-reference/endpoint/delete-silo)                |
| `/meta/{file_uuid}` | `GET`    | [Retrieve metadata for a specific silo](/api-reference/endpoint/get-meta)    |
| `/{file_uuid}`      | `GET`    | [Retrieve `file_data` for a specific silo](/api-reference/endpoint/get-silo) |
| `/silos`            | `GET`    | [List all silos](/api-reference/endpoint/get-silo-list)                      |
| `/{file_uuid}`      | `PATCH`  | [Update a specific silo](/api-reference/endpoint/patch-silo)                 |

### Authentication

To use the JSONSilo Manage API, you need an API key for authentication. Include your API key in the `X-MAN-API` or `x-man-api` HTTP header for all API requests:

```bash theme={null}
X-MAN-API: MANAGE_API_KEY
```

> * Replace `MANAGE_API_KEY` with your actual API key.
> * To generate a new API key, follow the instructions [here](/keys/manage-keys).

#### Example Request

Here is an example of how to make a request using `curl`:

```bash Terminal theme={null}
curl -X GET "https://api.jsonsilo.com/api/v1/manage/silos" \
     -H "X-MAN-API: YOUR_MANAGE_API_KEY" \
     -H "Content-Type: application/json"
```