Filter tasks

Use this endpoint to retrieve a list of tasks that match the criteria defined in an XML filter.

Request

To filter tasks, send a POST request with an XML body to the endpoint defined below.

URL: /task/filtered Method: POST Authorization: required

POST /ibis/rest/task/filtered HTTP/1.1
Accept: application/xml
Host: localhost:8080
Content-Type: application/xml

<TaskListRequest>
    <Filtering>
        <FilterGroup>
            <FilterAdditionalField>
                <Name>DummyField</Name>
                <Value>Task</Value>
                <Type>String</Type>
                <Comparison>LIKE</Comparison>
            </FilterAdditionalField>
        </FilterGroup>
    </Filtering>
</TaskListRequest>

Request Parameters

This request does not require any parameters.

Response

The response contains a list of tasks that match the filter criteria from the request body.

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

<Tasklist user="admin" total="1">
    <Task id="47f63300-c17d-4b10-938a-cd0be2fcb25b" process="20001" creation="1719737716026" expiration="1719996916026" action="Form" wait="0" test="true" client="admin" delegateRuleSetId="7efed0e6-7f00-0101-218f-31c46b1f3241" locked="admin">
        <Name xml:lang="de">Task_Delegate_to_all</Name>
        <Description xml:lang="de">Task_Delegate_to_all</Description>
        <Unit name="admin" type="Role" />
    </Task>
</Tasklist>

Errors

This request might return one of the following error codes:

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.