Clear web application session instances

Use this endpoint to clear queue manager entries related to a web application in the INUBIT Process Engine. This is typically done by external clients during events like user logout, session timeout, or when a session is removed.

Request

To clear the session instances, send a POST request to the endpoint defined below.

URL: /webapp/session/instances

Method: POST

Authorization: required

POST /ibis/rest/webapp/session/instances?user=testuser HTTP/1.1
Accept: application/xml
Host: localhost:8080
Content-Type: text/plain

Query Parameters

The following table lists the query parameters for this request.

Name Description Required Allowed values

Name	Description	Required	Allowed values
`user`	Enter the username.	yes	Any existing username

user

Enter the username.

yes

Any existing username

Request Body

The request body must contain a list of session IDs to be cleared. Each ID must be on a new line.

webform@@@ServerSideValWAC/form_webappvalidateserversidetg(2)_serversidevalidationwebapp@@@10020.xml,webform@@@LaunchWebApp/form_loginwebapp(62)_basicwebapp@@@10019.xml

Response

A successful request returns an HTTP 200 OK status code with an empty body.

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

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