> For the complete documentation index, see [llms.txt](https://developers.make.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.make.com/api-documentation/api-reference/scenarios-folders.md).

# Scenarios Folders

Scenarios can be grouped into folders for better organization. The following endpoints allow you to create and manage scenarios folders.

## List scenario 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.

```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Scenarios folders","description":"Scenarios can be grouped into folders for better organization. The following endpoints allow you to create and manage scenarios folders."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["scenarios:read"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/scenarios-folders":{"get":{"tags":["Scenarios folders"],"summary":"List scenario folders","description":"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.","parameters":[{"name":"teamId","in":"query","schema":{"type":"integer"},"description":"Unique ID of the Team.","required":true},{"name":"organizationId","in":"query","description":"The unique ID of the organization whose scenario folders should be returned.","schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"parentId","in":"query","description":"The parent folder whose direct children should be returned. Omit to return top-level folders.","schema":{"type":"integer","minimum":1,"maximum":2147483647}},{"name":"childrenDepth","in":"query","description":"Set to `all` to return all descendants under `children`. By default, `children` includes only one direct child level.","schema":{"type":"string","enum":["all"]}},{"name":"cols[]","in":"query","description":"Specifies the group of values to return. For example, you may want to receive in response only the names and IDs of folders.","schema":{"type":"array","items":{"type":"string","enum":["id","name","path","parentId","position","scenariosTotal","scenariosSubtreeTotal","scenariosDeleted","scenariosDeletedSubtreeTotal","hasChildren","children"]}}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"scenariosFolders":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"path":{"type":"string","description":"Slash-separated folder path including this folder, for example `CRM/cleanup`."},"teamId":{"type":"integer","description":"The unique ID of the team that owns the folder. Returned when listing folders by organization."},"parentId":{"type":"integer","nullable":true},"position":{"type":"integer","nullable":true},"scenariosTotal":{"type":"integer","description":"Number of scenarios directly assigned to this folder."},"scenariosSubtreeTotal":{"type":"integer","description":"Number of scenarios assigned to this folder or any descendant folder."},"scenariosDeleted":{"type":"integer","description":"Number of deleted scenarios directly assigned to this folder. Available to admin callers."},"scenariosDeletedSubtreeTotal":{"type":"integer","description":"Number of deleted scenarios assigned to this folder or any descendant folder. Available to admin callers."},"hasChildren":{"type":"boolean","description":"Whether this folder has direct child folders. Use parentId to retrieve them."},"children":{"type":"array","description":"Direct child folders of this folder. Contains all descendants when childrenDepth is set to `all`.","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"path":{"type":"string"},"teamId":{"type":"integer","description":"The unique ID of the team that owns the folder. Returned when listing folders by organization."},"parentId":{"type":"integer","nullable":true},"position":{"type":"integer","nullable":true},"scenariosTotal":{"type":"integer"},"scenariosSubtreeTotal":{"type":"integer"},"scenariosDeleted":{"type":"integer","description":"Number of deleted scenarios directly assigned to this folder. Available to admin callers."},"scenariosDeletedSubtreeTotal":{"type":"integer","description":"Number of deleted scenarios assigned to this folder or any descendant folder. Available to admin callers."},"hasChildren":{"type":"boolean","description":"Whether this folder has direct child folders. Use parentId to retrieve them."}}}}}}}}}}}}}}}}}
```

## Create scenario folder

> Creates a new scenario folder with data passed in the request body. As the response, it returns all details of the created scenario folder.

```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Scenarios folders","description":"Scenarios can be grouped into folders for better organization. The following endpoints allow you to create and manage scenarios folders."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["scenarios:write"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/scenarios-folders":{"post":{"tags":["Scenarios folders"],"summary":"Create scenario folder","description":"Creates a new scenario folder with data passed in the request body. As the response, it returns all details of the created scenario folder.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"The name of the scenario folder. The name must be at most 100 characters long and does not need to be unique."},"teamId":{"type":"integer","minimum":1,"maximum":2147483647,"description":"The unique ID of the team in which the scenario folder will be created."},"parentId":{"type":"integer","minimum":1,"maximum":2147483647,"nullable":true,"description":"The unique ID of the parent scenario folder. Omit or pass null to create a top-level folder."}},"required":["name","teamId"]}}}},"responses":{"200":{"description":"Created a Folder","content":{"application/json":{"schema":{"type":"object","properties":{"scenarioFolder":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"path":{"type":"string","description":"Slash-separated folder path including this folder, for example `CRM/cleanup`."},"teamId":{"type":"integer","description":"The unique ID of the team that owns the folder. Returned when listing folders by organization."},"parentId":{"type":"integer","nullable":true},"position":{"type":"integer","nullable":true},"scenariosTotal":{"type":"integer","description":"Number of scenarios directly assigned to this folder."},"scenariosSubtreeTotal":{"type":"integer","description":"Number of scenarios assigned to this folder or any descendant folder."},"scenariosDeleted":{"type":"integer","description":"Number of deleted scenarios directly assigned to this folder. Available to admin callers."},"scenariosDeletedSubtreeTotal":{"type":"integer","description":"Number of deleted scenarios assigned to this folder or any descendant folder. Available to admin callers."},"hasChildren":{"type":"boolean","description":"Whether this folder has direct child folders. Use parentId to retrieve them."},"children":{"type":"array","description":"Direct child folders of this folder. Contains all descendants when childrenDepth is set to `all`.","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"path":{"type":"string"},"teamId":{"type":"integer","description":"The unique ID of the team that owns the folder. Returned when listing folders by organization."},"parentId":{"type":"integer","nullable":true},"position":{"type":"integer","nullable":true},"scenariosTotal":{"type":"integer"},"scenariosSubtreeTotal":{"type":"integer"},"scenariosDeleted":{"type":"integer","description":"Number of deleted scenarios directly assigned to this folder. Available to admin callers."},"scenariosDeletedSubtreeTotal":{"type":"integer","description":"Number of deleted scenarios assigned to this folder or any descendant folder. Available to admin callers."},"hasChildren":{"type":"boolean","description":"Whether this folder has direct child folders. Use parentId to retrieve them."}}}}}}}}}}}}}}}}
```

## Move scenarios to a folder

> Moves selected scenarios from the specified team into a target folder. Use \`targetFolderId: null\` to uncategorize them.

```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Scenarios folders","description":"Scenarios can be grouped into folders for better organization. The following endpoints allow you to create and manage scenarios folders."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["scenarios:write"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/scenarios-folders/move-scenarios":{"post":{"tags":["Scenarios folders"],"summary":"Move scenarios to a folder","description":"Moves selected scenarios from the specified team into a target folder. Use `targetFolderId: null` to uncategorize them.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"teamId":{"type":"integer","minimum":1,"maximum":2147483647,"description":"The team that owns all scenarios and the target folder."},"scenarioIds":{"type":"array","minItems":1,"maxItems":10000,"items":{"type":"integer","minimum":1,"maximum":2147483647},"description":"The scenario IDs to move."},"targetFolderId":{"type":"integer","minimum":1,"maximum":2147483647,"nullable":true,"description":"The target folder ID. Use null to uncategorize the scenarios."}},"required":["teamId","scenarioIds","targetFolderId"]}}}},"responses":{"200":{"description":"Scenarios moved","content":{"application/json":{"schema":{"type":"object","properties":{"movedScenarioIds":{"type":"array","items":{"type":"integer"}},"targetFolderId":{"type":"integer","nullable":true}},"required":["movedScenarioIds","targetFolderId"]}}}}}}}}}
```

## Reorder scenario folders

> Sets manual positions for direct sibling folders within one parent. Omitted siblings have their position cleared and are listed alphabetically after positioned folders.

```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Scenarios folders","description":"Scenarios can be grouped into folders for better organization. The following endpoints allow you to create and manage scenarios folders."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["scenarios:write"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/scenarios-folders/reorder":{"post":{"tags":["Scenarios folders"],"summary":"Reorder scenario folders","description":"Sets manual positions for direct sibling folders within one parent. Omitted siblings have their position cleared and are listed alphabetically after positioned folders.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"teamId":{"type":"integer","minimum":1,"maximum":2147483647,"description":"The team that owns the sibling folder set."},"parentId":{"type":"integer","minimum":1,"maximum":2147483647,"nullable":true,"description":"The parent folder whose direct children are being reordered. Omit or pass null for top-level folders."},"folderIds":{"type":"array","minItems":1,"maxItems":999,"uniqueItems":true,"items":{"type":"integer","minimum":1,"maximum":2147483647},"description":"Folder IDs in the desired order. All folders must be direct siblings under parentId. Omitted sibling folders have their position cleared."}},"required":["teamId","folderIds"]}}}},"responses":{"200":{"description":"Scenario folders reordered","content":{"application/json":{"schema":{"type":"object","properties":{"reorderedFolderIds":{"type":"array","items":{"type":"integer"}},"parentId":{"type":"integer","nullable":true}},"required":["reorderedFolderIds","parentId"]}}}}}}}}}
```

## Delete scenario folder

> Deletes a scenario folder with a given ID and returns the ID in the response. Scenarios in the deleted folder and its subfolders are moved to the deleted folder's parent, or uncategorized when deleting a top-level folder. Descendant folders are deleted.

```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Scenarios folders","description":"Scenarios can be grouped into folders for better organization. The following endpoints allow you to create and manage scenarios folders."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["scenarios:write"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/scenarios-folders/{folderId}":{"delete":{"tags":["Scenarios folders"],"summary":"Delete scenario folder","description":"Deletes a scenario folder with a given ID and returns the ID in the response. Scenarios in the deleted folder and its subfolders are moved to the deleted folder's parent, or uncategorized when deleting a top-level folder. Descendant folders are deleted.","parameters":[{"name":"folderId","in":"path","schema":{"type":"integer"},"description":"The unique ID of the scenario folder. It can be retrieved from the [List scenarios folders](/api-reference/scenarios-folders/get--scenarios-folders.md) endpoint.","required":true}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"scenarioFolder":{"type":"integer"}}}}}}}}}}}
```

## Update scenario folder

> Updates a scenario folder with a given ID by passing a new name, a new parent folder, or both in the request body. Use parentId null to move the folder to the top level. Any property that is not provided will be left unchanged. In the response, it returns all details of the updated folder including properties that were not changed.

```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Scenarios folders","description":"Scenarios can be grouped into folders for better organization. The following endpoints allow you to create and manage scenarios folders."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["scenarios:write"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/scenarios-folders/{folderId}":{"patch":{"tags":["Scenarios folders"],"summary":"Update scenario folder","description":"Updates a scenario folder with a given ID by passing a new name, a new parent folder, or both in the request body. Use parentId null to move the folder to the top level. Any property that is not provided will be left unchanged. In the response, it returns all details of the updated folder including properties that were not changed.","parameters":[{"name":"folderId","in":"path","schema":{"type":"integer"},"description":"The unique ID of the scenario folder. It can be retrieved from the [List scenarios folders](/api-reference/scenarios-folders/get--scenarios-folders.md) endpoint.","required":true},{"name":"cols[]","in":"query","description":"Specifies the group of values to return. For example, you may want to receive in response only the names and IDs of folders.","schema":{"type":"array","items":{"type":"string","enum":["id","name","path","parentId","position","scenariosTotal","scenariosSubtreeTotal","scenariosDeleted","scenariosDeletedSubtreeTotal","hasChildren","children"]}}}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","minProperties":1,"additionalProperties":false,"properties":{"name":{"type":"string","description":"The name for the updated scenario folder. The name must be at most 100 characters long and does not need to be unique."},"parentId":{"type":"integer","minimum":1,"maximum":2147483647,"nullable":true,"description":"The unique ID of the new parent scenario folder. Use null to move the folder to the top level."}}}}}},"responses":{"200":{"description":"Folder updated","content":{"application/json":{"schema":{"type":"object","properties":{"scenarioFolder":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"path":{"type":"string","description":"Slash-separated folder path including this folder, for example `CRM/cleanup`."},"teamId":{"type":"integer","description":"The unique ID of the team that owns the folder. Returned when listing folders by organization."},"parentId":{"type":"integer","nullable":true},"position":{"type":"integer","nullable":true},"scenariosTotal":{"type":"integer","description":"Number of scenarios directly assigned to this folder."},"scenariosSubtreeTotal":{"type":"integer","description":"Number of scenarios assigned to this folder or any descendant folder."},"scenariosDeleted":{"type":"integer","description":"Number of deleted scenarios directly assigned to this folder. Available to admin callers."},"scenariosDeletedSubtreeTotal":{"type":"integer","description":"Number of deleted scenarios assigned to this folder or any descendant folder. Available to admin callers."},"hasChildren":{"type":"boolean","description":"Whether this folder has direct child folders. Use parentId to retrieve them."},"children":{"type":"array","description":"Direct child folders of this folder. Contains all descendants when childrenDepth is set to `all`.","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"path":{"type":"string"},"teamId":{"type":"integer","description":"The unique ID of the team that owns the folder. Returned when listing folders by organization."},"parentId":{"type":"integer","nullable":true},"position":{"type":"integer","nullable":true},"scenariosTotal":{"type":"integer"},"scenariosSubtreeTotal":{"type":"integer"},"scenariosDeleted":{"type":"integer","description":"Number of deleted scenarios directly assigned to this folder. Available to admin callers."},"scenariosDeletedSubtreeTotal":{"type":"integer","description":"Number of deleted scenarios assigned to this folder or any descendant folder. Available to admin callers."},"hasChildren":{"type":"boolean","description":"Whether this folder has direct child folders. Use parentId to retrieve them."}}}}}}}}}}}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developers.make.com/api-documentation/api-reference/scenarios-folders.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.