From 84cf82d4ef69880b595bfe16aede6c2bf241fefa Mon Sep 17 00:00:00 2001
From: Ruben Romero Montes <rromerom@redhat.com>
Date: Thu, 2 Jul 2026 03:14:54 +0200
Subject: [PATCH 1/2] feat: add AdvisoryInfo schema to RemediationInfo

Add AdvisoryInfo schema with id (required), title, and url fields
to carry source advisory attribution for each remediation.

Ref: TC-5018

Assisted-by: Claude Code
---
 api/v5/openapi.yaml | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/api/v5/openapi.yaml b/api/v5/openapi.yaml
index 46d859e..f67f10d 100644
--- a/api/v5/openapi.yaml
+++ b/api/v5/openapi.yaml
@@ -580,6 +580,23 @@ components:
         url:
           type: string
           description: URL with more information about the remediation
+        advisory:
+          $ref: '#/components/schemas/AdvisoryInfo'
+    AdvisoryInfo:
+      type: object
+      description: Source advisory attribution for a remediation
+      properties:
+        id:
+          type: string
+          description: Advisory identifier (e.g. RHSA-2024:1234, GHSA-xxxx-xxxx-xxxx)
+        title:
+          type: string
+          description: Advisory title or summary
+        url:
+          type: string
+          description: URL to the full advisory document
+      required:
+        - id
     VersionRange:
       type: object
       description: Affected version range from a vulnerability advisory. Fields present depend on the range type - Full (all fields), Left (scheme and low bound), Right (scheme and high bound), or Unbounded (empty).

From 51f6b6d25213de56a6e90e729c9aab0f163cf335 Mon Sep 17 00:00:00 2001
From: Ruben Romero Montes <rromerom@redhat.com>
Date: Thu, 2 Jul 2026 03:35:11 +0200
Subject: [PATCH 2/2] fix: add format uri to url properties in RemediationInfo
 and AdvisoryInfo

Ref: TC-5018
---
 api/v5/openapi.yaml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/api/v5/openapi.yaml b/api/v5/openapi.yaml
index f67f10d..cc4345a 100644
--- a/api/v5/openapi.yaml
+++ b/api/v5/openapi.yaml
@@ -579,6 +579,7 @@ components:
           description: Human-readable remediation details
         url:
           type: string
+          format: uri
           description: URL with more information about the remediation
         advisory:
           $ref: '#/components/schemas/AdvisoryInfo'
@@ -594,6 +595,7 @@ components:
           description: Advisory title or summary
         url:
           type: string
+          format: uri
           description: URL to the full advisory document
       required:
         - id