Update a Scheduled Operation
PATCH
production-orders/products/{productionOrderProductId}/scheduled-operations/{operationId}
Updates the start date, end date, assigned Workers or assigned Machines of a Scheduled Operation. Only the provided fields will be modified. When both endDate and workers are provided and the worker count changes, the client-provided endDate is preserved (not recalculated from task duration). Recovery, optional 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/{operationId} |
| Authentication Context | No security required |
| Required OAuth Scopes | data:read data:write |
| Data Format | JSON |
Request
Headers
| Authorization* string | JWT Access Token |
| Content-Type* string | Must be application/json |
* Required
Request
URI Parameters
| productionOrderProductId int | Unique identifier of the Product entry within the Production Order. |
| operationId int | Unique identifier of the Operation to update. |
Request
Body Structure
The Scheduled Operation attributes to be updated. Only the provided fields will be modified.
Expand all
| 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 | |
| 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 |
| anyOf | |
| 0 | |
| 1 |
Response
HTTP Status Code Summary
| 200 OK | Scheduled Operation updated successfully. |
| 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). |