---
title: "Получить доступные хранилища"
method: GET
path: "/api/v1/files/roots"
tags: ["Files"]
---

# Получить доступные хранилища

`GET /api/v1/files/roots`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/files/roots`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)

Личное хранилище сотрудника заводится при первом обращении. Закрытое хранилище видно только тем, кто перечислен в его правах: перебор идентификаторов не расскажет о чужих папках.

## Headers

- `X-Tenant` string, required

## Response `200`

Хранилища смотрящего

- object
  - `roots` FilesFolder[], required
    - `id` string, uuid, required
    - `parent_id` string, uuid
    - `root_id` string, uuid, required
    - `depth` integer, required
    - `name` string, required
    - `kind` 'shared' | 'personal', required: Личное хранилище принадлежит своему владельцу целиком
    - `icon` string, required
    - `color` string, required
    - `description` string, required
    - `is_restricted` boolean, required: Закрытое хранилище видно только участникам его списка
    - `break_inheritance` boolean, required: Права хранилища на эту папку не действуют
    - `business_id` string, uuid, required
    - `owner_id` integer, required
    - `created_by` integer, required
    - `trashed_at` string, date-time
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `can_read` boolean, required
    - `can_write` boolean, required
    - `can_share` boolean, required: Право выпускать внешние ссылки; из открытости хранилища не следует
    - `can_manage` boolean, required
    - `is_favorite` boolean, required
    - `folder_count` integer, required
    - `file_count` integer, required
    - `size_bytes` integer, required

## Other responses

- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/3c60ded179f2?raw)