Retrieve all folders in your organization. Optionally include full hierarchy with child folders and automations.

## Query Parameters

**`organization_id`** string required

Organization ID (org_ prefixed)

**`include_contents`** boolean optional

When `true`, includes child folders, automations, and counts for each folder. Default: `false`

## Returns

Returns an object containing an array of folder objects. When `include_contents=true`, each folder includes `child_folders`, `automations`, `folder_count`, and `automation_count` fields.

Request

```bash cURL
curl -X GET "https://api.aitronos.com/api/v1/streamline/folders?organization_id=org_xyz789" \
  -H "X-API-Key: $FREDDY_API_KEY"
```


```python Python
import os
import requests

api_key = os.environ["FREDDY_API_KEY"]
organization_id = "org_xyz789"

response = requests.get(
    "https://api.aitronos.com/api/v1/streamline/folders",
    headers={"X-API-Key": api_key},
    params={"organization_id": organization_id}
)

folders = response.json()
print(f"Found {len(folders['folders'])} folders")
```


```javascript JavaScript
const apiKey = process.env.FREDDY_API_KEY;
const organizationId = "org_xyz789";

const response = await fetch(
  `https://api.aitronos.com/api/v1/streamline/folders?organization_id=${organizationId}`,
  {
    headers: {
      "X-API-Key": apiKey
    }
  }
);

const folders = await response.json();
console.log(`Found ${folders.folders.length} folders`);
```

Response

```json 200 OK
{
  "folders": [
    {
      "id": "sfold_abc123",
      "organization_id": "org_xyz789",
      "created_by_user_id": "usr_def456",
      "parent_folder_id": null,
      "name": "Production Automations",
      "description": "All production-ready workflows",
      "display_order": 1,
      "is_deleted": false,
      "created_at": "2025-11-28T10:30:00Z",
      "updated_at": "2025-11-28T10:30:00Z",
      "deleted_at": null
    },
    {
      "id": "sfold_ghi789",
      "organization_id": "org_xyz789",
      "created_by_user_id": "usr_def456",
      "parent_folder_id": "sfold_abc123",
      "name": "API Integrations",
      "description": null,
      "display_order": 0,
      "is_deleted": false,
      "created_at": "2025-11-28T11:00:00Z",
      "updated_at": "2025-11-28T11:00:00Z",
      "deleted_at": null
    }
  ]
}
```


```json 403 Forbidden
{
  "success": false,
  "error": {
    "code": "FORBIDDEN",
    "message": "Not a member of the organization",
    "status": 403
  }
}
```