### GET /items/

Source: https://api.kotsklad.ru/openapi.json

API endpoint for GET /items/

```markdown
### Parameters

- **warehouse_id** (integer, query, required): ID склада
- **for_estimate** (boolean, query, optional): Фильтр для сметы - только главные предметы комплектов
- **order_by** (string, query, optional): Поле для сортировки

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/items/?warehouse_id=0&for_estimate=false&order_by=serial_number"
```

```

--------------------------------

### GET /users/

Source: https://api.kotsklad.ru/openapi.json

API endpoint for GET /users/

```markdown
### Responses

#### 200 - Successful Response


### Example Usage

```bash
curl -X GET "https://api.example.com/users/"
```

```

--------------------------------

### GET /warehouses/

Source: https://api.kotsklad.ru/openapi.json

API endpoint for GET /warehouses/

```markdown
### Responses

#### 200 - Successful Response

**APIResponse_List_Warehouse__**
- **status** (string) (required)
- **data** (array (Warehouse))
  Array items:
    - **name** (string) (required)
    - **description** (string)
    - **is_active** (boolean)
    - **id** (integer) (required)
    - **created_at** (string (date-time)) (required)
    - **updated_at** (string (date-time)) (required)
- **message** (string)

### Example Usage

```bash
curl -X GET "https://api.example.com/warehouses/"
```

```

--------------------------------

### GET /items/analytics/unboxed

Source: https://api.kotsklad.ru/openapi.json

Получить предметы без коробок

```markdown
### Responses

#### 200 - Successful Response


### Example Usage

```bash
curl -X GET "https://api.example.com/items/analytics/unboxed"
```

```

--------------------------------

### GET /staff-positions/

Source: https://api.kotsklad.ru/openapi.json

Получить все позиции персонала

```markdown
### Responses

#### 200 - Successful Response


### Example Usage

```bash
curl -X GET "https://api.example.com/staff-positions/"
```

```

--------------------------------

### GET /users/me

Source: https://api.kotsklad.ru/openapi.json

API endpoint for GET /users/me

```markdown
### Responses

#### 200 - Successful Response


### Example Usage

```bash
curl -X GET "https://api.example.com/users/me"
```

```

--------------------------------

### GET /staff/

Source: https://api.kotsklad.ru/openapi.json

Получить всех сотрудников для указанного склада

```markdown
### Parameters

- **warehouse_id** (integer, query, required): ID склада

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/staff/?warehouse_id=0"
```

```

--------------------------------

### GET /admin/warehouses

Source: https://api.kotsklad.ru/openapi.json

API endpoint for GET /admin/warehouses

```markdown
### Responses

#### 200 - Successful Response


### Example Usage

```bash
curl -X GET "https://api.example.com/admin/warehouses"
```

```

--------------------------------

### GET /boxes/

Source: https://api.kotsklad.ru/openapi.json

Получить список коробок для указанного склада

```markdown
### Parameters

- **warehouse_id** (integer, query, required): ID склада
- **include_items** (boolean, query, optional)

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/boxes/?warehouse_id=0&include_items=false"
```

```

--------------------------------

### GET /estimates/

Source: https://api.kotsklad.ru/openapi.json

Получить все сметы (краткий список без позиций) с расчетом стоимости для указанного склада

```markdown
### Parameters

- **warehouse_id** (integer, query, required): ID склада

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/estimates/?warehouse_id=0"
```

```

--------------------------------

### GET /items/{item_id}/kit-info

Source: https://api.kotsklad.ru/openapi.json

Получить полную информацию о комплекте по UUID предмета

```markdown
### Parameters

- **item_id** (string, path, required)
- **warehouse_id** (integer, query, required): ID склада

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/items/{item_id}/kit-info?warehouse_id=0"
```

```

--------------------------------

### GET /users/{user_id}

Source: https://api.kotsklad.ru/openapi.json

API endpoint for GET /users/{user_id}

```markdown
### Parameters

- **user_id** (integer, path, required)

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/users/{user_id}"
```

```

--------------------------------

### GET /items/search

Source: https://api.kotsklad.ru/openapi.json

