Get pre-filtered Tasks

This endpoint provides the tasks that matches with the given XML filter.

Request

URL: /task/filtered

Method: POST

Authorization: required

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

Body

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

Request Parameters

None

Response

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

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>