---
title: Network Pipe Constraint
slug: network-pipe-constraint
docTags: 
createdAt: 2023-10-11T07:16:12.768Z
---

The Network Pipe Constraint table describes time-based constraints applied to pipe elements in a network, for network optimization and forecasting defaults.

:::hint{type="info"}
**Constraints** apply from the last date they were set. For example, if a record is added with date 2023-01-01T00:00:00+0000 and **maxOilRate** set to 1200 STB/d, that constraint continues to apply until a future record sets a different value for **maxOilRate**.
:::

:::hint{type="warning"}
A **NULL** value for a particular constraint makes that variable unconstrained. If different constraint variables change on different time horizons, take care when posting updates — it is easy to unintentionally reset a constraint with a NULL value.
:::

The unique constraint on network pipe constraint entries is **sourcePipeId + sourceId**.

| **Variable**    | **Data Type**  | **Unit of Measure** | **Is Nullable?** | **Default Value** | **Description**                                                                                                                        |
| --------------- | -------------- | ------------------- | ---------------- | ----------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| sourceNetworkId | String         | -                   | No               | -                 | Source ID of the [Network Header](docId\:irXj-Rg5lEh701vW2okjL)                                                                        |
| sourcePipeId    | String         | -                   | No               | -                 | Source ID of the [Network Pipe Definition](docId\:NM2btVSv7hAiitak2O9Yw) the constraint applies to                                     |
| sourceId        | String         | -                   | No               | -                 | Source ID for the pipe/date constraint. This sourceId enables upsert functionality from client source systems of record.               |
| date            | DateTimeOffset | -                   | No               | -                 | Date at which the constraint becomes applicable. Datetime offset (with timezone) in ISO 8601 format. Example: 2022-09-27T16:28:37+0000 |
| maxPressure     | Double         | psig                | Yes              | -                 | Maximum pressure constraint                                                                                                            |
| minPressure     | Double         | psig                | Yes              | -                 | Minimum pressure constraint                                                                                                            |
| maxOilRate      | Double         | STB/d               | Yes              | -                 | Maximum oil rate constraint                                                                                                            |
| maxGasRate      | Double         | Mscf/d              | Yes              | -                 | Maximum gas rate constraint                                                                                                            |
| maxWaterRate    | Double         | STB/d               | Yes              | -                 | Maximum water rate constraint                                                                                                          |
| maxLiquidRate   | Double         | STB/d               | Yes              | -                 | Maximum liquid rate constraint                                                                                                         |
| maxCFactor      | Double         | -                   | Yes              | -                 | Maximum C-factor (pipe roughness coefficient)                                                                                          |

***

# Data Integrity Checks

| **Condition**                                                            | **Response**    |
| ------------------------------------------------------------------------ | --------------- |
| Any non-nullable field is NULL or empty                                  | Record Rejected |
| (sourceNetworkId, sourcePipeId) does not match a Network Pipe Definition | Record Rejected |

***

# Common Error Messages

| **API**                 | **Scenario**         | **Error Response**                                      |
| ----------------------- | -------------------- | ------------------------------------------------------- |
| Add / Upsert constraint | Unknown network pipe | Network Pipe was not found for network xxx and pipe xxx |