curl -X PATCH 'https://api.anyformat.ai/v3/workflows/0686bb97-8c30-70f0-8000-97669e000eb8/' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Invoice Processing",
    "description": "Extract data from invoice documents",
    "nodes": [
      { "id": "parse_1", "type": "parse" },
      {
        "id": "extract_1",
        "type": "extract",
        "extraction_schema": {
          "fields": [
            {
              "name": "invoice_reference",
              "description": "The unique invoice identifier",
              "data_type": "string",
              "persistent_id": "8f14e45f-ceea-467f-a34e-9b6e2f7d3c1a"
            }
          ]
        }
      }
    ],
    "edges": [ { "source": "parse_1", "target": "extract_1" } ]
  }'

import requests

workflow_id = "0686bb97-8c30-70f0-8000-97669e000eb8"
url = f"https://api.anyformat.ai/v3/workflows/{workflow_id}/"
headers = {"Authorization": "Bearer YOUR_API_KEY"}

# GET → mutate → PATCH: rename a field, keep its persistent_id.
workflow = requests.get(url, headers=headers).json()
field = workflow["nodes"][1]["extraction_schema"]["fields"][0]
field["name"] = "invoice_reference"  # persistent_id stays, so identity survives the rename

body = {k: workflow[k] for k in ("name", "description", "nodes", "edges")}
updated = requests.patch(url, headers=headers, json=body).json()
print(updated["updated_at"])

{
  "id": "0686bb97-8c30-70f0-8000-97669e000eb8",
  "name": "Invoice Processing",
  "description": "Extract data from invoice documents",
  "created_at": "2026-07-01T12:00:00.000Z",
  "updated_at": "2026-07-05T09:30:00.000Z",
  "nodes": [
    {
      "id": "parse_1",
      "type": "parse",
      "mode": "standard",
      "prompt_hint": null,
      "figure_enhancement": false,
      "cache": true,
      "effort": "mid",
      "scanned_pages": "ocr"
    },
    {
      "id": "extract_1",
      "type": "extract",
      "mode": "standard",
      "extraction_schema": {
        "fields": [
          {
            "name": "invoice_reference",
            "description": "The unique invoice identifier",
            "data_type": "string",
            "persistent_id": "8f14e45f-ceea-467f-a34e-9b6e2f7d3c1a"
          }
        ]
      },
      "lookup_file_ids": [],
      "lookup_suggestion": null,
      "lookup_reasoning_effort": null,
      "lookup_file_uploads": [],
      "use_images": false
    }
  ],
  "edges": [ { "source": "parse_1", "target": "extract_1", "branch": null } ]
}