Delete a specific diagram version

Delete a particular version of diagram from the INUBIT Process Engine by the given diagram name and version number as path parameter.

Request

URL: /diagrams/{id}/version/{version}

Method: DELETE

Authorization: required (user with role System Administrator)

DELETE /ibis/rest/diagrams/{id}/version/{version} HTTP/1.1
Accept: application/json
Host: localhost:8080

Deletion of Diagram versions is not allowed if they are the first, latest, or tagged as active.

Name Description Required Allowed values

Name	Description	Required	Allowed values
`id`	Existing diagram name	yes	Any string
`version`	Existing version number of given diagram	yes	Any integer

id

Existing diagram name

yes

Any string

version

Existing version number of given diagram

yes

Any integer

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

{
  "responsedata": "Deleted the diagram's {Diagram name} version {Diagram version}"
}

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