---
title: "Create a flow"
method: POST
path: "/flows"
tags: ["flows"]
---

# Create a flow

`POST /flows`

Returns the created flow.

## Query parameters

- `teamId` string, required

## Request body

- union
  - object
    - `description` string, nullable, required
    - `utilityState` 'RESOURCES' | 'RAW_MATERIALS' | 'INTERMEDIATE_PRODUCTS' | 'FINISHED_PRODUCTS' | 'NEUTRALS' | 'INACTIVE_NEUTRALS' | 'ACTIVE_NEUTRALS' | 'WASTE' | 'PRODUCTION_WASTE' | 'CONSUMPTION_WASTE' | 'MIXED_WASTE', required
    - `productId` string, nullable, required
    - `geoTagId` string, nullable, required
    - `date` string, date-time, nullable, required
    - `hazards` string[], required
    - `siteId` string, nullable, required
    - `externalSiteId` string, nullable, required
    - `streamId` string, nullable, required
    - `units` number, nullable
    - `weight` number, nullable
    - `documents` object[], nullable
      - `id` string, cuid, required
      - `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[], required
      - `name` string, required
      - `weight` integer, required
      - `materialId` string, required
    - `type` 'OUTPUT', 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', required
  - object
    - `description` string, nullable, required
    - `utilityState` 'RESOURCES' | 'RAW_MATERIALS' | 'INTERMEDIATE_PRODUCTS' | 'FINISHED_PRODUCTS' | 'NEUTRALS' | 'INACTIVE_NEUTRALS' | 'ACTIVE_NEUTRALS' | 'WASTE' | 'PRODUCTION_WASTE' | 'CONSUMPTION_WASTE' | 'MIXED_WASTE', required
    - `productId` string, nullable, required
    - `geoTagId` string, nullable, required
    - `date` string, date-time, nullable, required
    - `hazards` string[], required
    - `siteId` string, nullable, required
    - `externalSiteId` string, nullable, required
    - `streamId` string, nullable, required
    - `units` number, nullable
    - `weight` number, nullable
    - `documents` object[], nullable
      - `id` string, cuid, required
      - `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[], required
      - `name` string, required
      - `weight` integer, required
      - `materialId` string, required
    - `type` 'INPUT', required

## 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 `oneOf[subschema #1]/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` — 1 breaking, 2 info
  - removed `subschema #1, subschema #2` from the request body `oneOf` list
  - added `subschema #1, subschema #2` to the request body `oneOf` list
  - added the required property `externalSiteId` to the response with the `200` status
- **2024-07-09** `c6859457ef7f` — 1 breaking, 1 info
  - removed `subschema #1, subschema #2` from the request body `oneOf` list
  - added `subschema #1, subschema #2` to the request body `oneOf` list
- **2024-07-08** `3c1a479465dc` — 2 breaking, 2 info
  - removed `subschema #1, subschema #2` from the request body `oneOf` list
  - removed the required property `when` from the response with the `200` status
  - added `subschema #1, subschema #2` to the request body `oneOf` list
  - added the required property `date` to the response with the `200` status
- …earlier changes not shown

[Full history](https://skmtc.dev/atlaz-org/apis/atlaz-api/changes/flows/post.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)