Поиск предметов по названию

```markdown
### Parameters

- **query** (string, query, required)
- **warehouse_id** (integer, query, required): ID склада

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/items/search?query=string&warehouse_id=0"
```

```

--------------------------------

### GET /staff-positions/analytics/stats

Source: https://api.kotsklad.ru/openapi.json

Получить статистику по позициям персонала

```markdown
### Responses

#### 200 - Successful Response


### Example Usage

```bash
curl -X GET "https://api.example.com/staff-positions/analytics/stats"
```

```

--------------------------------

### GET /warehouses/{warehouse_id}

Source: https://api.kotsklad.ru/openapi.json

API endpoint for GET /warehouses/{warehouse_id}

```markdown
### Parameters

- **warehouse_id** (integer, path, required)

### Responses

#### 200 - Successful Response

**APIResponse_WarehouseWithUsers_**
- **status** (string) (required)
- **data** (object)
  - **name** (string) (required)
  - **description** (string)
  - **is_active** (boolean)
  - **id** (integer) (required)
  - **created_at** (string (date-time)) (required)
  - **updated_at** (string (date-time)) (required)
  - **users** (array (WarehouseUser))
    Array items:
      - **user_id** (integer) (required)
      - **role** (string)
      - **id** (integer) (required)
      - **warehouse_id** (integer) (required)
      - **created_at** (string (date-time)) (required)
- **message** (string)

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/warehouses/{warehouse_id}"
```

```

--------------------------------

### GET /boxes/{box_id}

Source: https://api.kotsklad.ru/openapi.json

API endpoint for GET /boxes/{box_id}

```markdown
### Parameters

- **box_id** (string, path, required)
- **include_items** (boolean, query, optional)

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/boxes/{box_id}?include_items=false"
```

```

--------------------------------

### GET /items/analytics/stats

Source: https://api.kotsklad.ru/openapi.json

Получить статистику предметов

```markdown
### Responses

#### 200 - Successful Response


### Example Usage

```bash
curl -X GET "https://api.example.com/items/analytics/stats"
```

```

--------------------------------

### GET /warehouses/{warehouse_id}/users

Source: https://api.kotsklad.ru/openapi.json

API endpoint for GET /warehouses/{warehouse_id}/users

```markdown
### Parameters

- **warehouse_id** (integer, path, required)

### Responses

#### 200 - Successful Response

**APIResponse_List_WarehouseUser__**
- **status** (string) (required)
- **data** (array (WarehouseUser))
  Array items:
    - **user_id** (integer) (required)
    - **role** (string)
    - **id** (integer) (required)
    - **warehouse_id** (integer) (required)
    - **created_at** (string (date-time)) (required)
- **message** (string)

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/warehouses/{warehouse_id}/users"
```

```

--------------------------------

### GET /categories/

Source: https://api.kotsklad.ru/openapi.json

Получить все категории (с фильтрацией по складу если указан warehouse_id)

```markdown
### Parameters

- **warehouse_id** (union, query, optional): ID склада для фильтрации

### Responses

#### 200 - Successful Response

**APIResponse_List_CategoryWithCount__**
- **status** (string) (required)
- **data** (array (CategoryWithCount))
  Array items:
    - **name** (string) (required)
    - **price_per_day** (number) (required)
    - **big_size** (boolean)
    - **id** (integer) (required)
    - **created_at** (string (date-time)) (required)
    - **updated_at** (string (date-time)) (required)
    - **items_count** (integer) (required)
- **message** (string)

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/categories/?warehouse_id=value"
```

```

--------------------------------

### GET /staff-positions/search

Source: https://api.kotsklad.ru/openapi.json

Поиск позиций персонала по названию

```markdown
### Parameters

- **query** (string, query, required)

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/staff-positions/search?query=string"
```

```

--------------------------------

### GET /staff/analytics/workload

Source: https://api.kotsklad.ru/openapi.json

Получить аналитику по загруженности персонала

```markdown
### Parameters

- **month** (integer, query, optional)
- **year** (integer, query, optional)

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/staff/analytics/workload?month=0&year=0"
```

