---
title: "Edit Iron"
method: PATCH
path: "/sessions/{session_id}/iron"
tags: ["sessions"]
---

# Edit Iron

`PATCH /sessions/{session_id}/iron`

## Request

- Base URL: `https://api.nicheangle.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.nicheangle.com/sessions/{session_id}/iron`
- Auth: none declared

Edit the BRIEF (forge-on-order ph.3, edit-once-propagate): reshape the
hook/frame/tension/CTA or add free-form direction. Every product created
after the edit inherits it; products that already exist are marked stale
(script.brief_changed) and the sheet offers a free re-create. Allowed once
the angle is locked (the brief exists) — awaiting_forge, cp3, or complete.

## Path parameters

- `session_id` string, uuid, required

## Headers

- `authorization` string, nullable

## Request body

- IronEditsRequest: Brief-canvas edits (forge-on-order ph.3). All optional; an explicit "" clears that edit back to the original. `notes` is free-form direction.
  - `hook` string, nullable
  - `frame` string, nullable
  - `tension` string, nullable
  - `cta_direction` string, nullable
  - `notes` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/nicheangle/apis/signal-api.md) · [All operations](https://skmtc.dev/nicheangle/apis/signal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nicheangle/apis/signal-api/revisions/ed8b47ff5891?raw)