# exo_get_flow

> Documentation index: https://exomations.com/llms.txt

One flow's definition and settings, with secrets masked.

Returns the flow's steps and links so an assistant can change them and send them back with `exo_update_flow`. Settings whose names look like credentials (secrets, passwords, tokens, API keys) come back as `***`; sending `***` back keeps the stored value.

Permission: `build`.

## Input

| Name | Type | Required | Description |
|---|---|---|---|
| `flowId` | string | yes | The flow id. |

## Returns

`id`, `name`, `description`, `status`, `mode`, `triggerType`, `projectId` and `definition` (`nodes` and `edges`).

## Errors

- Tool result with `isError: true`: `flowId is required.`
- Tool result with `isError: true`: `Flow "<flowId>" not found.`
- JSON-RPC -32001 (HTTP 403): `API key lacks the 'build' permission required for flow authoring tools`

## Example call

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "exo_get_flow",
    "arguments": {
      "flowId": "7a17617d-3c4e-4f0a-9b1e-2d5c8e0f4a61"
    }
  }
}
```

## Example result

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Flow \"Overdue invoice reminders\" (active).\n{ ... }"
      }
    ],
    "structuredContent": {
      "id": "7a17617d-3c4e-4f0a-9b1e-2d5c8e0f4a61",
      "name": "Overdue invoice reminders",
      "description": null,
      "status": "active",
      "mode": "orchestration",
      "triggerType": "webhook",
      "projectId": "c3e1a9d4-8b2f-4f6e-a0c7-5d9b2e1f7a33",
      "definition": {
        "nodes": [
          "..."
        ],
        "edges": [
          "..."
        ]
      }
    },
    "isError": false
  }
}
```
