# Get channel folders

Enumerates the folder or directory hierarchy available in the external system connected by the channel.

Request:
channelId    - ID of the channel to browse.
parentId     - ID of the folder to list children of. Use the root ID to start at the top level.
pagination    - Optional Pagination cursor and page size for large folder listings.

Response:
folders       - List of Folders objects with id, name, isLeaf, and type
(FOLDER, SAVED_SEARCH, or VOCAB).
pageCursor   - Opaque cursor for the next page.

Endpoint: POST /api/v1/channel/retrieve-folders
Version: 3.0
Security: bearerAuth

## Request fields (application/json):

  - `channelId` (string)
    Rule data fields

  - `parentId` (string)
    Rule data fields

  - `pagination` (object)

  - `pagination.pageCursor` (string)
    Rule data fields

  - `pagination.maxSize` (integer)

## Response 200 fields (application/json):

  - `pageCursor` (string)
    Rule data fields

  - `folders` (array)

  - `folders.id` (string)
    Rule data fields

  - `folders.name` (string)
    Rule data fields

  - `folders.isLeaf` (boolean)

  - `folders.type` (integer)
    Enum: 0, 1, 2, 3

## Response 400 fields (application/json):

  - `message` (string)

## Response 401 fields (application/json):

  - `message` (string)

## Response 403 fields (application/json):

  - `message` (string)

## Response 404 fields (application/json):

  - `message` (string)

## Response 409 fields (application/json):

  - `message` (string)

## Response 429 fields (application/json):

  - `message` (string)

## Response 499 fields (application/json):

  - `message` (string)

## Response 500 fields (application/json):

  - `message` (string)

## Response 501 fields (application/json):

  - `message` (string)

## Response 503 fields (application/json):

  - `message` (string)

## Response 504 fields (application/json):

  - `message` (string)