diff --git a/dataset/src/main/openapi/dataset.yaml b/dataset/src/main/openapi/dataset.yaml index 55e6675c3..36b806612 100644 --- a/dataset/src/main/openapi/dataset.yaml +++ b/dataset/src/main/openapi/dataset.yaml @@ -20,11 +20,13 @@ paths: parameters: - $ref: '#/components/parameters/organizationId' - $ref: '#/components/parameters/workspaceId' - description: Create a dataset post: operationId: createDataset tags: - dataset + description: Create a new dataset in the workspace. + The dataset is initialized with specified parts (can be empty). + The dataset can also be populated through dataset parts. summary: Create a Dataset requestBody: content: @@ -71,7 +73,7 @@ paths: - $ref: '#/components/parameters/size' tags: - dataset - description: List all datasets + description: "Retrieve a paginated list of all datasets in the specified workspace. Supports pagination via 'page' and 'size' query parameters. Returns datasets based on user permissions." summary: Retrieve a list of defined Dataset responses: "200": @@ -166,7 +168,7 @@ paths: operationId: getDataset tags: - dataset - description: Retrieve a dataset + description: Retrieve complete information about a specific dataset including dataset parts. summary: Retrieve a Dataset responses: "200": @@ -192,7 +194,7 @@ paths: operationId: updateDataset tags: - dataset - description: Update a dataset + description: Update dataset information and return the updated dataset. summary: Update a Dataset requestBody: content: @@ -235,7 +237,7 @@ paths: operationId: deleteDataset tags: - dataset - description: Delete a dataset + description: "Permanently delete a dataset and all its data parts. This operation cannot be undone." summary: Delete a Dataset responses: "204": @@ -411,6 +413,7 @@ paths: operationId: deleteDatasetAccessControl tags: - dataset + description: "Remove a user or group's access to a dataset. Cannot remove the last administrator - at least one admin must remain." summary: Remove the specified access from the given Dataset responses: "204": @@ -460,9 +463,9 @@ paths: operationId: createDatasetPart tags: - dataset + description: "Create a new data part within a dataset. Specify type as 'File' for file storage or 'DB' for database storage. Returns the created part." summary: Create a data part of a Dataset requestBody: - description: New Dataset part to create. content: multipart/form-data: schema: @@ -507,6 +510,7 @@ paths: - $ref: '#/components/parameters/size' tags: - dataset + description: "Retrieve all data parts associated with a dataset." summary: Retrieve all dataset parts of a Dataset responses: "200": @@ -759,6 +763,7 @@ paths: operationId: queryData tags: - dataset + description: "Execute a query against a dataset part. Results are returned as plain-text CSV. Only available for parts with type=DB." summary: | Query data of a Dataset part. This endpoint is only available for dataset parts that support queries (type == DB). @@ -789,6 +794,7 @@ paths: operationId: downloadDatasetPart tags: - dataset + description: "Download the file content from a dataset part. Returns the file as an application/octet-stream." summary: Download data from a dataset part responses: "200": diff --git a/doc/Apis/DatasetApi.md b/doc/Apis/DatasetApi.md index bfab9a5e4..dccff8481 100644 --- a/doc/Apis/DatasetApi.md +++ b/doc/Apis/DatasetApi.md @@ -33,6 +33,8 @@ All URIs are relative to *http://localhost:8080* Create a Dataset + Create a new dataset in the workspace. The dataset is initialized with specified parts (can be empty). The dataset can also be populated through dataset parts. + ### Parameters |Name | Type | Description | Notes | @@ -89,6 +91,8 @@ Add a control access to the Dataset Create a data part of a Dataset + Create a new data part within a dataset. Specify type as 'File' for file storage or 'DB' for database storage. Returns the created part. + ### Parameters |Name | Type | Description | Notes | @@ -118,7 +122,7 @@ Create a data part of a Dataset Delete a Dataset - Delete a dataset + Permanently delete a dataset and all its data parts. This operation cannot be undone. ### Parameters @@ -147,6 +151,8 @@ null (empty response body) Remove the specified access from the given Dataset + Remove a user or group's access to a dataset. Cannot remove the last administrator - at least one admin must remain. + ### Parameters |Name | Type | Description | Notes | @@ -205,6 +211,8 @@ null (empty response body) Download data from a dataset part + Download the file content from a dataset part. Returns the file as an application/octet-stream. + ### Parameters |Name | Type | Description | Notes | @@ -233,7 +241,7 @@ Download data from a dataset part Retrieve a Dataset - Retrieve a dataset + Retrieve complete information about a specific dataset including dataset parts. ### Parameters @@ -318,6 +326,8 @@ Retrieve a data part of a Dataset Retrieve all dataset parts of a Dataset + Retrieve all data parts associated with a dataset. + ### Parameters |Name | Type | Description | Notes | @@ -374,7 +384,7 @@ Get the Dataset security users list Retrieve a list of defined Dataset - List all datasets + Retrieve a paginated list of all datasets in the specified workspace. Supports pagination via 'page' and 'size' query parameters. Returns datasets based on user permissions. ### Parameters @@ -404,6 +414,8 @@ Retrieve a list of defined Dataset Query data of a Dataset part. This endpoint is only available for dataset parts that support queries (type == DB). + Execute a query against a dataset part. Results are returned as plain-text CSV. Only available for parts with type=DB. + ### Parameters |Name | Type | Description | Notes | @@ -531,7 +543,7 @@ Search Datasets by tags Update a Dataset - Update a dataset + Update dataset information and return the updated dataset. ### Parameters diff --git a/doc/Apis/MetaApi.md b/doc/Apis/MetaApi.md index 2d5e55c57..ef2582340 100644 --- a/doc/Apis/MetaApi.md +++ b/doc/Apis/MetaApi.md @@ -13,6 +13,8 @@ All URIs are relative to *http://localhost:8080* Get various information about the API + Retrieve API version information and build details. + ### Parameters This endpoint does not need any parameter. diff --git a/doc/Apis/OrganizationApi.md b/doc/Apis/OrganizationApi.md index d7b19522e..d37263ffb 100644 --- a/doc/Apis/OrganizationApi.md +++ b/doc/Apis/OrganizationApi.md @@ -26,11 +26,13 @@ All URIs are relative to *http://localhost:8080* Create a new organization + Create a new organization. + ### Parameters |Name | Type | Description | Notes | |------------- | ------------- | ------------- | -------------| -| **OrganizationCreateRequest** | [**OrganizationCreateRequest**](../Models/OrganizationCreateRequest.md)| The Organization to create | | +| **OrganizationCreateRequest** | [**OrganizationCreateRequest**](../Models/OrganizationCreateRequest.md)| | | ### Return type @@ -51,6 +53,8 @@ Create a new organization Add a control access to the Organization + Grant access to an organization for a user or group. + ### Parameters |Name | Type | Description | Notes | @@ -77,6 +81,8 @@ Add a control access to the Organization Delete an organization + Permanently delete an organization. This operation cannot be undone. + ### Parameters |Name | Type | Description | Notes | @@ -128,6 +134,8 @@ null (empty response body) Get the details of an Organization + Retrieve detailed information about an organization. + ### Parameters |Name | Type | Description | Notes | @@ -255,6 +263,8 @@ Get the Organization security users list List all Organizations + Retrieve a paginated list of all organizations the authenticated user has permission to view. Use 'page' and 'size' query parameters for pagination. + ### Parameters |Name | Type | Description | Notes | diff --git a/doc/Apis/RunApi.md b/doc/Apis/RunApi.md index 45493333e..47e971b01 100644 --- a/doc/Apis/RunApi.md +++ b/doc/Apis/RunApi.md @@ -45,6 +45,8 @@ null (empty response body) Get the details of a run + Retrieve detailed information about a specific run. + ### Parameters |Name | Type | Description | Notes | @@ -73,6 +75,8 @@ Get the details of a run get the logs for the Run + Retrieve execution logs for a run as plain text. Logs are aggregated from all containers. May be truncated for long-running simulations. + ### Parameters |Name | Type | Description | Notes | @@ -101,6 +105,8 @@ get the logs for the Run get the status for the Run + Retrieve detailed execution status of a run. + ### Parameters |Name | Type | Description | Notes | @@ -129,6 +135,8 @@ get the status for the Run get the list of Runs for the Runner + Retrieve a paginated list of all runs for a specific runner. + ### Parameters |Name | Type | Description | Notes | diff --git a/doc/Apis/RunnerApi.md b/doc/Apis/RunnerApi.md index af4db04c8..ffccda65b 100644 --- a/doc/Apis/RunnerApi.md +++ b/doc/Apis/RunnerApi.md @@ -27,6 +27,8 @@ All URIs are relative to *http://localhost:8080* Create a new Runner + Create a new runner for executing simulations. Use parentId to create a child runner that inherits configuration from a parent. + ### Parameters |Name | Type | Description | Notes | @@ -54,6 +56,8 @@ Create a new Runner Add a control access to the Runner + Grant access to a runner for a user or group. Valid roles: viewer, editor, validator (can validate runs), admin. + ### Parameters |Name | Type | Description | Notes | @@ -82,6 +86,8 @@ Add a control access to the Runner Delete a runner + Delete a runner. Cannot delete while runs are in progress. Note: Child runners that reference this runner are not deleted automatically. + ### Parameters |Name | Type | Description | Notes | @@ -137,6 +143,8 @@ null (empty response body) Get the details of a runner + Retrieve detailed information about a runner. + ### Parameters |Name | Type | Description | Notes | @@ -274,6 +282,8 @@ Get the Runner security users list List all Runners + Retrieve a paginated list of all runners in a workspace. + ### Parameters |Name | Type | Description | Notes | @@ -302,6 +312,8 @@ List all Runners Start a run with runner parameters + Start a new simulation run using the runner's current configuration. Returns the run Id. The run executes asynchronously - use the run status endpoint to monitor progress + ### Parameters |Name | Type | Description | Notes | @@ -329,6 +341,8 @@ Start a run with runner parameters Stop the last run + Stop the currently executing run for this runner. The stop operation is asynchronous - the run may continue briefly before stopping. + ### Parameters |Name | Type | Description | Notes | diff --git a/doc/Apis/SolutionApi.md b/doc/Apis/SolutionApi.md index ac0dae0a6..d5aaa0fd0 100644 --- a/doc/Apis/SolutionApi.md +++ b/doc/Apis/SolutionApi.md @@ -39,6 +39,8 @@ All URIs are relative to *http://localhost:8080* Create a new solution + Create a new solution with optional run templates and parameter definitions. + ### Parameters |Name | Type | Description | Notes | @@ -65,6 +67,8 @@ Create a new solution Create solution access control + Grant access to a solution for a user or group. + ### Parameters |Name | Type | Description | Notes | @@ -334,6 +338,8 @@ Retrieve a solution run templates Get the details of a solution + Retrieve detailed information about a solution. + ### Parameters |Name | Type | Description | Notes | @@ -571,6 +577,8 @@ List solution security users List all Solutions + Retrieve a paginated list of all solutions in an organization that the user has permission to view. + ### Parameters |Name | Type | Description | Notes | diff --git a/doc/Apis/WorkspaceApi.md b/doc/Apis/WorkspaceApi.md index 4b58c3e6e..97ff6e37f 100644 --- a/doc/Apis/WorkspaceApi.md +++ b/doc/Apis/WorkspaceApi.md @@ -30,6 +30,8 @@ All URIs are relative to *http://localhost:8080* Create a new workspace + Create a new workspace. + ### Parameters |Name | Type | Description | Notes | @@ -56,6 +58,8 @@ Create a new workspace Add a control access to the Workspace + Grant access to a workspace for a user or group. + ### Parameters |Name | Type | Description | Notes | @@ -83,6 +87,8 @@ Add a control access to the Workspace Upload a file for the Workspace + Upload a file to workspace storage. Use 'destination' to specify path, 'overwrite' to replace existing files. + ### Parameters |Name | Type | Description | Notes | @@ -112,6 +118,8 @@ Upload a file for the Workspace Delete a workspace + Permanently delete a workspace. + ### Parameters |Name | Type | Description | Notes | @@ -138,6 +146,8 @@ null (empty response body) Remove the specified access from the given Workspace + Remove a user's access to a workspace. Cannot remove the last administrator. + ### Parameters |Name | Type | Description | Notes | @@ -218,6 +228,8 @@ null (empty response body) Get the details of a workspace + Retrieve detailed information about a workspace. + ### Parameters |Name | Type | Description | Notes | @@ -271,6 +283,8 @@ Get a control access for the Workspace Download the Workspace File specified + Download a specific file from workspace storage. Returns file as binary stream. + ### Parameters |Name | Type | Description | Notes | @@ -403,6 +417,8 @@ Get the Workspace security users list List all Workspaces + Retrieve a paginated list of all workspaces in an organization that the user has permission to view. + ### Parameters |Name | Type | Description | Notes | diff --git a/meta/src/main/openapi/meta.yaml b/meta/src/main/openapi/meta.yaml index 4da1cd2ef..6dd308429 100644 --- a/meta/src/main/openapi/meta.yaml +++ b/meta/src/main/openapi/meta.yaml @@ -17,6 +17,7 @@ paths: operationId: about tags: - meta + description: "Retrieve API version information and build details." summary: Get various information about the API responses: "200": diff --git a/organization/src/main/openapi/organization.yaml b/organization/src/main/openapi/organization.yaml index 1959ff7e2..29df9e7ef 100644 --- a/organization/src/main/openapi/organization.yaml +++ b/organization/src/main/openapi/organization.yaml @@ -18,9 +18,9 @@ paths: operationId: createOrganization tags: - organization + description: "Create a new organization." summary: Create a new organization requestBody: - description: The Organization to create required: true content: application/json: @@ -60,6 +60,7 @@ paths: - $ref: '#/components/parameters/size' tags: - organization + description: "Retrieve a paginated list of all organizations the authenticated user has permission to view. Use 'page' and 'size' query parameters for pagination." summary: List all Organizations responses: "200": @@ -89,6 +90,7 @@ paths: operationId: getOrganization tags: - organization + description: "Retrieve detailed information about an organization." summary: Get the details of an Organization responses: "200": @@ -153,6 +155,7 @@ paths: operationId: deleteOrganization tags: - organization + description: "Permanently delete an organization. This operation cannot be undone." summary: Delete an organization responses: "204": @@ -299,6 +302,7 @@ paths: operationId: createOrganizationAccessControl tags: - organization + description: "Grant access to an organization for a user or group." summary: Add a control access to the Organization requestBody: description: The new Organization security access to add. diff --git a/run/src/main/openapi/run.yaml b/run/src/main/openapi/run.yaml index 41203952b..f15aac7ea 100644 --- a/run/src/main/openapi/run.yaml +++ b/run/src/main/openapi/run.yaml @@ -22,6 +22,7 @@ paths: operationId: getRun tags: - run + description: "Retrieve detailed information about a specific run." summary: Get the details of a run responses: "200": @@ -63,6 +64,7 @@ paths: operationId: getRunStatus tags: - run + description: "Retrieve detailed execution status of a run." summary: get the status for the Run responses: "200": @@ -90,6 +92,7 @@ paths: operationId: getRunLogs tags: - run + description: "Retrieve execution logs for a run as plain text. Logs are aggregated from all containers. May be truncated for long-running simulations." summary: get the logs for the Run responses: "200": @@ -123,6 +126,7 @@ paths: type: integer tags: - run + description: "Retrieve a paginated list of all runs for a specific runner." summary: get the list of Runs for the Runner responses: "200": diff --git a/runner/src/main/openapi/runner.yaml b/runner/src/main/openapi/runner.yaml index f06572fdb..d80562d21 100644 --- a/runner/src/main/openapi/runner.yaml +++ b/runner/src/main/openapi/runner.yaml @@ -20,6 +20,7 @@ paths: operationId: createRunner tags: - runner + description: "Create a new runner for executing simulations. Use parentId to create a child runner that inherits configuration from a parent." summary: Create a new Runner requestBody: description: the Runner to create @@ -66,6 +67,7 @@ paths: - $ref: '#/components/parameters/size' tags: - runner + description: "Retrieve a paginated list of all runners in a workspace." summary: List all Runners responses: "200": @@ -97,6 +99,7 @@ paths: operationId: getRunner tags: - runner + description: "Retrieve detailed information about a runner." summary: Get the details of a runner responses: "200": @@ -161,6 +164,7 @@ paths: operationId: deleteRunner tags: - runner + description: "Delete a runner. Cannot delete while runs are in progress. Note: Child runners that reference this runner are not deleted automatically." summary: Delete a runner responses: "204": @@ -177,6 +181,7 @@ paths: operationId: startRun tags: - runner + description: "Start a new simulation run using the runner's current configuration. Returns the run Id. The run executes asynchronously - use the run status endpoint to monitor progress" summary: Start a run with runner parameters responses: "202": @@ -200,6 +205,7 @@ paths: operationId: stopRun tags: - runner + description: "Stop the currently executing run for this runner. The stop operation is asynchronous - the run may continue briefly before stopping." summary: Stop the last run responses: "202": @@ -333,6 +339,7 @@ paths: operationId: createRunnerAccessControl tags: - runner + description: "Grant access to a runner for a user or group. Valid roles: viewer, editor, validator (can validate runs), admin." summary: Add a control access to the Runner requestBody: description: the new Runner security access to add. diff --git a/solution/src/main/openapi/solution.yaml b/solution/src/main/openapi/solution.yaml index d552937ef..7a2dff023 100644 --- a/solution/src/main/openapi/solution.yaml +++ b/solution/src/main/openapi/solution.yaml @@ -20,6 +20,7 @@ paths: operationId: createSolution tags: - solution + description: "Create a new solution with optional run templates and parameter definitions." summary: Create a new solution requestBody: description: The Solution to create @@ -62,6 +63,7 @@ paths: - $ref: '#/components/parameters/size' tags: - solution + description: "Retrieve a paginated list of all solutions in an organization that the user has permission to view." summary: List all Solutions responses: "200": @@ -92,6 +94,7 @@ paths: operationId: getSolution tags: - solution + description: "Retrieve detailed information about a solution." summary: Get the details of a solution responses: "200": @@ -742,6 +745,7 @@ paths: operationId: createSolutionAccessControl tags: - solution + description: "Grant access to a solution for a user or group." summary: Create solution access control requestBody: description: Access control to create diff --git a/workspace/src/main/openapi/workspace.yaml b/workspace/src/main/openapi/workspace.yaml index f4d5d70c7..97d0faf7c 100644 --- a/workspace/src/main/openapi/workspace.yaml +++ b/workspace/src/main/openapi/workspace.yaml @@ -19,6 +19,7 @@ paths: operationId: createWorkspace tags: - workspace + description: "Create a new workspace." summary: Create a new workspace requestBody: description: The Workspace to create @@ -61,6 +62,7 @@ paths: - $ref: '#/components/parameters/size' tags: - workspace + description: "Retrieve a paginated list of all workspaces in an organization that the user has permission to view." summary: List all Workspaces responses: "200": @@ -90,6 +92,7 @@ paths: operationId: getWorkspace tags: - workspace + description: "Retrieve detailed information about a workspace." summary: Get the details of a workspace responses: "200": @@ -154,6 +157,7 @@ paths: operationId: deleteWorkspace tags: - workspace + description: "Permanently delete a workspace." summary: Delete a workspace responses: "204": @@ -171,6 +175,7 @@ paths: operationId: createWorkspaceFile tags: - workspace + description: "Upload a file to workspace storage. Use 'destination' to specify path, 'overwrite' to replace existing files." summary: Upload a file for the Workspace requestBody: description: The file to upload @@ -275,6 +280,7 @@ paths: operationId: getWorkspaceFile tags: - workspace + description: "Download a specific file from workspace storage. Returns file as binary stream." summary: Download the Workspace File specified responses: "200": @@ -422,6 +428,7 @@ paths: operationId: createWorkspaceAccessControl tags: - workspace + description: "Grant access to a workspace for a user or group." summary: Add a control access to the Workspace requestBody: description: The new Workspace security access to add. @@ -534,6 +541,7 @@ paths: operationId: deleteWorkspaceAccessControl tags: - workspace + description: "Remove a user's access to a workspace. Cannot remove the last administrator." summary: Remove the specified access from the given Workspace responses: "204":