[POST] .../v1/storage/get
Returns data about account storage: total limit, current usage, free space and usage by entity. Use this method to read current account storage usage before showing storage dashboards or deciding whether cleanup is needed. The response returns total capacity, used bytes, free bytes and usage grouped by entity; the request body is required but currently has no fields. The caller must have catalog files select permission and the method only reads storage counters without changing files. Missing body, denied permission, storage calculation failures and database errors are returned as HTTP 200 ErrorResult business errors.
Request Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| filters | Array of Filter | Optional | Optional filters by fields available for this API method. |
Filterable Fields
| Field | Type | Description |
|---|
Request Example
{}Response Parameters
| Name | Type | Description |
|---|---|---|
| ok | Boolean | Indicates whether the request completed successfully. |
| result | Storage | Result object. |
Response Example
{
"ok": true,
"result": {
"capacity": 5368709120,
"used": 104857600,
"free": 5263851520,
"entities": [
{
"entity": "chat",
"used": 52428800
},
{
"entity": "report",
"used": 52428800
}
]
}
}