```

--------------------------------

### GET /boxes/next-serial

Source: https://api.kotsklad.ru/openapi.json

Вернуть минимальный свободный серийный номер формата B0001 (глобально)

```markdown
### Responses

#### 200 - Successful Response


### Example Usage

```bash
curl -X GET "https://api.example.com/boxes/next-serial"
```

```

--------------------------------

### GET /items/next-serial

Source: https://api.kotsklad.ru/openapi.json

Вернуть минимальный свободный серийный номер формата I0001 (глобально)

```markdown
### Responses

#### 200 - Successful Response


### Example Usage

```bash
curl -X GET "https://api.example.com/items/next-serial"
```

```

--------------------------------

### GET /boxes/most_free/

Source: https://api.kotsklad.ru/openapi.json

Найти самую свободную коробку для предмета по UUID или serial_number

```markdown
### Parameters

- **item_identifier** (string, query, required)
- **skip** (integer, query, optional)

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/boxes/most_free/?item_identifier=string&skip=0"
```

```

--------------------------------

### GET /items/analytics/expensive

Source: https://api.kotsklad.ru/openapi.json

Получить самые дорогие предметы

```markdown
### Parameters

- **limit** (integer, query, optional)

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/items/analytics/expensive?limit=10"
```

```

--------------------------------

### GET /staff/analytics/stats

Source: https://api.kotsklad.ru/openapi.json

Получить общую статистику по персоналу

```markdown
### Responses

#### 200 - Successful Response


### Example Usage

```bash
curl -X GET "https://api.example.com/staff/analytics/stats"
```

```

--------------------------------

### GET /categories/search

Source: https://api.kotsklad.ru/openapi.json

Поиск категорий по названию (категории общие для всех складов)

```markdown
### Parameters

- **query** (string, query, required)

### Responses

#### 200 - Successful Response

**APIResponse_List_CategoryWithCount__**
- **status** (string) (required)
- **data** (array (CategoryWithCount))
  Array items:
    - **name** (string) (required)
    - **price_per_day** (number) (required)
    - **big_size** (boolean)
    - **id** (integer) (required)
    - **created_at** (string (date-time)) (required)
    - **updated_at** (string (date-time)) (required)
    - **items_count** (integer) (required)
- **message** (string)

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/categories/search?query=string"
```

```

--------------------------------

### GET /categories/{category_id}

Source: https://api.kotsklad.ru/openapi.json

Получить категорию по ID

```markdown
### Parameters

- **category_id** (integer, path, required)

### Responses

#### 200 - Successful Response

**APIResponse_Category_**
- **status** (string) (required)
- **data** (object)
  - **name** (string) (required)
  - **price_per_day** (number) (required)
  - **big_size** (boolean)
  - **id** (integer) (required)
  - **created_at** (string (date-time)) (required)
  - **updated_at** (string (date-time)) (required)
- **message** (string)

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/categories/{category_id}"
```

```

--------------------------------

### GET /estimates/{estimate_id}

Source: https://api.kotsklad.ru/openapi.json

Получить полную смету по ID с позициями

```markdown
### Parameters

- **estimate_id** (integer, path, required)

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/estimates/{estimate_id}"
```

```

--------------------------------

### GET /staff/search

Source: https://api.kotsklad.ru/openapi.json

Поиск сотрудников по ФИО и номеру телефона

```markdown
### Parameters

- **query** (string, query, required)

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/staff/search?query=string"
```

```

--------------------------------

### GET /staff/{staff_id}

Source: https://api.kotsklad.ru/openapi.json

Получить сотрудника по ID

```markdown
### Parameters

- **staff_id** (string, path, required)

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/staff/{staff_id}"
```

```

--------------------------------

### GET /staff-positions/{position_id}

Source: https://api.kotsklad.ru/openapi.json

Получить позицию персонала по ID

```markdown
### Parameters

- **position_id** (integer, path, required)

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/staff-positions/{position_id}"
```

```

--------------------------------

### GET /categories/export/csv

Source: https://api.kotsklad.ru/openapi.json

Экспорт категорий с предметами склада в CSV

```markdown
### Parameters

