---
title: "Get a Workflow"
method: GET
path: "/v1/workflows/{id}"
tags: ["Workflows API"]
---

# Get a Workflow

`GET /v1/workflows/{id}`

Use this endpoint to retrieve a specific workflow definition by its unique identifier.

## Path parameters

- `id` string, uuid, required

## Response `200`

Indicates that the request was successful and the response contains the requested data.

- WorkflowOutput
  - `createdAt` string, date-time — Timestamp when the workflow was created.
  - `description` string — Human-readable description of the workflow.
  - `edges` WorkflowEdgeOutput[] — Connections between nodes that define the execution flow.
    - `condition` string — Condition expression for conditional edges.
    - `id` string — Unique identifier of the edge.
    - `label` string — Human-readable label.
    - `source` string — ID of the source node.
    - `sourceHandle` string — Handle on the source node.
    - `target` string — ID of the target node.
  - `id` string, uuid — Unique identifier of the workflow.
  - `metadata` object — Custom key-value pairs for tagging or categorizing.
  - `name` string — Unique name of the workflow.
  - `nodes` WorkflowNodeOutput[] — The steps that make up this workflow.
    - `data` object — Configuration data specific to the node type.
    - `id` string — Unique identifier of the node within the workflow.
    - `name` string — Display name of the node.
    - `position` PositionOutput
      - `x` integer — Horizontal position in pixels.
      - `y` integer — Vertical position in pixels.
    - `type` string — Type of the node.
  - `status` 'draft' | 'active' | 'inactive' — Current lifecycle status: `draft` (editable), `active` (executable), or `inactive` (archived).
  - `updatedAt` string, date-time — Timestamp of the last update.

## Other responses

- `400` — Indicates that the request was malformed or contained invalid parameters.
- `404` — Indicates that the requested resource could not be found.
- `500` — Indicates an unexpected internal error. If this persists, please contact support.

---

[API](https://skmtc.net/lerian/apis/identity-plugin.md) · [All operations](https://skmtc.net/lerian/apis/identity-plugin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lerian/identity-plugin/versions/25daba385532/schema)