Every API here is available over the APIs.io API and to AI agents over MCP.
{
"openapi": "3.0.1",
"info": {
"title": "Fenergo Nebula Risk Command",
"description": "**Risk Command API**:<br/><br/><br/> Risk Command API provides endpoints in order to manage and configure all risk related models and their versions.<br/><br/><br/> **Risk Command API provides**:<br/><ul><li> Risk Calculator Scoping Rules Management</li><li> Risk Configuration Collection and Items Management</li><li> Risk Models Management</li><li> Risk Threshold Models Management</li><li> Risk Scoping Rules Management</li></ul>",
"version": "1.0"
},
"servers": [
{
"url": "/riskcommand"
}
],
"paths": {
"/api/risk-calculator-options": {
"post": {
"tags": [
"RiskCalculatorOptionModel"
],
"summary": "Create a new RiskCalculatorOption",
"description": "\nThis method will create a new RiskCalculatorOption model.\r\n The new model will initialize with the DTO data.<br /><br /><b>Required permissions:</b><br />Following permissions are required: RiskConfigurationEdit",
"operationId": "CreateRiskCalculatorOptions",
"parameters": [
{
"name": "X-TENANT-ID",
"in": "header",
"description": "The UiD of the tenant representing organization",
"required": true,
"schema": {
"type": "string"
},
"example": "b11f8be3-f29b-4959-8964-956d4af7c468"
}
],
"requestBody": {
"description": "ServiceRequest with the RiskCalculatorOptionModelDto to create",
"content": {
"application/json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/RiskCalculatorOptionModelDtoServiceRequest"
}
]
}
},
"text/json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/RiskCalculatorOptionModelDtoServiceRequest"
}
]
}
},
"application/*+json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/RiskCalculatorOptionModelDtoServiceRequest"
}
]
}
}
}
},
"responses": {
"202": {
"description": "RiskCalculatorOption model created successfully",
"content": {
"text/plain": {
"schema": {
"$ref": "#/components/schemas/RiskCalculatorOptionModelDtoServiceResponse"
}
},
"application/json": {
"schema": {
"$ref": "#/components/schemas/RiskCalculatorOptionModelDtoServiceResponse"
}
},
"text/json": {
"schema": {
"$ref": "#/components/schemas/RiskCalculatorOptionModelDtoServiceResponse"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"text/plain": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
},
"application/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
},
"text/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
}
}
},
"500": {
"description": "An exception occurred while processing the command"
},
"401": {
"description": "User is not authorized to perform this request",
"content": {
"application/json": {
"example": {
"message": "Unauthorized"
}
}
}
},
"403": {
"description": "Access to resource is forbidden.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": { },
"messages": [
{
"message": "Access denied. Following permissions are required: Permission1, Permission2",
"type": "Forbidden",
"errorCode": "Error Code"
}
]
}
}
}
},
"410": {
"description": "Endpoint marked as deprecated was terminated. This response will be present only if the endpoint was marked as deprecated and has reached the sunset date. During the deprecation period, the API will include additional 'sunset' and 'deprecation' headers.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/StringServiceResponse"
},
"example": {
"data": null,
"messages": [
{
"message": "This endpoint is obsolete and was terminated on yyyy-MM-dd",
"type": "Error",
"errorCode": "OBSOLETE_ENDPOINT"
}
]
}
}
}
}
}
}
},
"/api/risk-calculator-options/{id}": {
"put": {
"tags": [
"RiskCalculatorOptionModel"
],
"summary": "Update an existing RiskCalculatorOption",
"description": "\nThis method will update an existing RiskCalculatorOption\r\n with the data contained in the request DTO.<br /><br /><b>Required permissions:</b><br />Following permissions are required: RiskConfigurationEdit",
"operationId": "UpdateRiskCalculatorOptions",
"parameters": [
{
"name": "id",
"in": "path",
"description": "The Id of the existing model to update",
"required": true,
"schema": {
"type": "string",
"format": "uuid"
}
},
{
"name": "X-TENANT-ID",
"in": "header",
"description": "The UiD of the tenant representing organization",
"required": true,
"schema": {
"type": "string"
},
"example": "b11f8be3-f29b-4959-8964-956d4af7c468"
}
],
"requestBody": {
"description": "ServiceRequest with the updated RiskCalculatorOptionModelDto",
"content": {
"application/json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/RiskCalculatorOptionModelDtoServiceRequest"
}
]
}
},
"text/json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/RiskCalculatorOptionModelDtoServiceRequest"
}
]
}
},
"application/*+json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/RiskCalculatorOptionModelDtoServiceRequest"
}
]
}
}
}
},
"responses": {
"202": {
"description": "RiskCalculatorOption model updated successfully"
},
"400": {
"description": "Model Id is invalid",
"content": {
"text/plain": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
},
"application/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
},
"text/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
}
}
},
"500": {
"description": "An exception occurred while processing the command"
},
"401": {
"description": "User is not authorized to perform this request",
"content": {
"application/json": {
"example": {
"message": "Unauthorized"
}
}
}
},
"403": {
"description": "Access to resource is forbidden.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": { },
"messages": [
{
"message": "Access denied. Following permissions are required: Permission1, Permission2",
"type": "Forbidden",
"errorCode": "Error Code"
}
]
}
}
}
},
"410": {
"description": "Endpoint marked as deprecated was terminated. This response will be present only if the endpoint was marked as deprecated and has reached the sunset date. During the deprecation period, the API will include additional 'sunset' and 'deprecation' headers.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/StringServiceResponse"
},
"example": {
"data": null,
"messages": [
{
"message": "This endpoint is obsolete and was terminated on yyyy-MM-dd",
"type": "Error",
"errorCode": "OBSOLETE_ENDPOINT"
}
]
}
}
}
}
}
},
"delete": {
"tags": [
"RiskCalculatorOptionModel"
],
"summary": "Delete an existing RiskCalculatorOption",
"description": "\nThis method will delete an existing RiskCalculatorOption model.<br /><br /><b>Required permissions:</b><br />Following permissions are required: RiskConfigurationDelete",
"operationId": "DeleteRiskCalculatorOptions",
"parameters": [
{
"name": "id",
"in": "path",
"description": "The Id of the existing model to delete",
"required": true,
"schema": {
"type": "string",
"format": "uuid"
}
},
{
"name": "X-TENANT-ID",
"in": "header",
"description": "The UiD of the tenant representing organization",
"required": true,
"schema": {
"type": "string"
},
"example": "b11f8be3-f29b-4959-8964-956d4af7c468"
}
],
"responses": {
"202": {
"description": "RiskCalculatorOption model deleted successfully"
},
"400": {
"description": "Bad Request",
"content": {
"text/plain": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
},
"application/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
},
"text/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
}
}
},
"500": {
"description": "An exception occurred while processing the command"
},
"401": {
"description": "User is not authorized to perform this request",
"content": {
"application/json": {
"example": {
"message": "Unauthorized"
}
}
}
},
"403": {
"description": "Access to resource is forbidden.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": { },
"messages": [
{
"message": "Access denied. Following permissions are required: Permission1, Permission2",
"type": "Forbidden",
"errorCode": "Error Code"
}
]
}
}
}
},
"410": {
"description": "Endpoint marked as deprecated was terminated. This response will be present only if the endpoint was marked as deprecated and has reached the sunset date. During the deprecation period, the API will include additional 'sunset' and 'deprecation' headers.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/StringServiceResponse"
},
"example": {
"data": null,
"messages": [
{
"message": "This endpoint is obsolete and was terminated on yyyy-MM-dd",
"type": "Error",
"errorCode": "OBSOLETE_ENDPOINT"
}
]
}
}
}
}
}
}
},
"/api/risk-configuration": {
"post": {
"tags": [
"RiskConfiguration"
],
"summary": "Create a new RiskConfiguration model",
"description": "\nThis method will create a new RiskConfiguration model with a first draft version.\r\n\nThe new version will initialize with the DTO data and have the default status of Draft \r\n and the Author as the only required Signee.<br /><br /><b>Required permissions:</b><br />Following permissions are required: RiskConfigurationEdit",
"operationId": "CreateRiskConfigurationModel",
"parameters": [
{
"name": "X-TENANT-ID",
"in": "header",
"description": "The UiD of the tenant representing organization",
"required": true,
"schema": {
"type": "string"
},
"example": "b11f8be3-f29b-4959-8964-956d4af7c468"
}
],
"requestBody": {
"description": "ServiceRequest with the RiskConfigurationModelDto to create",
"content": {
"application/json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/RiskConfigurationModelDtoServiceRequest"
}
]
}
},
"text/json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/RiskConfigurationModelDtoServiceRequest"
}
]
}
},
"application/*+json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/RiskConfigurationModelDtoServiceRequest"
}
]
}
}
}
},
"responses": {
"202": {
"description": "RiskConfiguration model created successfully",
"content": {
"text/plain": {
"schema": {
"$ref": "#/components/schemas/RiskConfigurationModelDtoServiceResponse"
}
},
"application/json": {
"schema": {
"$ref": "#/components/schemas/RiskConfigurationModelDtoServiceResponse"
}
},
"text/json": {
"schema": {
"$ref": "#/components/schemas/RiskConfigurationModelDtoServiceResponse"
}
}
}
},
"400": {
"description": "Bad Request",
"content": {
"text/plain": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
},
"application/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
},
"text/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
}
}
},
"500": {
"description": "An exception occurred while processing the command"
},
"401": {
"description": "User is not authorized to perform this request",
"content": {
"application/json": {
"example": {
"message": "Unauthorized"
}
}
}
},
"403": {
"description": "Access to resource is forbidden.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": { },
"messages": [
{
"message": "Access denied. Following permissions are required: Permission1, Permission2",
"type": "Forbidden",
"errorCode": "Error Code"
}
]
}
}
}
},
"410": {
"description": "Endpoint marked as deprecated was terminated. This response will be present only if the endpoint was marked as deprecated and has reached the sunset date. During the deprecation period, the API will include additional 'sunset' and 'deprecation' headers.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/StringServiceResponse"
},
"example": {
"data": null,
"messages": [
{
"message": "This endpoint is obsolete and was terminated on yyyy-MM-dd",
"type": "Error",
"errorCode": "OBSOLETE_ENDPOINT"
}
]
}
}
}
}
}
}
},
"/api/risk-configuration/{id}": {
"post": {
"tags": [
"RiskConfiguration"
],
"summary": "Create a new Version for an existing RiskConfiguration model",
"description": "\nThis method will create a new RiskConfiguration model version.\r\n\nThe new version will initialize with the DTO data. It will be assigned the next available version number, \r\n the default status of Draft and the Author as the only required Signee.<br /><br /><b>Required permissions:</b><br />Following permissions are required: RiskConfigurationEdit",
"operationId": "CreateRiskConfigurationModelVersion",
"parameters": [
{
"name": "id",
"in": "path",
"description": "The Id of the existing model",
"required": true,
"schema": {
"type": "string",
"format": "uuid"
}
},
{
"name": "X-TENANT-ID",
"in": "header",
"description": "The UiD of the tenant representing organization",
"required": true,
"schema": {
"type": "string"
},
"example": "b11f8be3-f29b-4959-8964-956d4af7c468"
}
],
"requestBody": {
"description": "ServiceRequest with the new version data",
"content": {
"application/json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/RiskConfigurationModelDtoServiceRequest"
}
]
}
},
"text/json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/RiskConfigurationModelDtoServiceRequest"
}
]
}
},
"application/*+json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/RiskConfigurationModelDtoServiceRequest"
}
]
}
}
}
},
"responses": {
"202": {
"description": "RiskConfiguration model version created successfully",
"content": {
"text/plain": {
"schema": {
"$ref": "#/components/schemas/RiskConfigurationModelDtoServiceResponse"
}
},
"application/json": {
"schema": {
"$ref": "#/components/schemas/RiskConfigurationModelDtoServiceResponse"
}
},
"text/json": {
"schema": {
"$ref": "#/components/schemas/RiskConfigurationModelDtoServiceResponse"
}
}
}
},
"400": {
"description": "Model Id is invalid",
"content": {
"text/plain": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
},
"application/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
},
"text/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
}
}
},
"500": {
"description": "An exception occurred while processing the command"
},
"401": {
"description": "User is not authorized to perform this request",
"content": {
"application/json": {
"example": {
"message": "Unauthorized"
}
}
}
},
"403": {
"description": "Access to resource is forbidden.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": { },
"messages": [
{
"message": "Access denied. Following permissions are required: Permission1, Permission2",
"type": "Forbidden",
"errorCode": "Error Code"
}
]
}
}
}
},
"410": {
"description": "Endpoint marked as deprecated was terminated. This response will be present only if the endpoint was marked as deprecated and has reached the sunset date. During the deprecation period, the API will include additional 'sunset' and 'deprecation' headers.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/StringServiceResponse"
},
"example": {
"data": null,
"messages": [
{
"message": "This endpoint is obsolete and was terminated on yyyy-MM-dd",
"type": "Error",
"errorCode": "OBSOLETE_ENDPOINT"
}
]
}
}
}
}
}
},
"put": {
"tags": [
"RiskConfiguration"
],
"summary": "Update an existing Version of a RiskConfiguration model",
"description": "\nThis method will update an existing RiskConfiguration model version.\r\n\nOnly Draft and Rejected versions are allowed to be updated.<br /><br /><b>Required permissions:</b><br />Following permissions are required: RiskConfigurationEdit",
"operationId": "UpdateRiskConfigurationModel",
"parameters": [
{
"name": "id",
"in": "path",
"description": "The Id of the existing model",
"required": true,
"schema": {
"type": "string",
"format": "uuid"
}
},
{
"name": "X-TENANT-ID",
"in": "header",
"description": "The UiD of the tenant representing organization",
"required": true,
"schema": {
"type": "string"
},
"example": "b11f8be3-f29b-4959-8964-956d4af7c468"
}
],
"requestBody": {
"description": "ServiceRequest with the updated version data",
"content": {
"application/json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/RiskConfigurationModelDtoServiceRequest"
}
]
}
},
"text/json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/RiskConfigurationModelDtoServiceRequest"
}
]
}
},
"application/*+json": {
"schema": {
"allOf": [
{
"$ref": "#/components/schemas/RiskConfigurationModelDtoServiceRequest"
}
]
}
}
}
},
"responses": {
"202": {
"description": "RiskConfiguration model version updated successfully"
},
"400": {
"description": "Model Id is invalid",
"content": {
"text/plain": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
},
"application/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
},
"text/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
}
}
},
"500": {
"description": "An exception occurred while processing the command"
},
"401": {
"description": "User is not authorized to perform this request",
"content": {
"application/json": {
"example": {
"message": "Unauthorized"
}
}
}
},
"403": {
"description": "Access to resource is forbidden.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": { },
"messages": [
{
"message": "Access denied. Following permissions are required: Permission1, Permission2",
"type": "Forbidden",
"errorCode": "Error Code"
}
]
}
}
}
},
"410": {
"description": "Endpoint marked as deprecated was terminated. This response will be present only if the endpoint was marked as deprecated and has reached the sunset date. During the deprecation period, the API will include additional 'sunset' and 'deprecation' headers.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/StringServiceResponse"
},
"example": {
"data": null,
"messages": [
{
"message": "This endpoint is obsolete and was terminated on yyyy-MM-dd",
"type": "Error",
"errorCode": "OBSOLETE_ENDPOINT"
}
]
}
}
}
}
}
},
"delete": {
"tags": [
"RiskConfiguration"
],
"summary": "Delete an existing RiskConfiguration model",
"description": "\nThis method will delete an existing RiskConfiguration model as well as all its versions.<br /><br /><b>Required permissions:</b><br />Following permissions are required: RiskConfigurationDelete",
"operationId": "DeleteRiskConfigurationModel",
"parameters": [
{
"name": "id",
"in": "path",
"description": "The Id of the existing model to delete",
"required": true,
"schema": {
"type": "string",
"format": "uuid"
}
},
{
"name": "X-TENANT-ID",
"in": "header",
"description": "The UiD of the tenant representing organization",
"required": true,
"schema": {
"type": "string"
},
"example": "b11f8be3-f29b-4959-8964-956d4af7c468"
}
],
"responses": {
"202": {
"description": "RiskConfiguration model deleted successfully"
},
"400": {
"description": "Bad Request",
"content": {
"text/plain": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
},
"application/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
},
"text/json": {
"schema": {
"$ref": "#/components/schemas/ServiceResponse"
}
}
}
},
"500": {
"description": "An exception occurred while processing the command"
},
"401": {
"description": "User is not authorized to perform this request",
"content": {
"application/json": {
"example": {
"message": "Unauthorized"
}
}
}
},
"403": {
"description": "Access to resource is forbidden.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ObjectServiceResponse"
},
"example": {
"data": { },
"messages": [
{
"message": "Access denied. Following permissions are required: Permission1, Permission2",
"type": "Forbidden",
"errorCode": "Error Code"
}
]
}
}
}
},
"410": {
"description": "Endpoi
# --- truncated at 32 KB (268 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/fenergo/refs/heads/main/openapi/fenergo-riskcommand-v1-0-openapi.json