- **warehouse_id** (integer, query, required): ID склада

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/categories/export/csv?warehouse_id=0"
```

```

--------------------------------

### GET /items/{item_identifier}

Source: https://api.kotsklad.ru/openapi.json

Получить предмет по UUID или serial_number

```markdown
### Parameters

- **item_identifier** (string, path, required)
- **warehouse_id** (integer, query, required): ID склада

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/items/{item_identifier}?warehouse_id=0"
```

```

--------------------------------

### GET /categories/{category_id}/items

Source: https://api.kotsklad.ru/openapi.json

Получить все предметы в категории на конкретном складе

```markdown
### Parameters

- **category_id** (integer, path, required)
- **warehouse_id** (integer, query, required): ID склада

### Responses

#### 200 - Successful Response

**APIResponse_List_Item__**
- **status** (string) (required)
- **data** (array (Item))
  Array items:
    - **id** (string) (required)
    - **warehouse_id** (integer) (required)
    - **serial_number** (string) (required)
    - **category_id** (integer) (required)
    - **name** (string)
    - **price_per_day** (number)
    - **category_number** (integer) (required)
    - **status** (boolean) (required)
    - **big_size** (boolean)
    - **box_id** (string)
    - **case_id** (string)
    - **is_kit_main** (boolean)
    - **kit_main_id** (string)
    - **kit_info** (object)
- **message** (string)

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/categories/{category_id}/items?warehouse_id=0"
```

```

--------------------------------

### GET /items/found/{item_identifier}

Source: https://api.kotsklad.ru/openapi.json

Отметить предмет как найденный по UUID или serial_number

```markdown
### Parameters

- **item_identifier** (string, path, required)

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/items/found/{item_identifier}"
```

```

--------------------------------

### GET /staff/analytics/earnings/{staff_id}

Source: https://api.kotsklad.ru/openapi.json

Получить аналитику заработка конкретного сотрудника за последние N месяцев

```markdown
### Parameters

- **staff_id** (string, path, required)
- **months** (integer, query, optional)

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X GET "https://api.example.com/staff/analytics/earnings/{staff_id}?months=6"
```

```

--------------------------------

### POST /estimates/

Source: https://api.kotsklad.ru/openapi.json

Создать смету

```markdown
### Parameters

- **warehouse_id** (integer, query, required)

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X POST "https://api.example.com/estimates/?warehouse_id=0"
```

```

--------------------------------

### POST /users/

Source: https://api.kotsklad.ru/openapi.json

API endpoint for POST /users/

```markdown
### Request Body

**Content-Type:** application/json

- **name** (string) (required)
- **password** (string) (required)

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X POST "https://api.example.com/users/" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "string",
  "password": "string"
}'
```

```

--------------------------------

### POST /categories/

Source: https://api.kotsklad.ru/openapi.json

Создать новую категорию (категории общие для всех складов)

```markdown
### Request Body

**Content-Type:** application/json

- **name** (string) (required)
- **price_per_day** (number) (required)
- **big_size** (boolean)

### Responses

#### 200 - Successful Response

**APIResponse_Category_**
- **status** (string) (required)
- **data** (object)
  - **name** (string) (required)
  - **price_per_day** (number) (required)
  - **big_size** (boolean)
  - **id** (integer) (required)
  - **created_at** (string (date-time)) (required)
  - **updated_at** (string (date-time)) (required)
- **message** (string)

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X POST "https://api.example.com/categories/" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "string",
  "price_per_day": "0",
  "big_size": "false"
}'
```

```

--------------------------------

### POST /staff-positions/

Source: https://api.kotsklad.ru/openapi.json

Создать новую позицию персонала

```markdown
### Request Body

**Content-Type:** application/json

- **name** (string) (required)
- **description** (string)
- **default_price_per_shift** (number)

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X POST "https://api.example.com/staff-positions/" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "string",
  "description": "value",
  "default_price_per_shift": "value"
}'
```

```

--------------------------------

### GET /health

Source: https://api.kotsklad.ru/openapi.json

Проверка работоспособности сервиса

