# Object Storage

## GET /v1/object-storages

>

```json
{"openapi":"3.0.0","info":{"title":"Whaly API","version":"1.0"},"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http","description":"Pass a Service Account Key as the Bearer token to authenticate. e.g. 'sk:xxxxxxx'"}},"schemas":{"PaginatedListWrapper":{"type":"object","properties":{"paging":{"$ref":"#/components/schemas/PagingInfo"}},"required":["paging"]},"PagingInfo":{"type":"object","properties":{"next":{"$ref":"#/components/schemas/PagingNext"}},"required":["next"]},"PagingNext":{"type":"object","properties":{"after":{"type":"string"}},"required":["after"]},"ObjectStorageDto":{"type":"object","properties":{"id":{"type":"string","description":"Unique ID"},"name":{"type":"string","description":"The name of the object storage"}},"required":["id","name"]}}},"paths":{"/v1/object-storages":{"get":{"operationId":"DocumentsController_listAll","parameters":[{"name":"after","required":false,"in":"query","schema":{"type":"string"}},{"name":"limit","required":false,"in":"query","schema":{"type":"number"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/PaginatedListWrapper"},{"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ObjectStorageDto"}}}}]}}}}}}}}}
```

## GET /v1/object-storages/{objectStorageId}

>

```json
{"openapi":"3.0.0","info":{"title":"Whaly API","version":"1.0"},"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http","description":"Pass a Service Account Key as the Bearer token to authenticate. e.g. 'sk:xxxxxxx'"}},"schemas":{"ObjectStorageDto":{"type":"object","properties":{"id":{"type":"string","description":"Unique ID"},"name":{"type":"string","description":"The name of the object storage"}},"required":["id","name"]}}},"paths":{"/v1/object-storages/{objectStorageId}":{"get":{"operationId":"DocumentsController_findOne","parameters":[{"name":"objectStorageId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ObjectStorageDto"}}}}}}}}}
```

## POST /v1/object-storages/{objectStorageId}/upload

>

```json
{"openapi":"3.0.0","info":{"title":"Whaly API","version":"1.0"},"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http","description":"Pass a Service Account Key as the Bearer token to authenticate. e.g. 'sk:xxxxxxx'"}},"schemas":{"ObjectStorageUploadDTO":{"type":"object","properties":{"filePath":{"type":"string","description":"The path within the storage where the file has been stored"},"sizeKb":{"type":"number","description":"The stored file size in kb"},"storage":{"type":"string","description":"The Object Storage Id on which the file has been uploaded"}},"required":["filePath","sizeKb","storage"]}}},"paths":{"/v1/object-storages/{objectStorageId}/upload":{"post":{"operationId":"DocumentsController_upload","parameters":[{"name":"path","required":false,"in":"query","schema":{"type":"string"}},{"name":"objectStorageId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":"","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ObjectStorageUploadDTO"}}}}}}}}}
```

## GET /v1/object-storages/{objectStorageId}/download

>

```json
{"openapi":"3.0.0","info":{"title":"Whaly API","version":"1.0"},"security":[{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http","description":"Pass a Service Account Key as the Bearer token to authenticate. e.g. 'sk:xxxxxxx'"}}},"paths":{"/v1/object-storages/{objectStorageId}/download":{"get":{"operationId":"DocumentsController_download","parameters":[{"name":"path","required":true,"in":"query","schema":{"type":"string"}},{"name":"objectStorageId","required":true,"in":"path","schema":{"type":"string"}}],"responses":{"200":{"description":""}}}}}}
```