Update task details

Use this resource to update the details of a specific task for the authenticated user.

Request

To update the task details, send a PUT request to the endpoint defined below.

URL: /task/tasks/{taskId}

Method: PUT

Authorization: required

PUT /ibis/rest/task/tasks/feaa6622-cee9-4158-94c7-eb7026b47477?portal=standalone HTTP/1.1
Accept: application/xml
Host: localhost:8080

The following table lists the path parameters for this request.

Name Description Required Allowed values

Name	Description	Required	Allowed values
`taskId`	Enter the unique identifier of the task.	yes	Alphanumeric with special character(-)

taskId

Enter the unique identifier of the task.

yes

Alphanumeric with special character(-)

The following table lists the query parameters for this request.

Name Description Required Allowed values

Name	Description	Required	Allowed values
`path`	Enter the XPath that describes the XML element you want to change.	yes	Any string
`value`	Enter the new value for the element.	yes	Any string

path

Enter the XPath that describes the XML element you want to change.

yes

Any string

value

Enter the new value for the element.

yes

Any string

The response contains the updated task details.

HTTP/1.1 200 OK
Content-Type: application/xml

<task>
    ...
</task>

This request might return one of the following error codes:

Client error locked (423): If task is currently locked. Task needs to be unlocked before it can be changed.
Authorization Failed (401): Authorization with the given username and password failed. Please revisit both values and provide valid credentials.

{
    "statusCode": 401,
    "message": "Unauthorized access",
    "path": "/rest/<endpoint>",
    "timestamp": "2025-06-07T14:21:11.781"
}

Resource Not Found (404): The 404 (Not Found) status code indicates that the requested endpoint or resource is unavailable or does not exist on the server.
Server Error (500): Execution on the INUBIT server failed. Have a look into the response message, otherwise access to the INUBIT log is required to retrieve further information.

{
  "statusCode": 500,
  "message": "Internal Server Error",
  "path": "/rest/<endpoint>",
  "timestamp": "2025-08-06T12:55:31.862"
}

Service Unavailable (503): In maintenance mode the INUBIT server endpoint will not respond to incoming requests but return this error response. Once the maintenance mode is switched off the endpoint will respond normally.

{
  "statusCode": 503,
  "message": "Service Unavailable",
  "path": "/rest/<endpoint>",
  "timestamp": "2025-08-06T12:58:06.688"
}