REST API - setting a workstation fence

Use REST APIs to change the fence value of a workstation in the plan.

About this task

This process outlines the steps required to modify a workstation fence value within the current plan. The fence value plays a crucial role in job scheduling management, as jobs are not initiated on a workstation if their priorities are at or below the job fence value.

Procedure

  1. To change the fence value of a workstation in the plan, use the POST/twsd/api/v2/plan/workstation/action/update-fence endpoint. In the Swagger UI, expand the endpoint, identify the workstation you want to modify by querying with plan filters or OQL, modify the Fence parameter with the desired fence value, and then click Execute.

    If the command is successful, a response with the ID of the modified workstation in the plan is displayed, as shown in the following example:

    {
      "successfulResourceResponses": [
        {
          "id": "75196d79-50b0-345c-9308-ee4d69efe147",
          "error": false
        }
      ],
      "failedResourceResponses": []
    }
  2. To verify that the fence value was updated, run the GET/twsd/api/v2/plan/workstation API call and check that the Fence value in the response is equal to the value you previously set.