@planqk/planqk-api-sdk 1.3.6 → 1.6.0

package/fern/openapi/openapi.json

@@ -13,16 +13,77 @@
   "servers": [
     {
       "url": "https://platform.planqk.de/qc-catalog",
-      "description": "Generated server url"
+      "description": "Platform API URL"
     }
   ],
   "tags": [
+    {
+      "name": "Service Jobs",
+      "description": "Run your created services in a job-based manner. Service jobs allow you to execute services with specific parameters and track their execution status, costs, logs, metrics, and results."
+    },
+    {
+      "name": "Service Executions",
+      "description": "Track status, costs, logs, metrics, and results of your service executions."
+    },
     {
       "name": "Data Pools",
       "description": "Manage data pools, which are organized collections of files that serve as reusable data sources for services."
     }
   ],
   "paths": {
+    "/service-jobs/{id}/cancel": {
+      "put": {
+        "tags": [
+          "Service Jobs"
+        ],
+        "description": "Cancel a specific service job (identified by its ID). Only service jobs that are pending or currently running can be cancelled.",
+        "operationId": "cancelServiceJob",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          },
+          {
+            "name": "X-OrganizationId",
+            "in": "header",
+            "description": "The ID of your organization in case you want to perform operations in this context. Leave it empty to operate in your personal account.",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "Service job is cancelled"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "Not Found"
+          },
+          "500": {
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "oauth2": []
+          },
+          {
+            "apiKey": []
+          }
+        ]
+      }
+    },
     "/datapools/{id}": {
       "get": {
         "tags": [
@@ -205,12 +266,128 @@
         ]
       }
     },
+    "/service-jobs": {
+      "get": {
+        "tags": [
+          "Service Jobs"
+        ],
+        "description": "Get a list of all service jobs for the current user or organization.",
+        "operationId": "getServiceJobs",
+        "parameters": [
+          {
+            "name": "X-OrganizationId",
+            "in": "header",
+            "description": "The ID of your organization in case you want to perform operations in this context. Leave it empty to operate in your personal account.",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "List of service jobs",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/ServiceJobDto"
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "Not Found"
+          },
+          "500": {
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "oauth2": []
+          },
+          {
+            "apiKey": []
+          }
+        ]
+      },
+      "post": {
+        "tags": [
+          "Service Jobs"
+        ],
+        "description": "Create and start a new service job.",
+        "operationId": "createServiceJob",
+        "parameters": [
+          {
+            "name": "X-OrganizationId",
+            "in": "header",
+            "description": "The ID of your organization in case you want to perform operations in this context. Leave it empty to operate in your personal account.",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CreateServiceJobRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "201": {
+            "description": "Service job is created and scheduled to start",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ServiceJobDto"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Bad Request"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "Not Found"
+          },
+          "500": {
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "oauth2": []
+          },
+          {
+            "apiKey": []
+          }
+        ]
+      }
+    },
     "/datapools": {
       "get": {
         "tags": [
           "Data Pools"
         ],
-        "description": "Get a list of all data pools for the current user.",
+        "description": "Get a list of all data pools for the current user or organization.",
         "operationId": "getDataPools",
         "parameters": [
           {
@@ -471,13 +648,13 @@
         ]
       }
     },
-    "/datapools/{id}/files/{fileId}": {
+    "/service-executions/v1/{id}": {
       "get": {
         "tags": [
-          "Data Pools"
+          "Service Executions"
         ],
-        "description": "Get the content of a specific file from a data pool (both file and data pool identified by their ID).",
-        "operationId": "getDataPoolFile",
+        "description": "Get a specific service execution (identified by its ID).",
+        "operationId": "getServiceExecution",
         "parameters": [
           {
             "name": "id",
@@ -488,15 +665,6 @@
               "format": "uuid"
             }
           },
-          {
-            "name": "fileId",
-            "in": "path",
-            "required": true,
-            "schema": {
-              "type": "string",
-              "format": "uuid"
-            }
-          },
           {
             "name": "X-OrganizationId",
             "in": "header",
@@ -508,19 +676,23 @@
         ],
         "responses": {
           "200": {
-            "description": "The file content",
+            "description": "A service execution, either a managed or workflow service execution",
             "content": {
-              "application/octet-stream": {
+              "application/json": {
                 "schema": {
                   "type": "string",
-                  "format": "binary"
+                  "oneOf": [
+                    {
+                      "$ref": "#/components/schemas/ServiceExecutionDto"
+                    },
+                    {
+                      "$ref": "#/components/schemas/WorkflowServiceExecutionDto"
+                    }
+                  ]
                 }
               }
             }
           },
-          "304": {
-            "description": "Not Modified"
-          },
           "401": {
             "description": "Unauthorized"
           },
@@ -543,12 +715,12 @@
           }
         ]
       },
-      "delete": {
+      "head": {
         "tags": [
-          "Data Pools"
+          "Service Executions"
         ],
-        "description": "Delete a specific file from a data pool (both file and data pool identified by their IDs).",
-        "operationId": "deleteDataPoolFile",
+        "description": "Check if the tenant has view permission for a specific service execution (identified by its ID).",
+        "operationId": "headServiceExecution",
         "parameters": [
           {
             "name": "id",
@@ -560,7 +732,51 @@
             }
           },
           {
-            "name": "fileId",
+            "name": "X-OrganizationId",
+            "in": "header",
+            "description": "The ID of your organization in case you want to perform operations in this context. Leave it empty to operate in your personal account.",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "View permission for the service execution"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "Not Found"
+          },
+          "500": {
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "oauth2": []
+          },
+          {
+            "apiKey": []
+          }
+        ]
+      }
+    },
+    "/service-jobs/{id}": {
+      "get": {
+        "tags": [
+          "Service Jobs"
+        ],
+        "description": "Get a specific service job (identified by its ID).",
+        "operationId": "getServiceJob",
+        "parameters": [
+          {
+            "name": "id",
             "in": "path",
             "required": true,
             "schema": {
@@ -578,8 +794,15 @@
           }
         ],
         "responses": {
-          "204": {
-            "description": "File is deleted"
+          "200": {
+            "description": "A service job",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ServiceJobDto"
+                }
+              }
+            }
           },
           "401": {
             "description": "Unauthorized"
@@ -603,21 +826,347 @@
           }
         ]
       }
-    }
-  },
-  "components": {
-    "schemas": {
-      "UpdateDataPoolRequest": {
-        "type": "object",
-        "properties": {
-          "name": {
-            "type": "string"
-          },
-          "shortDescription": {
-            "type": "string"
+    },
+    "/service-jobs/{id}/results": {
+      "get": {
+        "tags": [
+          "Service Jobs"
+        ],
+        "description": "Get the results for a specific service job (identified by its ID). If the service job has not completed yet or no results are available, a HTTP 204 (No Content) response is returned with a Retry-After header.",
+        "operationId": "getServiceJobResults",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
           },
-          "description": {
-            "type": "string"
+          {
+            "name": "X-OrganizationId",
+            "in": "header",
+            "description": "The ID of your organization in case you want to perform operations in this context. Leave it empty to operate in your personal account.",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Result for the service job",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object"
+                }
+              }
+            }
+          },
+          "204": {
+            "description": "No result available yet, retry later"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "Not Found"
+          },
+          "500": {
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "oauth2": []
+          },
+          {
+            "apiKey": []
+          }
+        ]
+      }
+    },
+    "/service-jobs/{id}/logs": {
+      "get": {
+        "tags": [
+          "Service Jobs"
+        ],
+        "description": "Get the logs for a specific service job (identified by its ID). If the service job has not started yet or no logs are available, a HTTP 204 (No Content) response is returned with a Retry-After header.",
+        "operationId": "getServiceJobLogs",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          },
+          {
+            "name": "X-OrganizationId",
+            "in": "header",
+            "description": "The ID of your organization in case you want to perform operations in this context. Leave it empty to operate in your personal account.",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "All logs for the service job",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ServiceExecutionLogs"
+                }
+              }
+            }
+          },
+          "204": {
+            "description": "No logs available yet, retry later"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "Not Found"
+          },
+          "500": {
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "oauth2": []
+          },
+          {
+            "apiKey": []
+          }
+        ]
+      }
+    },
+    "/service-executions/v1/{id}/metrics": {
+      "get": {
+        "tags": [
+          "Service Executions"
+        ],
+        "description": "Get resource usage metrics for a specific service execution (identified by its ID).",
+        "operationId": "getServiceExecutionMetrics",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          },
+          {
+            "name": "X-OrganizationId",
+            "in": "header",
+            "description": "The ID of your organization in case you want to perform operations in this context. Leave it empty to operate in your personal account.",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The resource usage metrics",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ServiceExecutionMetrics"
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "Not Found"
+          },
+          "500": {
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "oauth2": []
+          },
+          {
+            "apiKey": []
+          }
+        ]
+      }
+    },
+    "/datapools/{id}/files/{fileId}": {
+      "get": {
+        "tags": [
+          "Data Pools"
+        ],
+        "description": "Get the content of a specific file from a data pool (both file and data pool identified by their ID).",
+        "operationId": "getDataPoolFile",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          },
+          {
+            "name": "fileId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          },
+          {
+            "name": "X-OrganizationId",
+            "in": "header",
+            "description": "The ID of your organization in case you want to perform operations in this context. Leave it empty to operate in your personal account.",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The file content",
+            "content": {
+              "application/octet-stream": {
+                "schema": {
+                  "type": "string",
+                  "format": "binary"
+                }
+              }
+            }
+          },
+          "304": {
+            "description": "Not Modified"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "Not Found"
+          },
+          "500": {
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "oauth2": []
+          },
+          {
+            "apiKey": []
+          }
+        ]
+      },
+      "delete": {
+        "tags": [
+          "Data Pools"
+        ],
+        "description": "Delete a specific file from a data pool (both file and data pool identified by their IDs).",
+        "operationId": "deleteDataPoolFile",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          },
+          {
+            "name": "fileId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string",
+              "format": "uuid"
+            }
+          },
+          {
+            "name": "X-OrganizationId",
+            "in": "header",
+            "description": "The ID of your organization in case you want to perform operations in this context. Leave it empty to operate in your personal account.",
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "File is deleted"
+          },
+          "401": {
+            "description": "Unauthorized"
+          },
+          "403": {
+            "description": "Forbidden"
+          },
+          "404": {
+            "description": "Not Found"
+          },
+          "500": {
+            "description": "Internal Server Error"
+          }
+        },
+        "security": [
+          {
+            "oauth2": []
+          },
+          {
+            "apiKey": []
+          }
+        ]
+      }
+    }
+  },
+  "components": {
+    "schemas": {
+      "UpdateDataPoolRequest": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "The name of the data pool. Must be at least 3 characters and at most 255 characters long.",
+            "example": "my-data-pool",
+            "maxLength": 255,
+            "minLength": 3
+          },
+          "shortDescription": {
+            "type": "string",
+            "description": "Short description of the data pool.",
+            "maxLength": 255
+          },
+          "description": {
+            "type": "string",
+            "description": "Detailed description of the data pool."
           }
         }
       },
@@ -637,28 +1186,127 @@
           },
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "description": "Unique identifier of the data pool."
           },
           "name": {
-            "type": "string"
+            "type": "string",
+            "description": "Name of the data pool.",
+            "example": "my-data-pool"
           },
           "shortDescription": {
-            "type": "string"
+            "type": "string",
+            "description": "Short description of the data pool."
           },
           "description": {
-            "type": "string"
+            "type": "string",
+            "description": "Detailed description of the data pool."
           },
           "createdAt": {
             "type": "string",
+            "description": "Timestamp when the data pool was created.",
+            "example": "2023-10-01 12:00:00",
             "pattern": "^\\d{4}\\-\\d{2}\\-\\d{2}\\s{1}\\d{2}\\:\\d{2}\\:\\d{2}$"
           }
         }
       },
+      "CreateServiceJobRequest": {
+        "type": "object",
+        "properties": {
+          "serviceId": {
+            "type": "string",
+            "format": "uuid",
+            "description": "The ID fo the service for which the job is created."
+          },
+          "input": {
+            "additionalProperties": true,
+            "description": "Input data for the service job. This can be any JSON object that the service expects as input. The structure and content of this object depend on the specific service being executed."
+          },
+          "tags": {
+            "type": "array",
+            "description": "List of tags associated with the service job. Tags are saved in lowercase and can be used for filtering and searching.",
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      },
+      "ServiceJobDto": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "format": "uuid",
+            "description": "The ID of the service job."
+          },
+          "serviceId": {
+            "type": "string",
+            "format": "uuid",
+            "description": "The ID of the service for which this job was created."
+          },
+          "serviceDefinitionId": {
+            "type": "string",
+            "format": "uuid",
+            "description": "The ID of the service definition for which this job was created."
+          },
+          "status": {
+            "type": "string",
+            "description": "Status of the service job.",
+            "enum": [
+              "UNKNOWN",
+              "PENDING",
+              "RUNNING",
+              "SUCCEEDED",
+              "FAILED",
+              "CANCELLED"
+            ],
+            "example": "RUNNING"
+          },
+          "createdAt": {
+            "type": "string",
+            "description": "Timestamp when the service job was created.",
+            "example": "2023-10-01 12:00:00",
+            "pattern": "^\\d{4}\\-\\d{2}\\-\\d{2}\\s{1}\\d{2}\\:\\d{2}\\:\\d{2}$"
+          },
+          "startedAt": {
+            "type": "string",
+            "description": "Timestamp when the service job started.",
+            "example": "2023-10-01 12:00:00",
+            "pattern": "^\\d{4}\\-\\d{2}\\-\\d{2}\\s{1}\\d{2}\\:\\d{2}\\:\\d{2}$"
+          },
+          "endedAt": {
+            "type": "string",
+            "description": "Timestamp when the service job ended.",
+            "example": "2023-10-01 12:00:00",
+            "pattern": "^\\d{4}\\-\\d{2}\\-\\d{2}\\s{1}\\d{2}\\:\\d{2}\\:\\d{2}$"
+          },
+          "type": {
+            "type": "string",
+            "description": "Type identifier for the service job, indicating whether the underlying service is a 'managed' or 'workflow' service.",
+            "enum": [
+              "MANAGED",
+              "EXTERNAL",
+              "WORKFLOW"
+            ]
+          },
+          "tags": {
+            "type": "array",
+            "description": "List of tags associated with the service job. Tags are saved in lowercase and can be used for filtering and searching.",
+            "items": {
+              "type": "string"
+            }
+          }
+        }
+      },
       "CreateDataPoolRequest": {
         "type": "object",
         "properties": {
           "name": {
-            "type": "string"
+            "type": "string",
+            "description": "The name of the data pool. Must be at least 3 characters and at most 255 characters long.",
+            "example": "my-data-pool",
+            "maxLength": 255,
+            "minLength": 3
           }
         }
       },
