Get task details of a user by filter body

This endpoint retrieves task details based on criteria provided in request body.

Request

URL: /task/tasks/{taskId}

Method: POST

Authorization: required

POST /ibis/rest/task/tasks/feaa6622-cee9-4158-94c7-eb7026b47477 HTTP/1.1
Accept: application/xml
Host: localhost:8080

Body

{"roles":["user2", "user1", "admin"]}

Request Path Parameters

Name Description Required Allowed values

Name	Description	Required	Allowed values
`taskId`	Unique task identifier	yes	Alphanumeric with special character(-)

taskId

Unique task identifier

yes

Alphanumeric with special character(-)

Request Query Parameters

Name Description Required Allowed values

Name	Description	Required	Allowed values
`portal`	A string value to indicate that the portal has to work independently without Process user configuration.	no	standalone

portal

A string value to indicate that the portal has to work independently without Process user configuration.

standalone

Response

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

<Task id="feaa6622-cee9-4158-94c7-eb7026b47477" process="20004" creation="1719763229788" expiration="1720022429788" action="Form" wait="0" test="true" client="admin">
    <Name xml:lang="de">Task_with_helpInfo</Name>
    <Description xml:lang="de">Task_with_helpInfo</Description>
    <Unit name="admin" type="Role" />
</Task>

Errors

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.

<?xml version="1.0" encoding="UTF-8"?>
<ApiError>
    <statusCode>401</statusCode>
    <message>Unauthorized access</message>
    <path>/rest/endpoint</path>
    <timestamp>2025-06-07T14:21:11.781</timestamp>
</ApiError>

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.

<?xml version="1.0" encoding="UTF-8"?>
<ApiError>
    <statusCode>500</statusCode>
    <message>Internal Server Error</message>
    <path>/rest/endpoint</path>
    <timestamp>2025-08-06T12:55:31.862</timestamp>
</ApiError>

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.

<?xml version="1.0" encoding="UTF-8"?>
<ApiError>
    <statusCode>503</statusCode>
    <message>Service Unavailable</message>
    <path>/rest/endpoint</path>
    <timestamp>2025-08-06T12:58:06.688</timestamp>
</ApiError>