```markdown
### Responses

#### 200 - Successful Response


### Example Usage

```bash
curl -X GET "https://api.example.com/health"
```

```

--------------------------------

### Schema: WarehouseCreate

Source: https://api.kotsklad.ru/openapi.json

Schema definition for WarehouseCreate

```markdown
## Schema: WarehouseCreate

Schema definition for WarehouseCreate

**Type:** object

- **name** (string) (required)
- **description** (string)
- **is_active** (boolean)

```

--------------------------------

### POST /items/

Source: https://api.kotsklad.ru/openapi.json

API endpoint for POST /items/

```markdown
### Request Body

**Content-Type:** application/json

- **warehouse_id** (integer) (required)
- **serial_number** (string)
- **category_id** (integer) (required)
- **status** (boolean)
- **is_kit_main** (boolean)
- **kit_main_id** (string)

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X POST "https://api.example.com/items/" \
  -H "Content-Type: application/json" \
  -d '{
  "warehouse_id": "0",
  "serial_number": "value",
  "category_id": "0",
  "status": "true",
  "is_kit_main": "false",
  "kit_main_id": "value"
}'
```

```

--------------------------------

### Schema: ItemCreate

Source: https://api.kotsklad.ru/openapi.json

Schema definition for ItemCreate

```markdown
## Schema: ItemCreate

Schema definition for ItemCreate

**Type:** object

- **warehouse_id** (integer) (required)
- **serial_number** (string)
- **category_id** (integer) (required)
- **status** (boolean)
- **is_kit_main** (boolean)
- **kit_main_id** (string)

```

--------------------------------

### Schema: CategoryCreate

Source: https://api.kotsklad.ru/openapi.json

Schema definition for CategoryCreate

```markdown
## Schema: CategoryCreate

Schema definition for CategoryCreate

**Type:** object

- **name** (string) (required)
- **price_per_day** (number) (required)
- **big_size** (boolean)

```

--------------------------------

### Schema: StaffCreate

Source: https://api.kotsklad.ru/openapi.json

Schema definition for StaffCreate

```markdown
## Schema: StaffCreate

Schema definition for StaffCreate

**Type:** object

- **full_name** (string) (required)
- **passport_series** (string) (required)
- **passport_number** (string) (required)
- **phone_number** (string) (required)
- **payment_details** (string) (required)
- **status** (boolean)
- **warehouse_id** (integer) (required)
- **position_ids** (array (integer))

```

--------------------------------

### Schema: UserCreate

Source: https://api.kotsklad.ru/openapi.json

Schema definition for UserCreate

```markdown
## Schema: UserCreate

Schema definition for UserCreate

**Type:** object

- **name** (string) (required)
- **password** (string) (required)

```

--------------------------------

### POST /boxes/

Source: https://api.kotsklad.ru/openapi.json

API endpoint for POST /boxes/

```markdown
### Request Body

**Content-Type:** application/json

- **warehouse_id** (integer) (required)
- **big_size** (boolean)
- **repair_box** (boolean)

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X POST "https://api.example.com/boxes/" \
  -H "Content-Type: application/json" \
  -d '{
  "warehouse_id": "0",
  "big_size": "false",
  "repair_box": "false"
}'
```

```

--------------------------------

### POST /estimates/{estimate_id}/items

Source: https://api.kotsklad.ru/openapi.json

Создать позицию сметы

```markdown
### Parameters

- **estimate_id** (integer, path, required)

### Request Body

**Content-Type:** application/json


### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X POST "https://api.example.com/estimates/{estimate_id}/items" \
  -H "Content-Type: application/json" \
  -d '"value"'
```

```

--------------------------------

### POST /warehouses/

Source: https://api.kotsklad.ru/openapi.json

API endpoint for POST /warehouses/

```markdown
### Request Body

**Content-Type:** application/json

- **name** (string) (required)
- **description** (string)
- **is_active** (boolean)

### Responses

#### 200 - Successful Response

