---
title: "Get a workflow by heron ID (admin only)"
method: GET
path: "/api/workflow/{workflow_heron_id}"
tags: ["Workflows"]
---

# Get a workflow by heron ID (admin only)

`GET /api/workflow/{workflow_heron_id}`

## Request

- Base URL: `https://app.herondata.io`
- URL: `https://app.herondata.io/api/workflow/{workflow_heron_id}`
- Auth: API key in header `x-api-key`

## Path parameters

- `workflow_heron_id` string, required

## Response `200`

Workflow found

- WorkflowSchema
  - `alerts_muted_until` string, date-time, nullable
  - `created` string, date-time
  - `dashboard_trigger_enabled` boolean
  - `dashboard_trigger_label` string, nullable
  - `heron_id` string
  - `is_default` boolean
  - `name` string
  - `owners` FlowmingoWorkflowOwners
    - `group_slack_name` string[]
    - `user_email` string[]
  - `silent_run_allowed` boolean
  - `user_id` string
  - `user_username` string, nullable
  - `versions` WorkflowVersionSummary[]
    - `approved_at` string, date-time, nullable
    - `approved_by` string, nullable
    - `approved_comment` string, nullable
    - `author_email` string, nullable
    - `change_description` string, nullable
    - `created` string, date-time
    - `last_edited_at` string, date-time, nullable
    - `published_at` string, date-time, nullable
    - `published_by` string, nullable
    - `status` 'draft' | 'in_review' | 'approved' | 'published'
    - `submitted_by` string, nullable
    - `submitted_for_review_at` string, date-time, nullable
    - `version` integer

## Other responses

- `404`: Workflow not found

## Changes

- **2026-11-03** `bd8008e49534`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/herondata/apis/heron-data-api/changes/api/workflow/:workflow_heron_id/get.md)

---

[API](https://skmtc.dev/herondata/apis/heron-data-api.md) - [All operations](https://skmtc.dev/herondata/apis/heron-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/herondata/apis/heron-data-api/revisions/1ec936e17fef?raw)