From b848c11725dbbc930178e976cc5a3e5afca4e3dd Mon Sep 17 00:00:00 2001
From: Giuseppe Steduto <giuseppe@steduto.it>
Date: Tue, 18 Jul 2023 15:08:39 +0200
Subject: [PATCH] rest: add run_stopped_at to status endpoint

Closes reanahub/reana-ui#337
---
 CHANGES.rst                    | 1 +
 docs/openapi.json              | 8 ++++++++
 reana_server/rest/workflows.py | 6 ++++++
 3 files changed, 15 insertions(+)

diff --git a/CHANGES.rst b/CHANGES.rst
index f9328f14..f496e635 100644
--- a/CHANGES.rst
+++ b/CHANGES.rst
@@ -5,6 +5,7 @@ Version 0.9.1 (UNRELEASED)
 --------------------------
 
 - Changes OpenAPI specification with respect to return the maximum inactivity time before automatic closure of interactive sessions in ``info`` endpoint.
+- Adds the timestamp of when the workflow was stopped (``run_stopped_at``) to the workflow list and the workflow status endpoints.
 - Adds the content of the ``REANA_GITLAB_HOST`` environment variable to the list of GitLab instances from which it is possible to launch a workflow.
 - Adds new ``prune_workspace`` endpoint to allow users to delete all the files of a workflow, specifying whether to also delete the inputs and/or the outputs.
 - Adds ``interactive-session-cleanup`` command that can be used by REANA administrators to close interactive sessions that are inactive for more than the specified number of days.
diff --git a/docs/openapi.json b/docs/openapi.json
index 3a21dbf9..0cdeec73 100644
--- a/docs/openapi.json
+++ b/docs/openapi.json
@@ -1427,6 +1427,10 @@
                             "type": "string",
                             "x-nullable": true
                           },
+                          "run_stopped_at": {
+                            "type": "string",
+                            "x-nullable": true
+                          },
                           "running": {
                             "properties": {
                               "job_ids": {
@@ -3446,6 +3450,10 @@
                       "type": "string",
                       "x-nullable": true
                     },
+                    "run_stopped_at": {
+                      "type": "string",
+                      "x-nullable": true
+                    },
                     "running": {
                       "properties": {
                         "job_ids": {
diff --git a/reana_server/rest/workflows.py b/reana_server/rest/workflows.py
index 2d4193a2..29da305f 100644
--- a/reana_server/rest/workflows.py
+++ b/reana_server/rest/workflows.py
@@ -211,6 +211,9 @@ def get_workflows(user, **kwargs):  # noqa
                         run_started_at:
                           type: string
                           x-nullable: true
+                        run_stopped_at:
+                          type: string
+                          x-nullable: true
                         running:
                           properties:
                             job_ids:
@@ -986,6 +989,9 @@ def get_workflow_status(workflow_id_or_name, user):  # noqa
                   run_finished_at:
                     type: string
                     x-nullable: true
+                  run_stopped_at:
+                    type: string
+                    x-nullable: true
                   total:
                     type: object
                     properties: