Get the next available task

This endpoint provides the next available unlocked/un-assigned task and locks/assigns to the authenticating user.

Request

To retrieve the next task, send a GET request to the endpoint defined below.

URL: /task/next

Method: GET

Authorization: required

GET /ibis/rest/task/next HTTP/1.1
Accept: application/xml
Host: localhost:8080

Request Parameters

This request does not require any parameters.

Response

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

<Task id="d7dbda7d-613b-4254-8e20-1e451f98b164" process="20002" creation="1719745444905" expiration="1719749044905" action="Form" wait="0" test="true" client="admin" locked="admin">
    <Name xml:lang="de">Combobox Task</Name>
    <Description xml:lang="de">Combobox Task Desc</Description>
    <Unit name="admin" type="Role" />
    <Unit name="user" type="Role" />
</Task>

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.

{
    "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"
}