Search process documentation

Use this resource to search for a keyword within the process documentation. The search includes the following elements:

Names of diagrams or modules
Comments in diagrams or modules
Metadata

Request

To search the process documentation, send a GET request to the endpoint defined below.

URL: /process/search

Method: GET

Authorization: required

GET /ibis/rest/process/search?searchText=TestTaskGenWF&diagramType=bpd,technical, organigram,systemdiagram,constraintsdiagram,processmap&userGroup= HTTP/1.1
Accept: application/json
Host: localhost:8000

Query Parameters

The following table lists the query parameters for this request.

Name Description Required Allowed values

Name	Description	Required	Allowed values
`searchText`	Enter the text to search for.	yes	Any search text
`diagramType`	Specify the type of diagram.	no	`bpd` `technical` `organigram` `systemdiagram` `constraintsdiagram` `processmap`
`userGroup`	Specified user group	no	Any valid user group, e.g.: `admin`
`lang`	language	no (default: de)	`de` or `en`

searchText

Enter the text to search for.

yes

Any search text

diagramType

Specify the type of diagram.

bpd
technical
organigram
systemdiagram
constraintsdiagram
processmap

userGroup

Specified user group

Any valid user group, e.g.: admin

lang

language

no (default: de)

de or en

Response

The response contains a list of search results matching the criteria.

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

{
    "SearchResult": {
        "technical": {
            "Size": 1,
            "Objects": [
                {
                    "comments": "",
                    "workflowGroupDisplayName": "TestGroup",
                    "moduleList": [],
                    "count": 1,
                    "workflowDisplayName": "TestTaskGenWF",
                    "workflowName": "TestTaskGenWF",
                    "workflowType": "technical",
                    "workflowGroup": "TestGroup"
                }
            ]
        }
    },
    "SearchText": "TestTaskGenWF"
}

The response is empty if the search text does not match any content.

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