Planning runs

A material plan for one manufacturing site.

Fields

The API name is what the API, MCP and the CLI use.

NameAPI nameTypeRequiredDescription
IDidRecord IDYes
NumberuidTextThe number is a human-readable, unique identifier for the record.
DaydateDateYesCalendar date for this value.
KindkindConstantYesBase plan feeds execution; simulation is a what-if scenario until you approve it.
TagstagIdsTags
DescriptiondescriptionText Area
Created bycreatedByUser
Created atcreatedAtDate and TimeYes
Updated byupdatedByUser
Updated atupdatedAtDate and TimeYes
Processed byprocessedByUser
Processed atprocessedAtDate and Time
Approved byapprovedByUser
Approved atapprovedAtDate and Time
Blocked byblockedByUser
Blocked atblockedAtDate and Time
Archived byarchivedByUser
Archived atarchivedAtDate and Time

Relations

Owned records (solid line) are deleted with their owner. Grouped records (dashed line) can exist alone.

FieldPoints toKind
Tags tagIdsTagsreference

Actions

What you can do with a record. Every action also sends the webhook event manufacturingplanningruns.<action>. Reads (find, get, count) work on every table.

NameAPI nameDescriptionWhere
CreatecreateAdd a new planning run.App · API · MCP · CLI
EditupdateSave changes to this planning run.App · API · MCP · CLI
ApproveapproveApprove this planning run so the next step can run.App · API · MCP · CLI
ProcessprocessCalculate the make and buy lines.App · API · MCP · CLI
BlockblockStop edits and deletion of this planning run. It stays visible and can still appear on existing documents. Unblock to edit again.App · API · MCP · CLI
UnblockunblockAllow edits and deletion of this planning run again.App · API · MCP · CLI
ArchivearchiveRetire this planning run from daily use. It leaves active lists and pickers, and most actions stop. Unarchive to restore it.App · API · MCP · CLI
RestoreunarchiveReturn this planning run to active lists and actions.App · API · MCP · CLI
DeletedeleteDelete this planning run and the data that belongs with it. This cannot be undone.App · API · MCP · CLI

States

How a record moves from state to state. Archive and block can happen in any state.

ApproveProcessProcessApproveCreatedApprovedProcessedProcessed · Approved