---
title: "Get workflow"
method: GET
path: "/workflow/{workflowId}"
tags: ["Workflows"]
---

# Get workflow

`GET /workflow/{workflowId}`

## Request

- Base URL: `https://app.freyavoice.ai/api/v2`
- URL: `https://app.freyavoice.ai/api/v2/workflow/{workflowId}`
- Auth: HTTP bearer

Returns detailed workflow information including nodes and canvas state.

## Path parameters

- `workflowId` string, uuid, required: Workflow ID

## Query parameters

- `workspaceId` string, uuid, required: Workspace ID

## Response `200`

Workflow details

- object
  - `success` true, required
  - `data` object, required
    - `message` string, required
    - `result` object, required
      - `workflow` object, required
        - `id` string, uuid, required
        - `name` string, required
        - `description` string, nullable, required
        - `version` string, required
        - `tags` string[]
        - `workspaceId` string, uuid, required
        - `template` boolean
        - `canvasViewport` object, nullable, required
          - `x` number, required
          - `y` number, required
          - `zoom` number, required
        - `nodePositions` object
        - `workflow` object
          - `initial_node` string, required
          - `nodes` object, required
          - `globals` union[]
            - union
              - …
        - `executionCount` integer
        - `createdAt` string, date-time, required
        - `updatedAt` string, date-time, required
        - `createdBy` string, uuid, required
        - `updatedBy` string, uuid, required

## Other responses

- `400`: Validation error
- `401`: Missing or invalid token
- `404`: Workflow not found
- `500`: Server error

---

[API](https://skmtc.dev/freyavoice/apis/freyavoice-api.md) - [All operations](https://skmtc.dev/freyavoice/apis/freyavoice-api/llms.txt) - [OpenAPI document](https://skmtc.dev/freyavoice/apis/freyavoice-api/revisions/153d120f0c73?raw)