---
title: "Get HEAD state"
method: GET
path: "/v0/multi-file-feeds/{multi_file_feed_id}/head"
tags: ["Multi FileFeed Transforms"]
---

# Get HEAD state

`GET /v0/multi-file-feeds/{multi_file_feed_id}/head`

Returns the current HEAD (draft) flowgraph state along with its
dirty status. The HEAD is the mutable, editable version of the
flowgraph — it may differ from the latest commit if edits have
been made but not yet committed.

The `is_dirty` flag indicates whether the HEAD has changes that
are newer than the latest commit. If `true`, `POST /commits`
will reject requests to prevent overwriting in-progress UI edits.

Requires Multi FileFeed transforms to be enabled for the organization.

## Response `200`

Successful response

- object
  - `is_dirty` boolean, required — Whether the HEAD has uncommitted changes newer than the latest commit
  - `transforms` object, required — The portable flowgraph export
    - `version` integer — Export format version
    - `exported_at` string, date-time — When the export was generated
    - `flowgraph` object
      - `nodes` object[]
        - `node_key` string
        - `type` string
        - `config` object
        - `position_x` number
        - `position_y` number
        - `pipeline` object, nullable
      - `edges` object[]
        - `from_node_key` string
        - `to_node_key` string

## Other responses

- `400` — Bad request
- `401` — Unauthorized (missing or invalid API key)
- `403` — Forbidden (wrong organization or required feature not enabled)
- `422` — Unprocessable entity (e.g. workflow has no recurring flowgraph)

---

[API](https://skmtc.net/oneschema/apis/templates.md) · [All operations](https://skmtc.net/oneschema/apis/templates/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oneschema/templates/revisions/40674aa6d4d9/schema)