# 카테고리 관리

## 카테고리 목록 조회

 - [GET /categories](https://kollus-api.redocly.app/products/vod/openapi/%EC%B9%B4%ED%85%8C%EA%B3%A0%EB%A6%AC-%EA%B4%80%EB%A6%AC/getcategories.md): 전체 카테고리 목록을 조회합니다. parent_category_key를 지정하면, 지정된 상위 카테고리의 모든 하위 카테고리 목록을 반환합니다.

## 신규 카테고리 생성

 - [POST /categories](https://kollus-api.redocly.app/products/vod/openapi/%EC%B9%B4%ED%85%8C%EA%B3%A0%EB%A6%AC-%EA%B4%80%EB%A6%AC/createcategory.md): 새로운 카테고리를 생성합니다. parent_category_key를 지정하면, 생성된 카테고리는 지정된 상위 카테고리의 하위 카테고리로 등록됩니다.

## 카테고리 정보 조회

 - [GET /categories/{category_key}](https://kollus-api.redocly.app/products/vod/openapi/%EC%B9%B4%ED%85%8C%EA%B3%A0%EB%A6%AC-%EA%B4%80%EB%A6%AC/getcategory.md): 특정 카테고리의 상세 정보와 해당 카테고리에 연결된 채널 목록을 조회합니다.

## 카테고리 이름 수정

 - [PUT /categories/{category_key}](https://kollus-api.redocly.app/products/vod/openapi/%EC%B9%B4%ED%85%8C%EA%B3%A0%EB%A6%AC-%EA%B4%80%EB%A6%AC/updatecategory.md): 기존 카테고리의 이름을 변경합니다.

## 카테고리 삭제

 - [DELETE /categories/{category_key}](https://kollus-api.redocly.app/products/vod/openapi/%EC%B9%B4%ED%85%8C%EA%B3%A0%EB%A6%AC-%EA%B4%80%EB%A6%AC/deletecategory.md): 특정 카테고리를 시스템에서 영구적으로 삭제합니다. 삭제된 카테고리에 소속된 콘텐츠 파일은 시스템에 유지됩니다. 하위 카테고리의 위치는 계층 구조에 따라 자동으로 재조정됩니다. (관련 문서: 카테고리 삭제)

## 카테고리-채널 연결

 - [POST /categories/{category_key}/channels/{channel_key}/attach](https://kollus-api.redocly.app/products/vod/openapi/%EC%B9%B4%ED%85%8C%EA%B3%A0%EB%A6%AC-%EA%B4%80%EB%A6%AC/attachchanneltocategory.md): 특정 카테고리와 특정 채널을 연결합니다.

## 카테고리-채널 연결 해제

 - [DELETE /categories/{category_key}/channels/{channel_key}/detach](https://kollus-api.redocly.app/products/vod/openapi/%EC%B9%B4%ED%85%8C%EA%B3%A0%EB%A6%AC-%EA%B4%80%EB%A6%AC/detachchannelfromcategory.md): 카테고리와 채널의 연결 상태를 해제합니다.