Change readiness status

This resource changes the current ready status of the Process Engine. Manually it can be set ON or OFF. The endpoint will then respond with READY or NOT READY. The status incorporates also the current maintenance mode activity.

The overall is calculated as follows:

Maintenance mode active: NOT READY
Maintenance mode not active: manually set status (READY or NOT READY)

In status READY the endpoint will always return with HTTP status 200.

In status NOT READY the endpoint will always return with HTTP status 500.

Request

URL: /ready/{status}

Method: POST

Authorization: required (user with role System Administrator)

GET /ibis/rest/ready/off HTTP/1.1
Accept: application/json
Host: localhost:8080

Request Path Parameters

Name Description Required Allowed values

Name	Description	Required	Allowed values
`status`	Readiness status of the Process Engine	yes	`on` (READY) or `off` (NOT READY)

status

Readiness status of the Process Engine

yes

on (READY) or off (NOT READY)

Response

HTTP/1.1 503 Service Unavailable
Content-Tye: application/json

{
  "status": "NOT READY",
  "message": "No Service."
}

Errors

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