---
title: "Update a flow"
method: PATCH
path: "/flows/{id}"
tags: ["flows"]
---

# Update a flow

`PATCH /flows/{id}`

Returns the updated flow.

## Path parameters

- `id` string, required

## Query parameters

- `teamId` string, required

## Request body

- object
  - `type` 'INPUT' | 'OUTPUT'
  - `description` string, nullable
  - `utilityState` 'RESOURCES' | 'RAW_MATERIALS' | 'INTERMEDIATE_PRODUCTS' | 'FINISHED_PRODUCTS' | 'NEUTRALS' | 'INACTIVE_NEUTRALS' | 'ACTIVE_NEUTRALS' | 'WASTE' | 'PRODUCTION_WASTE' | 'CONSUMPTION_WASTE' | 'MIXED_WASTE'
  - `productId` string, nullable
  - `geoTagId` string, nullable
  - `date` string, date-time, nullable
  - `hazards` string[]
  - `siteId` string, nullable
  - `externalSiteId` string, nullable
  - `streamId` string, nullable
  - `units` number, nullable
  - `weight` number, nullable
  - `documents` object[], nullable
    - `id` string, cuid
    - `type` 'AUDIO' | 'BILL_OF_LADING' | 'INCIDENT_REPORT' | 'MAINTENANCE_RECORD' | 'PICTURE' | 'SCALE_TICKET' | 'TRAINING_RECORD' | 'TRANSFER_NOTES' | 'TRANSPORT_MANIFEST' | 'WORK_ORDER' | 'WORK_RECEIPT' | 'VIDEO' | 'CREDIT_NOTE' | 'DEBIT_NOTE' | 'INVOICE' | 'PAYMENT_BILL' | 'PAYMENT_RECEIPT' | 'COMMERCIAL_AGREEMENT' | 'LETTER_OF_INTENT' | 'MEMORANDUM_OF_UNDERSTANDING' | 'PURCHASE_ORDER' | 'QUOTE' | 'SALES_ORDER' | 'AUDIT_REPORT' | 'COMPLIANCE_REPORT' | 'CERTIFICATION' | 'RISK_ASSESSMENT_REPORT' | 'PERMIT' | 'END_OF_LIFE_CERTIFICATE' | 'SAFETY_DATA_SHEET' | 'TECHNICAL_DATA_SHEET', required
    - `url` string, required
    - `name` string, required
  - `items` object[]
    - `name` string, required
    - `weight` integer, required
    - `materialId` string, required
  - `terminationStandard` 'RECOVERY' | 'RECOVERY_FUNCTION' | 'RECOVERY_FUNCTION_PRODUCT' | 'RECOVERY_FUNCTION_COMPONENT' | 'RECOVERY_MATERIAL_ENHANCED_LOOP' | 'RECOVERY_MATERIAL_PRESERVED_LOOP' | 'RECOVERY_MATERIAL' | 'RECOVERY_MATERIAL_CLOSED_LOOP' | 'RECOVERY_MATERIAL_OPEN_LOOP' | 'RECOVERY_MATERIAL_LINEAR' | 'RECOVERY_NUTRIENT' | 'RECOVERY_NUTRIENT_ANIMAL_FEED' | 'RECOVERY_NUTRIENT_PLANT_FEED' | 'RECOVERY_ENERGY' | 'RECOVERY_ENERGY_POWER' | 'RECOVERY_ENERGY_VECTOR' | 'RECOVERY_ENERGY_KINETIC' | 'RECOVERY_ENERGY_HEAT' | 'CONTROL' | 'CONTROL_NEUTRALIZATION' | 'CONTROL_NEUTRALIZATION_ECO_IMPACT' | 'CONTROL_NEUTRALIZATION_FREE_RELEASE' | 'CONTROL_NEUTRALIZATION_LIMITED_RELEASE' | 'CONTROL_DISPOSAL' | 'CONTROL_DISPOSAL_ISOLATION' | 'CONTROL_DISPOSAL_CONTAINMENT'

## Response `200`

200

