---
title: "List Workflows V2"
method: GET
path: "/v1/scenario"
tags: ["Scenario Builder"]
---

# List Workflows V2

`GET /v1/scenario`

List all workflows_v2 for the authenticated user's organization.

## Query parameters

- `agent_id` integer, nullable — If set, only workflows linked to this agent (agent must be in your org).

## Headers

- `X-API-Key` string, required

## Response `200`

Successful Response

- WorkflowsV2ListResponse — List workflows_v2 for the organization.
  - `workflows` WorkflowV2Response[], required — Workflows
    - `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.
  - `total_count` integer, required — Number of workflows returned

## 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/revisions/f48cef80963f/schema)