# SectionsApi All URIs are relative to *http://localhost* | Method | HTTP request | Description | |------------- | ------------- | -------------| | [**apiV2SectionsIdPatch**](SectionsApi.md#apiV2SectionsIdPatch) | **PATCH** /api/v2/sections/{id} | Patch section | | [**createSection**](SectionsApi.md#createSection) | **POST** /api/v2/sections | Create section | | [**deleteSection**](SectionsApi.md#deleteSection) | **DELETE** /api/v2/sections/{id} | Delete section | | [**getSectionById**](SectionsApi.md#getSectionById) | **GET** /api/v2/sections/{id} | Get section | | [**getWorkItemsBySectionId**](SectionsApi.md#getWorkItemsBySectionId) | **GET** /api/v2/sections/{id}/workItems | Get section work items | | [**move**](SectionsApi.md#move) | **POST** /api/v2/sections/move | Move section with all work items into another section | | [**rename**](SectionsApi.md#rename) | **POST** /api/v2/sections/rename | Rename section | | [**updateSection**](SectionsApi.md#updateSection) | **PUT** /api/v2/sections | Update section | # **apiV2SectionsIdPatch** > apiV2SectionsIdPatch(id, Operation) Patch section See <a href=\"https://www.rfc-editor.org/rfc/rfc6902\" target=\"_blank\">RFC 6902: JavaScript Object Notation (JSON) Patch</a> for details ### Parameters |Name | Type | Description | Notes | |------------- | ------------- | ------------- | -------------| | **id** | **UUID**| Section internal (UUID) identifier | [default to null] | | **Operation** | [**List**](../Models/Operation.md)| | [optional] | ### Return type null (empty response body) ### Authorization [Bearer or PrivateToken](../README.md#Bearer or PrivateToken) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json # **createSection** > SectionWithStepsModel createSection(SectionPostModel) Create section <br>Use case <br>User sets section properties (listed in request example) <br>User runs method execution <br>System creates section property values <br>System returns section (listed in response example) ### Parameters |Name | Type | Description | Notes | |------------- | ------------- | ------------- | -------------| | **SectionPostModel** | [**SectionPostModel**](../Models/SectionPostModel.md)| | [optional] | ### Return type [**SectionWithStepsModel**](../Models/SectionWithStepsModel.md) ### Authorization [Bearer or PrivateToken](../README.md#Bearer or PrivateToken) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json # **deleteSection** > deleteSection(id) Delete section <br>Use case <br>User sets section identifier <br>User runs method execution <br>System search section by the identifier <br>System search and delete nested sections of the found section <br>System search and delete workitems related to the found nested sections <br>System deletes initial section and related workitem <br>System returns no content response ### Parameters |Name | Type | Description | Notes | |------------- | ------------- | ------------- | -------------| | **id** | **UUID**| Section internal (UUID) identifier | [default to null] | ### Return type null (empty response body) ### Authorization [Bearer or PrivateToken](../README.md#Bearer or PrivateToken) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json # **getSectionById** > SectionWithStepsModel getSectionById(id, isDeleted) Get section <br>Use case <br>User sets section internal (guid format) identifier <br>User runs method execution <br>System search section by the section identifier <br> [Optional] If isDeleted flag equals false, deleted work items are not being searched. If true, deleted work items are also being searched, null for all work items. <br>System returns section ### Parameters |Name | Type | Description | Notes | |------------- | ------------- | ------------- | -------------| | **id** | **UUID**| Section internal (UUID) identifier | [default to null] | | **isDeleted** | [**DeletionState**](../Models/.md)| | [optional] [default to null] [enum: Any, Deleted, NotDeleted] | ### Return type [**SectionWithStepsModel**](../Models/SectionWithStepsModel.md) ### Authorization [Bearer or PrivateToken](../README.md#Bearer or PrivateToken) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json # **getWorkItemsBySectionId** > List getWorkItemsBySectionId(id, isDeleted, tagNames, includeIterations, Skip, Take, OrderBy, SearchField, SearchValue) Get section work items <br>Use case <br>User sets section identifier <br>User runs method execution <br>System search section by the identifier <br>System search work items related to the section <br> [Optional] If isDeleted flag equals false, deleted work items are not being searched. If true, deleted work items are also being searched, null for all work items. <br>System returns work item collection ### Parameters |Name | Type | Description | Notes | |------------- | ------------- | ------------- | -------------| | **id** | **UUID**| Section internal (UUID) identifier | [default to null] | | **isDeleted** | **Boolean**| Requested section is deleted | [optional] [default to false] | | **tagNames** | [**List**](../Models/String.md)| List of work item tags | [optional] [default to null] | | **includeIterations** | **Boolean**| | [optional] [default to true] | | **Skip** | **Integer**| Amount of items to be skipped (offset) | [optional] [default to null] | | **Take** | **Integer**| Amount of items to be taken (limit) | [optional] [default to null] | | **OrderBy** | **String**| SQL-like ORDER BY statement (column1 ASC|DESC , column2 ASC|DESC) | [optional] [default to null] | | **SearchField** | **String**| Property name for searching | [optional] [default to null] | | **SearchValue** | **String**| Value for searching | [optional] [default to null] | ### Return type [**List**](../Models/WorkItemShortModel.md) ### Authorization [Bearer or PrivateToken](../README.md#Bearer or PrivateToken) ### HTTP request headers - **Content-Type**: Not defined - **Accept**: application/json # **move** > move(SectionMoveModel) Move section with all work items into another section ### Parameters |Name | Type | Description | Notes | |------------- | ------------- | ------------- | -------------| | **SectionMoveModel** | [**SectionMoveModel**](../Models/SectionMoveModel.md)| | [optional] | ### Return type null (empty response body) ### Authorization [Bearer or PrivateToken](../README.md#Bearer or PrivateToken) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json # **rename** > rename(SectionRenameModel) Rename section <br>Use case <br>User sets section identifier and new name (listed in request example) <br>User runs method execution <br>System search section by the identifier <br>System updates section name using the new name <br>System returns no content response ### Parameters |Name | Type | Description | Notes | |------------- | ------------- | ------------- | -------------| | **SectionRenameModel** | [**SectionRenameModel**](../Models/SectionRenameModel.md)| | [optional] | ### Return type null (empty response body) ### Authorization [Bearer or PrivateToken](../README.md#Bearer or PrivateToken) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json # **updateSection** > updateSection(SectionPutModel) Update section <br>Use case <br>User sets section properties (listed in request example) <br>User runs method execution <br>System search section by the identifier <br>System updates section using the property values <br>System returns no content response ### Parameters |Name | Type | Description | Notes | |------------- | ------------- | ------------- | -------------| | **SectionPutModel** | [**SectionPutModel**](../Models/SectionPutModel.md)| | [optional] | ### Return type null (empty response body) ### Authorization [Bearer or PrivateToken](../README.md#Bearer or PrivateToken) ### HTTP request headers - **Content-Type**: application/json - **Accept**: application/json