Update Scheduled Operations for a Product of a Production Order
PATCH
production-orders/products/{productionOrderProductId}/scheduled-operations:batch-patch
Updates one or more Scheduled Operations for the specified Product entry within the specified Production Order. Each updated Operation defines the start and end dates of its execution and may have Workers and Machines assigned to it. Each request body may contain at most 100 Scheduled Operations; larger payloads must be split across multiple requests. Recovery, options and no time operations cannot be scheduled.
Resource Information
| Method and URI | PATCH https://api.aps.autodesk.com/fusion-operations/v2/production-orders/products/{productionOrderProductId}/scheduled-operations:batch-patch |
| Authentication Context | No security required |
| Required OAuth Scopes | data:read data:write |
| Data Format | JSON |
Request
Headers
| Content-Type* string | Must be application/merge-patch+json |
* Required
Request
URI Parameters
| productionOrderProductId int | Unique identifier of the Product entry within the Production Order. |
Request
Body Structure
Array of objects with a single key-value entry each, where the key is the operation id or code and the value is the Scheduled Operation attributes to update. At most 100 items are accepted per request.
| [ ] array:object |
Response
HTTP Status Code Summary
| 200 OK | Scheduled Operations successfully updated. |
| 207 | Partial success. The request was processed but one or more Scheduled Operations were not updated. |
| 400 Bad Request | Bad request due to invalid data. |
| 401 Unauthorized | The access token is invalid. It may have either expired or may not be a three-legged access token. Please verify the token and retry the request. |
| 403 Forbidden | The request was successfully validated but lacked required permission. Please verify your token permissions and retry the request. |
| 404 Not Found | The resource in the path does not exist. |
| 429 Too Many Requests | Rate limit exceeded; wait some time before retrying. |
| 500 Internal Server Error | An unknown server-side error occurred. Please try again later. If the problem persists, please contact support. |
Response
Header (429)
| Retry-After integer | The number of seconds to wait before retrying the request. |
Response
Body Structure (200)
Expand all
| operation | |
| id int | Unique identifier of the referenced entity. |
| code string | Code of the referenced entity.
Max length: 255 |
| name string | Name of the referenced entity.
Max length: 255 |
| anyOf | |
| 0 | |
| 1 | |
| planned boolean | Defines if the operation is planned to be executed or not. If false, the operation will not appear in the scheduling board and will not be shown in the tablet. |
| startDate datetime: ISO 8601 | Start date and time when the Operation will begin being performed (e.g. 2026-04-01T08:00:00Z). Required when planned is true. Must be less than or equal to endDate. |
| endDate datetime: ISO 8601 | End date and time when the Operation will be finished (e.g. 2026-04-01T10:00:00Z). Required when planned is true. Must be greater than or equal to startDate. When provided together with workers on PATCH and the worker count changes, the client-provided value is used instead of a duration-based recalculation. |
| workers array: object | Workers assigned to perform the Operation during the scheduled window. |
| id int | |
| number int | |
| name string | Max length: 255 |
| anyOf | |
| 0 | |
| 1 | |
| machines array: object | Machines assigned to perform the Operation during the scheduled window. |
| id int | Unique identifier of the referenced entity. |
| code string | Code of the referenced entity.
Max length: 255 |
| name string | Name of the referenced entity.
Max length: 255 |
| anyOf | |
| 0 | |
| 1 | |
| timeEstimated string | Estimated duration for the Production Record (ISO 8601 duration, e.g. PT2H15M30S). |
Response
Body Structure (207)
Expand all
| results array: object | |
| operation | |
| id int | Unique identifier of the referenced entity. |
| code string | Code of the referenced entity.
Max length: 255 |
| name string | Name of the referenced entity.
Max length: 255 |
| anyOf | |
| 0 | |
| 1 | |
| planned boolean | Defines if the operation is planned to be executed or not. If false, the operation will not appear in the scheduling board and will not be shown in the tablet. |
| startDate datetime: ISO 8601 | Start date and time when the Operation will begin being performed (e.g. 2026-04-01T08:00:00Z). Required when planned is true. Must be less than or equal to endDate. |
| endDate datetime: ISO 8601 | End date and time when the Operation will be finished (e.g. 2026-04-01T10:00:00Z). Required when planned is true. Must be greater than or equal to startDate. When provided together with workers on PATCH and the worker count changes, the client-provided value is used instead of a duration-based recalculation. |
| workers array: object | Workers assigned to perform the Operation during the scheduled window. |
| id int | |
| number int | |
| name string | Max length: 255 |
| anyOf | |
| 0 | |
| 1 | |
| machines array: object | Machines assigned to perform the Operation during the scheduled window. |
| id int | Unique identifier of the referenced entity. |
| code string | Code of the referenced entity.
Max length: 255 |
| name string | Name of the referenced entity.
Max length: 255 |
| anyOf | |
| 0 | |
| 1 | |
| timeEstimated string | Estimated duration for the Production Record (ISO 8601 duration, e.g. PT2H15M30S). |
| errors array: object | |
| title string | |
| detail string | |
| field string |