---
title: "List Call Flows"
api: "GET /v1/api/call-flows"
description: "Retrieve a list of all call flows in the workspace."
---

### Headers  

<ParamField header="x-workspace-id" type="string" required>
  Workspace identifier for the API.
</ParamField>

### Response Fields

Each object in the response array represents a call flow within the workspace, containing the following fields:

<ResponseField name="_id" type="string">
  The unique identifier for the call flow.
</ResponseField>

<ResponseField name="workspaceId" type="string">
  The identifier of the workspace where the call flow is configured.
</ResponseField>

<ResponseField name="name" type="string">
  The name assigned to the call flow.
</ResponseField>

<ResponseField name="direction" type="string">
  Indicates the direction of the call flow, such as "inbound" or "bidirectional".
</ResponseField>

<ResponseField name="agent" type="string">
  The identifier of the agent associated with the call flow.
</ResponseField>

<ResponseField name="isActive" type="boolean">
  A boolean indicating whether the call flow is currently active.
</ResponseField>

<ResponseField name="promptType" type="string">
  The type of prompt used in the call flow, either "simple" or "flow".
</ResponseField>

<ResponseField name="createdAt" type="string">
  Timestamp when the call flow was updated.
</ResponseField>

<ResponseField name="updatedAt" type="string">
  Timestamp when the call flow was last updated.
</ResponseField>


<ResponseExample>

```json
[
  {
    "_id": "flowId1",
    "workspaceId": "workspaceIdExample1",
    "name": "Customer Support Flow",
    "direction": "inbound",
    "agent": "agentIdExample1",
    "isActive": true,
    "promptType": "simple",
    "createdAt": "2025-01-02T09:00:00Z",
    "updatedAt": "2025-01-02T09:30:00Z"
  },
  {
    "_id": "flowId2",
    "workspaceId": "workspaceIdExample2",
    "name": "Sales Inquiry Flow",
    "direction": "bidirectional",
    "agent": "agentIdExample2",
    "isActive": false,
    "promptType": "flow",
    "createdAt": "2025-01-05T09:00:00Z",
    "updatedAt": "2025-01-06T12:00:00Z"
  }
]
```

</ResponseExample>