---
title: "Get Workflow V2"
method: GET
path: "/v1/scenario/{workflow_id}"
tags: ["Scenario Builder"]
---

# Get Workflow V2

`GET /v1/scenario/{workflow_id}`

Get one workflows_v2 by ID (organization must match).

## Path parameters

- `workflow_id` string, uuid, required

## Headers

- `X-API-Key` string, required

## Response `200`

Successful Response

- WorkflowV2Response — Single workflows_v2 row.
  - `id` string, required — Workflow ID
  - `organization_id` string, nullable — Owning organization ID (set by middleware on create)
  - `agent_ids` integer[] — Linked agent ids when the workflow is agent-scoped
  - `name` string, required — Name of the workflow
  - `description` string, nullable — Description
  - `definition` object, required — Stored React Flow graph (`start` / `single` / `options` nodes). Nodes and edges use top-level string `id` fields; edge `id` values are unique within the graph.
  - `created_at` string, date-time, required — Creation timestamp
  - `dh_sync_summary` object, nullable — Present on PUT responses when the definition was updated. Keys: updated, created, marked_stale, skipped, errors.
  - `warnings` string[] — Non-blocking lint warnings emitted at save time (e.g. node text referencing an unknown ``{{trait_name}}``). Empty when the definition is clean or no agents are linked.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/getbluejay/apis/bluejay-api.md) · [All operations](https://skmtc.net/getbluejay/apis/bluejay-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getbluejay/bluejay-api/versions/f48cef80963f/schema)