Upsert Production Schedule Resource Setting

Beta
PUT/v1/operations/production-schedule-settings/resources

This endpoint is idempotent. Learn more

Writes a per-resource planning override.

One override exists per resource, so this replaces any existing entry for the same scope rather than adding a second. Machines are selected by the constraint department, so this is where one is taken out of planning — a machine down for a rebuild — and where a department or step declares how many weeks after the constraint its work starts.

Permissions requiredValues:production_schedules:update
The role behind your API key or agent must grant every one of these permissions.
scope_typestringenumValues:machinedepartmentproduction_step

What kind of resource this overrides.

scope_ref_idstring

ID of the machine, department or production step.

participation_statusstringenumValues:includedexcluded

Whether this resource takes part in planning. Machines are selected by department, so this excludes one rather than opting one in.

lead_time_weeksoptional number

Weeks of lead time at this resource.

lead_time_offset_weeksnumber

Weeks after the constraint campaign this resource's work starts.

idstring

Resource setting ID.

objectstringenumValues:production_schedule_resource_setting

Resource type identifier.

scope_typestringenumValues:machinedepartmentproduction_step

What kind of resource this overrides.

scopeentitynullable

The machine, department or production step this overrides.

idstring

Unique identifier for the entity.

objectstringenumValues:entity

Resource type identifier.

typestringenumValues:accountactorentity

The resource kind that this entity references, as an object-type value (e.g. user, account).

Unlike object — which is always entity — this names the underlying resource the id points to.

namestringnullable

Human-readable display name for the entity (e.g. a user's full name, a sales order number).

handlestringnullable

Secondary human-readable identifier (e.g. email address, username, redacted API key value).

participation_statusstringenumValues:includedexcluded

Whether this resource takes part in planning. Machines are selected by department, so this takes one out rather than opting one in — for a machine down for a rebuild that should not be planned against.

lead_time_weeksnumbernullable

Weeks of lead time at this resource.

lead_time_offset_weeksnumber

Weeks after the constraint campaign this resource's work starts.

Responses

200

Successful response for Upsert Production Schedule Resource Setting