- object
  - `type` 'INPUT' | 'OUTPUT', required
  - `utilityState` 'RESOURCES' | 'RAW_MATERIALS' | 'INTERMEDIATE_PRODUCTS' | 'FINISHED_PRODUCTS' | 'NEUTRALS' | 'INACTIVE_NEUTRALS' | 'ACTIVE_NEUTRALS' | 'WASTE' | 'PRODUCTION_WASTE' | 'CONSUMPTION_WASTE' | 'MIXED_WASTE', required
  - `hazards` string[], required
  - `terminationStandard` 'RECOVERY' | 'RECOVERY_FUNCTION' | 'RECOVERY_FUNCTION_PRODUCT' | 'RECOVERY_FUNCTION_COMPONENT' | 'RECOVERY_MATERIAL_ENHANCED_LOOP' | 'RECOVERY_MATERIAL_PRESERVED_LOOP' | 'RECOVERY_MATERIAL' | 'RECOVERY_MATERIAL_CLOSED_LOOP' | 'RECOVERY_MATERIAL_OPEN_LOOP' | 'RECOVERY_MATERIAL_LINEAR' | 'RECOVERY_NUTRIENT' | 'RECOVERY_NUTRIENT_ANIMAL_FEED' | 'RECOVERY_NUTRIENT_PLANT_FEED' | 'RECOVERY_ENERGY' | 'RECOVERY_ENERGY_POWER' | 'RECOVERY_ENERGY_VECTOR' | 'RECOVERY_ENERGY_KINETIC' | 'RECOVERY_ENERGY_HEAT' | 'CONTROL' | 'CONTROL_NEUTRALIZATION' | 'CONTROL_NEUTRALIZATION_ECO_IMPACT' | 'CONTROL_NEUTRALIZATION_FREE_RELEASE' | 'CONTROL_NEUTRALIZATION_LIMITED_RELEASE' | 'CONTROL_DISPOSAL' | 'CONTROL_DISPOSAL_ISOLATION' | 'CONTROL_DISPOSAL_CONTAINMENT', nullable, required
  - `id` string, cuid, required
  - `description` string, nullable, required
  - `weight` integer, required
  - `units` integer, nullable, required
  - `productId` string, nullable, required
  - `complexity` number, nullable, required
  - `geoTagId` string, nullable, required
  - `date` string, date-time, nullable, required
  - `siteId` string, nullable, required
  - `externalSiteId` string, nullable, required
  - `streamId` string, nullable, required
  - `teamId` string, required
  - `createdAt` string, date-time, nullable, required
  - `updatedAt` string, date-time, nullable, required

## Changes

> 13 revisions in range; 1 could not be searched.

- **2024-08-13** `59be44a59b16` — 1 breaking, 26 warning, 27 info
  - removed the enum value `TERMINATION_STANDARD_1` of the request property `terminationStandard`
  - added the new `CONTROL` enum value to the `terminationStandard` response property for the response status `200`
  - added the new `CONTROL_DISPOSAL` enum value to the `terminationStandard` response property for the response status `200`
  - added the new `CONTROL_DISPOSAL_CONTAINMENT` enum value to the `terminationStandard` response property for the response status `200`
  - …50 more
- **2024-08-08** `b779d136d694` — 2 info
  - added the new optional request property `externalSiteId`
  - added the required property `externalSiteId` to the response with the `200` status
- **2024-07-09** `c6859457ef7f` — 1 warning
  - removed the request property `complexity`
- **2024-07-08** `3c1a479465dc` — 1 breaking, 1 warning, 2 info
  - removed the required property `when` from the response with the `200` status
  - removed the request property `when`
  - added the new optional request property `date`
  - added the required property `date` to the response with the `200` status
- **2024-07-04** `47a922bd51aa` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/atlaz-org/apis/atlaz-api/changes/flows/:id/patch.md)

---

[API](https://skmtc.dev/atlaz-org/apis/atlaz-api.md) · [All operations](https://skmtc.dev/atlaz-org/apis/atlaz-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/atlaz-org/atlaz-api/revisions/cebf21627d29/schema)