Get full process tree

Use this resource to retrieve all process types, groups, and processes in one hierarchical structure.

Request

To retrieve the full process tree, send a GET request to the endpoint defined below.

URL: /process/tree

Method: GET

Authorization: required

GET /ibis/rest/process/tree
Accept: application/json
Host: localhost:8000

Response

The response contains a JSON array representing the full process tree.

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

[
  {
    "name": "technical",
    "type": "Type",
    "children": [
      {
        "name": "test-link-direction",
        "type": "Group",
        "children": [
          {
            "name": "test-link-direction_diagram",
            "type": "Process",
            "group": "TestGroup"
          }
        ]
      },
      {
        "name": "TestGroup",
        "type": "Group",
        "children": [
          {
            "name": "TestGroup_diagram",
            "type": "Process",
            "user": "root"
          }
        ]
      },
      {
        "name": "FOConverter",
        "type": "Group",
        "children": [
          {
            "name": "FOConverter_diagram",
            "type": "Process",
            "group": "admin"
          }
        ]
      },
      {
        "name": "ProcessDocumentation",
        "type": "Group",
        "children": [
          {
            "name": "TargetTWF_CL",
            "type": "Process",
            "group": "TestGroup"
          },
          {
            "name": "ProcessDocumentation_diagram",
            "type": "Process",
            "group": "admin"
          }
        ]
      }
    ]
  },
  {
    "name": "organigram",
    "type": "Type",
    "children": [
      {
        "name": "OrganigramGroup",
        "type": "Group",
        "children": [
          {
            "name": "OrganigramDiagram",
            "type": "Process",
            "group": "admin"
          }
        ]
      }
    ]
  },
  {
    "name": "systemdiagram",
    "type": "Type",
    "children": [
      {
        "name": "SystemGroup",
        "type": "Group",
        "children": [
          {
            "name": "SystemDiagram",
            "type": "Process",
            "group": "TestGroup"
          }
        ]
      }
    ]
  }
]

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