---
title: "List scenario folders"
method: GET
path: "/scenarios-folders"
tags: ["Scenarios folders"]
---

# List scenario folders

`GET /scenarios-folders`

Retrieves direct scenario folder children for a team or organization. Provide teamId or organizationId. If both are provided, teamId is used. Omit parentId to return top-level folders.

## Query parameters

- `teamId` integer, required
- `organizationId` integer
- `parentId` integer
- `childrenDepth` 'all'
- `cols[]` string[]

## Response `200`

Successful response

- object
  - `scenariosFolders` object[]
    - `id` integer
    - `name` string
    - `path` string — Slash-separated folder path including this folder, for example `CRM/cleanup`.
    - `teamId` integer — The unique ID of the team that owns the folder. Returned when listing folders by organization.
    - `parentId` integer, nullable
    - `position` integer, nullable
    - `scenariosTotal` integer — Number of scenarios directly assigned to this folder.
    - `scenariosSubtreeTotal` integer — Number of scenarios assigned to this folder or any descendant folder.
    - `scenariosDeleted` integer — Number of deleted scenarios directly assigned to this folder. Available to admin callers.
    - `scenariosDeletedSubtreeTotal` integer — Number of deleted scenarios assigned to this folder or any descendant folder. Available to admin callers.
    - `hasChildren` boolean — Whether this folder has direct child folders. Use parentId to retrieve them.
    - `children` object[] — Direct child folders of this folder. Contains all descendants when childrenDepth is set to `all`.
      - `id` integer
      - `name` string
      - `path` string
      - `teamId` integer — The unique ID of the team that owns the folder. Returned when listing folders by organization.
      - `parentId` integer, nullable
      - `position` integer, nullable
      - `scenariosTotal` integer
      - `scenariosSubtreeTotal` integer
      - `scenariosDeleted` integer — Number of deleted scenarios directly assigned to this folder. Available to admin callers.
      - `scenariosDeletedSubtreeTotal` integer — Number of deleted scenarios assigned to this folder or any descendant folder. Available to admin callers.
      - `hasChildren` boolean — Whether this folder has direct child folders. Use parentId to retrieve them.

---

[API](https://skmtc.dev/make/apis/web-api-v2-public.md) · [All operations](https://skmtc.dev/make/apis/web-api-v2-public/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/make/web-api-v2-public/revisions/531769e6f813/schema)