---
title: "Get Folder Details with Flows"
api: "GET /v1/api/flow-folders/{folderId}"
description: "Retrieve the details of a specific folder, including its associated flows, by its folderId."
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

### Headers

<ParamField header="x-workspace-id" type="string" required>
  The unique identifier of the workspace being accessed.
</ParamField>

### Path Parameters

<ParamField path="folderId" type="string" required>
  The unique identifier of the folder whose details are being requested.
</ParamField>

### Response Fields

<ResponseField name="_id" type="string">
  The unique identifier of the folder.
</ResponseField>

<ResponseField name="workspaceId" type="string">
  The identifier of the workspace where the folder belongs.
</ResponseField>

<ResponseField name="name" type="string">
  The name of the folder.
</ResponseField>

<ResponseField name="color" type="string">
  The color of the folder, represented as a hex code.
</ResponseField>

<ResponseField name="icon" type="string">
  The icon identifier for the folder.
</ResponseField>

<ResponseField name="flowType" type="string">
  The type of flow, either "call" or "message".
</ResponseField>

<ResponseField name="pathwayModel" type="string">
  The model type for flows, derived from `flowType`.
</ResponseField>

<ResponseField name="pathways" type="array">
  An array of flow objects associated with the folder. Each flow object contains details such as its ID, name, and other relevant information.
</ResponseField>

<ResponseField name="createdAt" type="string">
  Timestamp when the folder was created (ISO 8601 format).
</ResponseField>

<ResponseField name="updatedAt" type="string">
  Timestamp when the folder was last updated (ISO 8601 format).
</ResponseField>

<ResponseExample>
```json
{
  "_id": "folder123",
  "workspaceId": "workspace456",
  "name": "My Workflow Folder",
  "color": "#FF0000",
  "icon": "folder-icon",
  "flowType": "call",
  "pathwayModel": "Flow",
  "pathways": [
    {
      "_id": "flow123",
      "name": "Support Call Flow",
      "description": "Handles customer support calls",
      "createdAt": "2023-10-15T10:00:00Z",
      "updatedAt": "2023-10-15T10:00:00Z"
    }
  ],
  "createdAt": "2023-10-15T09:30:00Z",
  "updatedAt": "2023-10-15T10:00:00Z"
}
```
</ResponseExample>