Retrieve task details

Use this resource to retrieve task details based on criteria provided in the request body.

Request

To retrieve the task details, send a POST request to the endpoint defined below.

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

Request Body

The request body contains the filter criteria.

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

Path Parameters

The following parameter is part of the URL path.

Name Description Required Allowed values

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

taskId

Enter the unique task identifier.

yes

Alphanumeric with special character(-)

Query Parameters

The following parameter can be appended to the URL as a query string.

Name Description Required Allowed values

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

portal

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

standalone

Response

The response contains the task details.

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

<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

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.

<html>

    <head>
        <title>Status page</title>
    </head>

    <body style="font-family: sans-serif;">
        <p style="font-size: 1.2em;font-weight: bold;margin: 1em 0px;">Unauthorized</p>
        <p>The request requires user authentication</p>
        <p>You can get technical details <a
                href="http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.2">here</a>.<br>
            Please continue your visit at our <a href="/">home page</a>.
        </p>
    </body>
</html>

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.
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.