@@ -667,30 +1315,278 @@
         "properties": {
           "id": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "description": "Unique identifier of the data pool file."
           },
           "dataPoolId": {
             "type": "string",
-            "format": "uuid"
+            "format": "uuid",
+            "description": "Unique identifier of the data pool."
           },
           "name": {
-            "type": "string"
+            "type": "string",
+            "description": "The name of the file.",
+            "example": "example.txt"
           },
           "fullPath": {
-            "type": "string"
+            "type": "string",
+            "description": "The full path of the file in the data pool.",
+            "example": "/path/to/example.txt"
           },
           "contentType": {
-            "type": "string"
+            "type": "string",
+            "description": "The content type of the file.",
+            "example": "text/plain"
           },
           "contentLength": {
             "type": "integer",
-            "format": "int64"
+            "format": "int64",
+            "description": "The size of the file in bytes.",
+            "example": 1024
           },
           "createdAt": {
             "type": "string",
+            "description": "Timestamp when the file was created.",
+            "example": "2023-10-01 12:00:00",
+            "pattern": "^\\d{4}\\-\\d{2}\\-\\d{2}\\s{1}\\d{2}\\:\\d{2}\\:\\d{2}$"
+          }
+        }
+      },
+      "LogEntry": {
+        "type": "object",
+        "properties": {
+          "message": {
+            "type": "string",
+            "description": "Log message content."
+          },
+          "severity": {
+            "type": "string",
+            "description": "Severity of the log entry.",
+            "enum": [
+              "DEBUG",
+              "NOTICE",
+              "INFO",
+              "WARNING",
+              "ERROR"
+            ],
+            "example": "INFO"
+          },
+          "timestamp": {
+            "type": "string",
+            "description": "Timestamp when the entry was logged.",
+            "example": "2023-10-01 12:00:00",
             "pattern": "^\\d{4}\\-\\d{2}\\-\\d{2}\\s{1}\\d{2}\\:\\d{2}\\:\\d{2}$"
           }
         }
+      },
+      "ServiceExecutionLogs": {
+        "type": "array",
+        "items": {
+          "$ref": "#/components/schemas/LogEntry"
+        },
+        "properties": {
+          "empty": {
+            "type": "boolean"
+          }
+        }
+      },
+      "ServiceExecutionDto": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "format": "uuid"
+          },
+          "createdAt": {
+            "type": "string",
+            "pattern": "^\\d{4}\\-\\d{2}\\-\\d{2}\\s{1}\\d{2}\\:\\d{2}\\:\\d{2}$"
+          },
+          "startedAt": {
+            "type": "string",
+            "pattern": "^\\d{4}\\-\\d{2}\\-\\d{2}\\s{1}\\d{2}\\:\\d{2}\\:\\d{2}$"
+          },
+          "endedAt": {
+            "type": "string",
+            "pattern": "^\\d{4}\\-\\d{2}\\-\\d{2}\\s{1}\\d{2}\\:\\d{2}\\:\\d{2}$"
+          },
+          "status": {
+            "type": "string",
+            "enum": [
+              "UNKNOWN",
+              "PENDING",
+              "RUNNING",
+              "SUCCEEDED",
+              "FAILED",
+              "CANCELLED"
+            ]
+          }
+        }
+      },
+      "ActivityInstance": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "modelId": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "type": {
+            "type": "string"
+          },
+          "startTime": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "endTime": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "state": {
+            "type": "string",
+            "enum": [
+              "PENDING",
+              "RUNNING",
+              "COMPLETED"
+            ]
+          }
+        }
+      },
+      "VariableInstance": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "type": {
+            "type": "string"
+          },
+          "value": {}
+        }
+      },
+      "WorkflowInstance": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string"
+          },
+          "state": {
+            "type": "string",
+            "enum": [
+              "UNKNOWN",
+              "PENDING",
+              "RUNNING",
+              "SUCCEEDED",
+              "FAILED",
+              "CANCELLED"
+            ]
+          },
+          "startedAt": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "endedAt": {
+            "type": "string",
+            "format": "date-time"
+          },
+          "activities": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ActivityInstance"
+            },
+            "uniqueItems": true
+          },
+          "variables": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/VariableInstance"
+            },
+            "uniqueItems": true
+          }
+        }
+      },
+      "WorkflowServiceExecutionDto": {
+        "type": "object",
+        "properties": {
+          "workflowInstance": {
+            "$ref": "#/components/schemas/WorkflowInstance"
+          },
+          "workflowModel": {
+            "type": "string"
+          }
+        }
+      },
+      "MetricDataPoint": {
+        "type": "object",
+        "description": "A single data point in a time series metric",
+        "properties": {
+          "timestamp": {
+            "type": "integer",
+            "format": "int64",
+            "description": "Timestamp of the data point in milliseconds since Unix epoch (UTC)",
+            "example": 1756965745000
+          },
+          "value": {
+            "type": "number",
+            "format": "double",
+            "description": "The metric value"
+          }
+        }
+      },
+      "ServiceExecutionMetrics": {
+        "type": "object",
+        "description": "Resource usage metrics for a service execution",
+        "properties": {
+          "serviceExecutionId": {
+            "type": "string",
+            "format": "uuid",
+            "description": "Service execution ID"
+          },
+          "cpuUsage": {
+            "type": "array",
+            "description": "CPU usage metrics time series",
+            "items": {
+              "$ref": "#/components/schemas/MetricDataPoint"
+            }
+          },
+          "cpuLimit": {
+            "type": "array",
+            "description": "CPU limit metrics time series",
+            "items": {
+              "$ref": "#/components/schemas/MetricDataPoint"
+            }
+          },
+          "memoryUsage": {
+            "type": "array",
+            "description": "Memory usage metrics time series",
+            "items": {
+              "$ref": "#/components/schemas/MetricDataPoint"
+            }
+          },
+          "memoryLimit": {
+            "type": "array",
+            "description": "Memory limit metrics time series",
+            "items": {
+              "$ref": "#/components/schemas/MetricDataPoint"
+            }
+          },
+          "startTime": {
+            "type": "string",
+            "format": "date-time",
+            "description": "Time range start"
+          },
+          "endTime": {
+            "type": "string",
+            "format": "date-time",
+            "description": "Time range end"
+          }
+        }
       }
     },
     "securitySchemes": {
@@ -713,4 +1609,4 @@
       }
     }
   }
-}
+}