**APIResponse_Warehouse_**
- **status** (string) (required)
- **data** (object)
  - **name** (string) (required)
  - **description** (string)
  - **is_active** (boolean)
  - **id** (integer) (required)
  - **created_at** (string (date-time)) (required)
  - **updated_at** (string (date-time)) (required)
- **message** (string)

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X POST "https://api.example.com/warehouses/" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "string",
  "description": "value",
  "is_active": "true"
}'
```

```

--------------------------------

### Schema: WarehouseUserCreate

Source: https://api.kotsklad.ru/openapi.json

Schema definition for WarehouseUserCreate

```markdown
## Schema: WarehouseUserCreate

Schema definition for WarehouseUserCreate

**Type:** object

- **name** (string) (required)
- **role** (string (user|admin)) ("user"|"admin")

```

--------------------------------

### POST /staff/

Source: https://api.kotsklad.ru/openapi.json

Создать нового сотрудника

```markdown
### Request Body

**Content-Type:** application/json

- **full_name** (string) (required)
- **passport_series** (string) (required)
- **passport_number** (string) (required)
- **phone_number** (string) (required)
- **payment_details** (string) (required)
- **status** (boolean)
- **warehouse_id** (integer) (required)
- **position_ids** (array (integer))

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X POST "https://api.example.com/staff/" \
  -H "Content-Type: application/json" \
  -d '{
  "full_name": "string",
  "passport_series": "string",
  "passport_number": "string",
  "phone_number": "string",
  "payment_details": "string",
  "status": "true",
  "warehouse_id": "0",
  "position_ids": [
    "0"
  ]
}'
```

```

--------------------------------

### Schema: BoxCreate

Source: https://api.kotsklad.ru/openapi.json

Schema definition for BoxCreate

```markdown
## Schema: BoxCreate

Schema definition for BoxCreate

**Type:** object

- **warehouse_id** (integer) (required)
- **big_size** (boolean)
- **repair_box** (boolean)

```

--------------------------------

### POST /items/bulk/activate

Source: https://api.kotsklad.ru/openapi.json

Массовая активация предметов по UUID или serial_number

```markdown
### Request Body

**Content-Type:** application/json

- Array of string

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X POST "https://api.example.com/items/bulk/activate" \
  -H "Content-Type: application/json" \
  -d '[
  "string"
]'
```

```

--------------------------------

### POST /boxes/bulk/set_stop

Source: https://api.kotsklad.ru/openapi.json

Массовая установка/снятие стопа с коробок

```markdown
### Parameters

- **stop_value** (boolean, query, required)

### Request Body

**Content-Type:** application/json

- Array of string

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X POST "https://api.example.com/boxes/bulk/set_stop?stop_value=true" \
  -H "Content-Type: application/json" \
  -d '[
  "string"
]'
```

```

--------------------------------

### POST /boxes/bulk/set_repair

Source: https://api.kotsklad.ru/openapi.json

Массовая установка/снятие ремонтного статуса коробок

```markdown
### Parameters

- **repair_value** (boolean, query, required)

### Request Body

**Content-Type:** application/json

- Array of string

### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X POST "https://api.example.com/boxes/bulk/set_repair?repair_value=true" \
  -H "Content-Type: application/json" \
  -d '[
  "string"
]'
```

```

--------------------------------

### Schema: StaffPositionCreate

Source: https://api.kotsklad.ru/openapi.json

Schema definition for StaffPositionCreate

```markdown
## Schema: StaffPositionCreate

Schema definition for StaffPositionCreate

**Type:** object

- **name** (string) (required)
- **description** (string)
- **default_price_per_shift** (number)

```

--------------------------------

### PUT /estimates/{estimate_id}

Source: https://api.kotsklad.ru/openapi.json

Обновить смету

```markdown
### Parameters

- **estimate_id** (integer, path, required)

### Request Body

**Content-Type:** application/json


### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X PUT "https://api.example.com/estimates/{estimate_id}" \
  -H "Content-Type: application/json" \
  -d '"value"'
```

```

--------------------------------

### Schema: Item

Source: https://api.kotsklad.ru/openapi.json

Schema definition for Item

```markdown
## Schema: Item

Schema definition for Item

**Type:** object

