> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Scenario Folders

> See which folder each of your agents' scenarios is filed in.

### Overview

Returns one entry for every scenario your organization has filed in a folder. The list is flat: each entry names one scenario and its folder. It doesn't list folders, and it doesn't group scenarios by folder.

Scenarios you haven't filed are left out, so the list is empty until you file one with [File Scenario in Folder](https://docs.bland.ai/api-v2/put/agents-library-scenario-folders.md). Migrating a pathway into an agent doesn't file its scenarios. Entries for deleted agents are left out, but an entry stays when its scenario is removed from an agent, so match entries against [List Library Scenarios](https://docs.bland.ai/api-v2/get/agents-library-scenarios.md). Call it with `paginate=true` and walk every page, or you'll miss agents past the first 50. An entry for a node that isn't in the agent's latest saved version won't match until that version is saved.

To list, create, rename, or delete folders, use the folder endpoints, such as [Get All Folders](https://docs.bland.ai/api-v1/get/pathway_folders.md) and [Create Folder](https://docs.bland.ai/api-v1/post/create_pathway_folder.md). Deleting a folder takes every scenario filed in it out of the folder.

Restricted API keys can't call this endpoint. Use a full-access key.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Response

**data** `array`

One entry per filed scenario.

**entry**

**agent\_id** `string`

The agent the scenario belongs to.

**node\_id** `string`

The scenario's node ID: the `id` of a scenario from [List Library Scenarios](https://docs.bland.ai/api-v2/get/agents-library-scenarios.md).

**folder\_id** `string`

The folder the scenario is filed in.

**errors** `null | array`

`null` on success, or a list of error objects if the request failed.

```json Response theme={null}
{
  "data": [
    {
      "agent_id": "b5154820-6f11-4886-8523-d896934528ae",
      "node_id": "00fa3bcf-56f5-45b9-8996-427d57b091b7",
      "folder_id": "6f0e2a6c-1d3b-4f6e-9a57-2c8d1e4b7a90"
    }
  ],
  "errors": null
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.