Public Web API: Get a list of directories

Get a list of directories
Returns a list of models of directories from the platform’s file storage generated based on the conditions set in the request body.

Request

POST /pub/v1/disk/directory/list

Request body

The resource sent in the request body is Get a list of directories — Request. It contains the following writable properties:

{
    "active": "boolean",
    "filter": {
        "<key>": {}
    },
    "from": "int64",
    "ids": [
        "uuid"
    ],
    "size": "int64",
    "sortExpressions": [
        {
            "ascending": "boolean",
            "field": "string"
        }
    ]
}

Properties

Name	Type	Description	Additional
active	boolean	Show active only (not deleted)	Optional
filter	object	Filtering	Optional
filter.<key>	map of object		Optional
from	int64	Return starting from item	Optional
ids[]	array of uuid	Filter by ID	Optional
size	int64	Number of returned items (10000 max)	Optional
sortExpressions[]	array	Sorting rules	Optional
sortExpressions[].ascending	boolean	Ascending sorting order flag	Optional
sortExpressions[].field	string	Sort field	Optional

Authorization

This request requires the use of one of following authorisation methods: API key

Response

The following HTTP status codes may be returned:

Status code	Description	Resource
200	OK Response model for requesting the directories list	Response model for requesting the directories list (Get a list of directories)