- **id** (string) (required)
- **warehouse_id** (integer) (required)
- **serial_number** (string) (required)
- **category_id** (integer) (required)
- **name** (string)
- **price_per_day** (number)
- **category_number** (integer) (required)
- **status** (boolean) (required)
- **big_size** (boolean)
- **box_id** (string)
- **case_id** (string)
- **is_kit_main** (boolean)
- **kit_main_id** (string)
- **kit_info** (object)

```

--------------------------------

### POST /users/token

Source: https://api.kotsklad.ru/openapi.json

API endpoint for POST /users/token

```markdown
### Request Body

**Content-Type:** application/x-www-form-urlencoded

- **grant_type** (string)
- **username** (string) (required)
- **password** (string) (required)
- **scope** (string)
- **client_id** (string)
- **client_secret** (string)

### Responses

#### 200 - Successful Response

**APIResponse_Token_**
- **status** (string) (required)
- **data** (object)
  - **access_token** (string) (required)
  - **refresh_token** (string) (required)
  - **token_type** (string) (required)
- **message** (string)

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X POST "https://api.example.com/users/token" \
  -H "Content-Type: application/json" \
  -d '{
  "grant_type": "value",
  "username": "string",
  "password": "string",
  "scope": "",
  "client_id": "value",
  "client_secret": "value"
}'
```

```

--------------------------------

### Schema: WarehouseWithUsers

Source: https://api.kotsklad.ru/openapi.json

Schema definition for WarehouseWithUsers

```markdown
## Schema: WarehouseWithUsers

Schema definition for WarehouseWithUsers

**Type:** object

- **name** (string) (required)
- **description** (string)
- **is_active** (boolean)
- **id** (integer) (required)
- **created_at** (string (date-time)) (required)
- **updated_at** (string (date-time)) (required)
- **users** (array (WarehouseUser))
  Array items:
    - **user_id** (integer) (required)
    - **role** (string)
    - **id** (integer) (required)
    - **warehouse_id** (integer) (required)
    - **created_at** (string (date-time)) (required)

```

--------------------------------

### Schema: Token

Source: https://api.kotsklad.ru/openapi.json

Schema definition for Token

```markdown
## Schema: Token

Schema definition for Token

**Type:** object

- **access_token** (string) (required)
- **refresh_token** (string) (required)
- **token_type** (string) (required)

```

--------------------------------

### PUT /estimates/{estimate_id}/items/{item_id}

Source: https://api.kotsklad.ru/openapi.json

Обновить позицию сметы по ID estimateItem

```markdown
### Parameters

- **estimate_id** (integer, path, required)
- **item_id** (integer, path, required)

### Request Body

**Content-Type:** application/json


### Responses

#### 200 - Successful Response


#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X PUT "https://api.example.com/estimates/{estimate_id}/items/{item_id}" \
  -H "Content-Type: application/json" \
  -d '"value"'
```

```

--------------------------------

### Schema: WarehouseUser

Source: https://api.kotsklad.ru/openapi.json

Schema definition for WarehouseUser

```markdown
## Schema: WarehouseUser

Schema definition for WarehouseUser

**Type:** object

- **user_id** (integer) (required)
- **role** (string)
- **id** (integer) (required)
- **warehouse_id** (integer) (required)
- **created_at** (string (date-time)) (required)

```

--------------------------------

### POST /users/token/refresh

Source: https://api.kotsklad.ru/openapi.json

API endpoint for POST /users/token/refresh

```markdown
### Parameters

- **refresh_token** (string, query, required)

### Responses

#### 200 - Successful Response

**APIResponse_Token_**
- **status** (string) (required)
- **data** (object)
  - **access_token** (string) (required)
  - **refresh_token** (string) (required)
  - **token_type** (string) (required)
- **message** (string)

#### 422 - Validation Error

**HTTPValidationError**
- **detail** (array (ValidationError))
  Array items:
    - **loc** (array (union)) (required)
    - **msg** (string) (required)
    - **type** (string) (required)

### Example Usage

```bash
curl -X POST "https://api.example.com/users/token/refresh?refresh_token=string"
```

```