> For the complete documentation index, see [llms.txt](https://docs.enclaive.cloud/virtual-hsm/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.enclaive.cloud/virtual-hsm/api/secrets.md).

# Secrets

## GET /cubbyhole/{path}

> Retrieve the secret at the specified location.

```json
{"openapi":"3.0.2","info":{"title":"Enclaive Vault API","version":"1.3.2"},"servers":[{"url":"http://localhost:8200/v1","description":"Local Vault Server"}],"paths":{"/cubbyhole/{path}":{"get":{"operationId":"cubbyhole-read","summary":"Retrieve the secret at the specified location.","tags":["secrets"],"parameters":[{"name":"list","in":"query","description":"Return a list if `true`.","schema":{"type":"string"}}],"responses":{"200":{"description":"Secret retrieved successfully.","content":{"application/json":{}}},"403":{"description":"Permission denied.","content":{"application/json":{}}},"404":{"description":"Secret not found.","content":{"application/json":{}}}}}}}}
```

## POST /cubbyhole/{path}

> Store a secret at the specified location.

```json
{"openapi":"3.0.2","info":{"title":"Enclaive Vault API","version":"1.3.2"},"servers":[{"url":"http://localhost:8200/v1","description":"Local Vault Server"}],"paths":{"/cubbyhole/{path}":{"post":{"operationId":"cubbyhole-write","summary":"Store a secret at the specified location.","tags":["secrets"],"requestBody":{"required":true,"content":{"application/json":{}}},"responses":{"200":{"description":"Secret written successfully.","content":{"application/json":{}}},"400":{"description":"Bad request.","content":{"application/json":{}}},"403":{"description":"Permission denied.","content":{"application/json":{}}}}}}}}
```

## DELETE /cubbyhole/{path}

> Deletes the secret at the specified location.

```json
{"openapi":"3.0.2","info":{"title":"Enclaive Vault API","version":"1.3.2"},"servers":[{"url":"http://localhost:8200/v1","description":"Local Vault Server"}],"paths":{"/cubbyhole/{path}":{"delete":{"operationId":"cubbyhole-delete","summary":"Deletes the secret at the specified location.","tags":["secrets"],"responses":{"204":{"description":"Secret deleted successfully. No content is returned."},"403":{"description":"Permission denied.","content":{"application/json":{}}},"404":{"description":"Secret not found.","content":{"application/json":{}}}}}}}}
```