{
  "openapi": "3.1.0",
  "info": {
    "title": "vulnpilot-app",
    "description": "",
    "license": {
      "name": ""
    },
    "version": "1.1.0"
  },
  "paths": {
    "/api/v1/action_plans": {
      "get": {
        "tags": [
          "action_plan"
        ],
        "summary": "Lists action plans available to the current user.",
        "description": "Returns action plans from watchlists where the user is a member with read permissions\n(scope.view_watchlist). By default, only action plans created in the current month are listed.\nUse creation_date_from and creation_date_to to override this behavior.\n\nOnly action plans with display=true are returned.",
        "operationId": "list_action_plans",
        "parameters": [
          {
            "name": "search",
            "in": "query",
            "description": "Full-text search on title and descriptions",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "creation_date_from",
            "in": "query",
            "description": "Optional filter by creation date start (ISO 8601). Defaults to start of current month when omitted with creation_date_to.",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "creation_date_to",
            "in": "query",
            "description": "Optional filter by creation date end (ISO 8601). Defaults to end of current month when omitted with creation_date_from.",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Page number (1-indexed). Defaults to 1.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "Number of items per page. Maximum 100. Defaults to 20.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          },
          {
            "name": "processing_status",
            "in": "query",
            "description": "Optional filter by processing status",
            "required": false,
            "schema": {
              "$ref": "#/components/schemas/BulletinProcessingStatus"
            }
          },
          {
            "name": "beescore_max",
            "in": "query",
            "description": "Optional filter by beescore maximum",
            "required": false,
            "schema": {
              "type": "number",
              "format": "double"
            }
          },
          {
            "name": "beescore_min",
            "in": "query",
            "description": "Optional filter by beescore minimum",
            "required": false,
            "schema": {
              "type": "number",
              "format": "double"
            }
          },
          {
            "name": "watchlist_ids",
            "in": "query",
            "description": "Optional filter by watchlist IDs (comma-separated list)",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "order_by",
            "in": "query",
            "description": "Optional field to order by. Defaults to 'updated_at'.",
            "required": false,
            "schema": {
              "$ref": "#/components/schemas/ActionPlanOrderBy"
            }
          },
          {
            "name": "order_direction",
            "in": "query",
            "description": "Optional direction to order by. Defaults to 'desc'.",
            "required": false,
            "schema": {
              "$ref": "#/components/schemas/OrderDirection"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paginated list of action plans matching the criteria",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaginatedResponse_ActionPlanResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid pagination parameters (e.g., page_size > 100)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "429": {
            "description": "API rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred while listing action plans",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/action_plans/cockpit_stats": {
      "get": {
        "tags": [
          "action_plan"
        ],
        "summary": "Returns aggregated statistics on vulnerabilities tied to action plans for the cockpit cards.",
        "description": "Scope is limited to watchlists where the user has `scope.view_watchlist`. Use `watchlist_ids=all` or omit\nthe parameter to include every such watchlist; otherwise pass a comma-separated list of IDs (only IDs the\nuser can view are applied). The period filters linked vulnerabilities by publication date, the same window\nas the monitor list. When `period_from` is omitted, the last 30 days (UTC) are used. `period_to` is an\ninclusive upper bound; omitting it leaves the window open. The vulnerability total counts each action-plan\nlink once, so it matches the monitor list for the same watchlists, dates, and terminal-plan filter.\nAffected products are restricted to watchlist configuration (listed products and products of listed vendors).\nCounts are aggregated in the database. Completed and dismissed action plans are omitted unless\n`include_terminal_action_plans` is true.",
        "operationId": "get_action_plan_cockpit_stats",
        "parameters": [
          {
            "name": "watchlist_ids",
            "in": "query",
            "description": "Comma-separated watchlist IDs, or the literal `all` (case-insensitive) for every watchlist visible to the user.",
            "required": false,
            "schema": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          {
            "name": "period_from",
            "in": "query",
            "description": "Inclusive start of the publication window (ISO 8601). Defaults to the first instant of the last 30 days (UTC) when omitted.",
            "required": false,
            "schema": {
              "type": [
                "string",
                "null"
              ],
              "format": "date-time"
            }
          },
          {
            "name": "period_to",
            "in": "query",
            "description": "Inclusive end of the publication window (ISO 8601). Omitted leaves the window open.",
            "required": false,
            "schema": {
              "type": [
                "string",
                "null"
              ],
              "format": "date-time"
            }
          },
          {
            "name": "include_terminal_action_plans",
            "in": "query",
            "description": "When true, count vulnerabilities whose action plan is completed or dismissed.\nDefaults to false.",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Aggregated statistics for the cockpit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ActionPlanCockpitStatsResponse"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "429": {
            "description": "API rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/action_plans/{action_plan_id}": {
      "get": {
        "tags": [
          "action_plan"
        ],
        "summary": "Gets a specific action plan by ID with detailed vulnerability, product, and vendor information.",
        "description": "The vulnerabilities associated are not included in the response. To load them, see `list_action_plan_vulnerabilities`.\n\nReturns the action plan only if the user has view permission (scope.view_watchlist) on the\nassociated watchlist.",
        "operationId": "get_action_plan",
        "parameters": [
          {
            "name": "action_plan_id",
            "in": "path",
            "description": "The ID of the action plan to retrieve",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The action plan with consolidated product details",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ActionPlanDetailedResponse"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "The action plan was not found or the user does not have view permission",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "429": {
            "description": "API rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      },
      "patch": {
        "tags": [
          "action_plan"
        ],
        "summary": "Partially updates editable action plan content (title, descriptions, tasks, tags).",
        "description": "Requires the organization entitlement `can_edit_action_plans`, same-org membership,\nand `action_plan.can_edit` (org admin or WatchList write). Processing status is not\nmutable here — use `PUT .../processing_status`. Content edits bump `updated_at` for\nnotification eligibility (#294).",
        "operationId": "update_action_plan_content",
        "parameters": [
          {
            "name": "action_plan_id",
            "in": "path",
            "description": "The ID of the action plan to update",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateActionPlanContentRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "The updated action plan",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ActionPlanDetailedResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request body",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "The user is not authorized to edit this action plan",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "The action plan was not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "429": {
            "description": "API rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/action_plans/{action_plan_id}/consents": {
      "get": {
        "tags": [
          "consent"
        ],
        "summary": "Lists consent grants issued for an action plan.",
        "description": "Requires an organization admin or backoffice role. Returns grants for the action plan\nin the authenticated user's organization, including revoked grants. Each entry includes\nthe linked open backoffice task ID when one exists.",
        "operationId": "list_action_plan_consents",
        "parameters": [
          {
            "name": "action_plan_id",
            "in": "path",
            "description": "Action plan ID",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Page number (1-indexed). Defaults to 1.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "Number of items per page. Maximum 100. Defaults to 20.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paginated consent grants for the action plan in the user's organization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaginatedResponse_ActionPlanConsentResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid pagination parameters",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "The user is not an organization admin or backoffice user",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      },
      "post": {
        "tags": [
          "consent"
        ],
        "summary": "Grants Sentibee backoffice access to an action plan.",
        "description": "Requires an organization admin or backoffice role. The action plan must belong to a\nwatchlist in the user's organization. A backoffice assistance task is opened and\nnotification emails are sent to the collaboration team.",
        "operationId": "grant_action_plan_consent",
        "parameters": [
          {
            "name": "action_plan_id",
            "in": "path",
            "description": "Action plan ID",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GrantActionPlanConsentRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "The created action plan consent grant",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ActionPlanConsentResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid duration or organization plan does not support collaboration",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "The user is not an organization admin or backoffice user",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "The action plan was not found in the user's organization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/action_plans/{action_plan_id}/consents/{grant_id}": {
      "delete": {
        "tags": [
          "consent"
        ],
        "summary": "Revokes an action plan consent grant.",
        "description": "Requires an organization admin or backoffice role. Marks the grant as revoked, closes any\nopen backoffice assistance tasks linked to it, and records the action in the audit log.",
        "operationId": "revoke_action_plan_consent",
        "parameters": [
          {
            "name": "action_plan_id",
            "in": "path",
            "description": "Action plan ID",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "grant_id",
            "in": "path",
            "description": "Consent grant ID",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The revoked consent grant",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ActionPlanConsentResponse"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "The user is not an organization admin or backoffice user",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "The consent grant was not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/action_plans/{action_plan_id}/processing_status": {
      "put": {
        "tags": [
          "action_plan"
        ],
        "summary": "Updates the processing status of an action plan.",
        "description": "Requires the user to have view permission (scope.view_watchlist) on the watchlist.\nOnly allowed when the watchlist configuration has \"enable_processing\" set to \"true\".\nProcessing status can be freely changed regardless of the previous status.",
        "operationId": "update_action_plan_processing_status",
        "parameters": [
          {
            "name": "action_plan_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateProcessingStatusRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ActionPlanResponse"
                }
              }
            }
          },
          "429": {
            "description": "API rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/action_plans/{action_plan_id}/processing_status_history": {
      "get": {
        "tags": [
          "action_plan"
        ],
        "summary": "Lists processing-status change history for an action plan (chronological, oldest first).",
        "description": "Requires the user to have view permission on the watchlist (same as status update).",
        "operationId": "list_action_plan_processing_status_history",
        "parameters": [
          {
            "name": "action_plan_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Page number (1-indexed). Defaults to 1.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "Number of items per page. Defaults to 20.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paginated processing status history ordered by changed_at ascending",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaginatedResponse_ActionPlanProcessingStatusHistoryResponse"
                }
              }
            }
          },
          "404": {
            "description": "The action plan was not found or the user does not have view permission",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "429": {
            "description": "API rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/action_plans/{action_plan_id}/vulnerabilities": {
      "get": {
        "tags": [
          "action_plan"
        ],
        "summary": "Lists vulnerabilities of an action plan in a paginated format.",
        "operationId": "list_action_plan_vulnerabilities",
        "parameters": [
          {
            "name": "action_plan_id",
            "in": "path",
            "description": "The ID of the action plan",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Page number (1-indexed). Defaults to 1.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "Number of items per page. Maximum 100. Defaults to 20.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paginated vulnerabilities for the action plan",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaginatedResponse_ActionPlanSheetVulnerabilityDetail"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "The action plan was not found or user has no access",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "429": {
            "description": "API rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/articles/": {
      "get": {
        "tags": [
          "article"
        ],
        "summary": "Lists news articles with pagination, newest publication date first.",
        "description": "Requires the `data.view_basic_data` permission.",
        "operationId": "list_articles",
        "parameters": [
          {
            "name": "title",
            "in": "query",
            "description": "Filter by title substring (case-insensitive)",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "vulnerability_id",
            "in": "query",
            "description": "Filter articles referencing this vulnerability id",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Page number (1-indexed). Defaults to 1.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "Number of items per page. Maximum 100. Defaults to 20.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paginated articles",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaginatedResponse_ArticleResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid query parameters",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "Missing permission",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "429": {
            "description": "API rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "Database error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/articles/{article_id}": {
      "get": {
        "tags": [
          "article"
        ],
        "summary": "Retrieves a single article by id.",
        "description": "Requires the `data.view_basic_data` permission.",
        "operationId": "get_article_by_id",
        "parameters": [
          {
            "name": "article_id",
            "in": "path",
            "description": "Article primary key",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Article found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ArticleResponse"
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "Missing permission",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "429": {
            "description": "API rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "Database error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/dashboard/cards": {
      "get": {
        "tags": [
          "dashboard"
        ],
        "summary": "Number cards with previous-period trends, MTTP quartiles, and deep-link hints.",
        "description": "Metrics are aggregated from materialized views that may lag live writes by a few minutes.",
        "operationId": "get_dashboard_cards",
        "parameters": [
          {
            "name": "period_from",
            "in": "query",
            "description": "Inclusive period start (ISO 8601). Defaults to now − 30 days UTC when omitted with `period_to`.",
            "required": false,
            "schema": {
              "type": [
                "string",
                "null"
              ],
              "format": "date-time"
            }
          },
          {
            "name": "period_to",
            "in": "query",
            "description": "Inclusive period end (ISO 8601). Defaults to now when omitted.",
            "required": false,
            "schema": {
              "type": [
                "string",
                "null"
              ],
              "format": "date-time"
            }
          },
          {
            "name": "watchlist_ids",
            "in": "query",
            "description": "Comma-separated watchlist IDs, or `all` (default) for every watchlist the user can view.",
            "required": false,
            "schema": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          {
            "name": "priority",
            "in": "query",
            "description": "Priority / BeeScore band filter.",
            "required": false,
            "schema": {
              "oneOf": [
                {
                  "type": "null"
                },
                {
                  "$ref": "#/components/schemas/PriorizationLevel"
                }
              ]
            }
          },
          {
            "name": "vendor_ids",
            "in": "query",
            "description": "Comma-separated vendor IDs restricting perimeter product matches.",
            "required": false,
            "schema": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          {
            "name": "processing_status",
            "in": "query",
            "description": "Action-plan processing status filter (`new`, `pending`, `ongoing`, `completed`, `dismissed`).",
            "required": false,
            "schema": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Dashboard number cards",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DashboardCardsResponse"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "429": {
            "description": "API rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/dashboard/distributions": {
      "get": {
        "tags": [
          "dashboard"
        ],
        "summary": "Distributions: most affected vendors, remediation status, BeeScore bands.",
        "operationId": "get_dashboard_distributions",
        "parameters": [
          {
            "name": "period_from",
            "in": "query",
            "description": "Inclusive period start (ISO 8601). Defaults to now − 30 days UTC when omitted with `period_to`.",
            "required": false,
            "schema": {
              "type": [
                "string",
                "null"
              ],
              "format": "date-time"
            }
          },
          {
            "name": "period_to",
            "in": "query",
            "description": "Inclusive period end (ISO 8601). Defaults to now when omitted.",
            "required": false,
            "schema": {
              "type": [
                "string",
                "null"
              ],
              "format": "date-time"
            }
          },
          {
            "name": "watchlist_ids",
            "in": "query",
            "description": "Comma-separated watchlist IDs, or `all` (default) for every watchlist the user can view.",
            "required": false,
            "schema": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          {
            "name": "priority",
            "in": "query",
            "description": "Priority / BeeScore band filter.",
            "required": false,
            "schema": {
              "oneOf": [
                {
                  "type": "null"
                },
                {
                  "$ref": "#/components/schemas/PriorizationLevel"
                }
              ]
            }
          },
          {
            "name": "vendor_ids",
            "in": "query",
            "description": "Comma-separated vendor IDs restricting perimeter product matches.",
            "required": false,
            "schema": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          {
            "name": "processing_status",
            "in": "query",
            "description": "Action-plan processing status filter (`new`, `pending`, `ongoing`, `completed`, `dismissed`).",
            "required": false,
            "schema": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Dashboard distributions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DashboardDistributionsResponse"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "429": {
            "description": "API rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/dashboard/lists/hot_trending": {
      "get": {
        "tags": [
          "dashboard"
        ],
        "summary": "Top hot / trending vulnerabilities on the perimeter with related WatchList titles.",
        "operationId": "get_dashboard_hot_trending",
        "parameters": [
          {
            "name": "period_from",
            "in": "query",
            "description": "Inclusive period start (ISO 8601).",
            "required": false,
            "schema": {
              "type": [
                "string",
                "null"
              ],
              "format": "date-time"
            }
          },
          {
            "name": "period_to",
            "in": "query",
            "description": "Inclusive period end (ISO 8601).",
            "required": false,
            "schema": {
              "type": [
                "string",
                "null"
              ],
              "format": "date-time"
            }
          },
          {
            "name": "watchlist_ids",
            "in": "query",
            "description": "Comma-separated watchlist IDs, or `all`.",
            "required": false,
            "schema": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          {
            "name": "priority",
            "in": "query",
            "description": "Priority / BeeScore band filter.",
            "required": false,
            "schema": {
              "oneOf": [
                {
                  "type": "null"
                },
                {
                  "$ref": "#/components/schemas/PriorizationLevel"
                }
              ]
            }
          },
          {
            "name": "vendor_ids",
            "in": "query",
            "description": "Comma-separated vendor IDs.",
            "required": false,
            "schema": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          {
            "name": "processing_status",
            "in": "query",
            "description": "Action-plan processing status filter.",
            "required": false,
            "schema": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Max items to return (default 10, max 50).",
            "required": false,
            "schema": {
              "type": [
                "integer",
                "null"
              ],
              "format": "int64",
              "minimum": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Hot trending vulnerabilities",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DashboardHotTrendingItemDto"
                  }
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "429": {
            "description": "API rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/dashboard/lists/inactive_watchlists": {
      "get": {
        "tags": [
          "dashboard"
        ],
        "summary": "WatchLists with no displayed action plan released (`created_at`) in the selected period.",
        "operationId": "get_dashboard_inactive_watchlists",
        "parameters": [
          {
            "name": "period_from",
            "in": "query",
            "description": "Inclusive period start (ISO 8601).",
            "required": false,
            "schema": {
              "type": [
                "string",
                "null"
              ],
              "format": "date-time"
            }
          },
          {
            "name": "period_to",
            "in": "query",
            "description": "Inclusive period end (ISO 8601).",
            "required": false,
            "schema": {
              "type": [
                "string",
                "null"
              ],
              "format": "date-time"
            }
          },
          {
            "name": "watchlist_ids",
            "in": "query",
            "description": "Comma-separated watchlist IDs, or `all`.",
            "required": false,
            "schema": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          {
            "name": "priority",
            "in": "query",
            "description": "Priority / BeeScore band filter.",
            "required": false,
            "schema": {
              "oneOf": [
                {
                  "type": "null"
                },
                {
                  "$ref": "#/components/schemas/PriorizationLevel"
                }
              ]
            }
          },
          {
            "name": "vendor_ids",
            "in": "query",
            "description": "Comma-separated vendor IDs.",
            "required": false,
            "schema": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          {
            "name": "processing_status",
            "in": "query",
            "description": "Action-plan processing status filter.",
            "required": false,
            "schema": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Max items to return (default 10, max 50).",
            "required": false,
            "schema": {
              "type": [
                "integer",
                "null"
              ],
              "format": "int64",
              "minimum": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Inactive watchlists",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DashboardInactiveWatchlistDto"
                  }
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "429": {
            "description": "API rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/dashboard/lists/recent_news": {
      "get": {
        "tags": [
          "dashboard"
        ],
        "summary": "Recent news. Personalized plans list articles that touch the caller's watchlists.\nPlans without personalized dashboards list every article in the period.",
        "operationId": "get_dashboard_recent_news",
        "parameters": [
          {
            "name": "period_from",
            "in": "query",
            "description": "Inclusive period start (ISO 8601).",
            "required": false,
            "schema": {
              "type": [
                "string",
                "null"
              ],
              "format": "date-time"
            }
          },
          {
            "name": "period_to",
            "in": "query",
            "description": "Inclusive period end (ISO 8601).",
            "required": false,
            "schema": {
              "type": [
                "string",
                "null"
              ],
              "format": "date-time"
            }
          },
          {
            "name": "watchlist_ids",
            "in": "query",
            "description": "Comma-separated watchlist IDs, or `all`.",
            "required": false,
            "schema": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          {
            "name": "priority",
            "in": "query",
            "description": "Priority / BeeScore band filter.",
            "required": false,
            "schema": {
              "oneOf": [
                {
                  "type": "null"
                },
                {
                  "$ref": "#/components/schemas/PriorizationLevel"
                }
              ]
            }
          },
          {
            "name": "vendor_ids",
            "in": "query",
            "description": "Comma-separated vendor IDs.",
            "required": false,
            "schema": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          {
            "name": "processing_status",
            "in": "query",
            "description": "Action-plan processing status filter.",
            "required": false,
            "schema": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Max items to return (default 10, max 50).",
            "required": false,
            "schema": {
              "type": [
                "integer",
                "null"
              ],
              "format": "int64",
              "minimum": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Recent perimeter news",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/DashboardNewsItemDto"
                  }
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "429": {
            "description": "API rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/dashboard/series": {
      "get": {
        "tags": [
          "dashboard"
        ],
        "summary": "Time series suitable for log-scale charts (day or week buckets).",
        "operationId": "get_dashboard_series",
        "parameters": [
          {
            "name": "period_from",
            "in": "query",
            "description": "Inclusive period start (ISO 8601). Defaults to now − 30 days UTC when omitted with `period_to`.",
            "required": false,
            "schema": {
              "type": [
                "string",
                "null"
              ],
              "format": "date-time"
            }
          },
          {
            "name": "period_to",
            "in": "query",
            "description": "Inclusive period end (ISO 8601). Defaults to now when omitted.",
            "required": false,
            "schema": {
              "type": [
                "string",
                "null"
              ],
              "format": "date-time"
            }
          },
          {
            "name": "watchlist_ids",
            "in": "query",
            "description": "Comma-separated watchlist IDs, or `all` (default) for every watchlist the user can view.",
            "required": false,
            "schema": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          {
            "name": "priority",
            "in": "query",
            "description": "Priority / BeeScore band filter.",
            "required": false,
            "schema": {
              "oneOf": [
                {
                  "type": "null"
                },
                {
                  "$ref": "#/components/schemas/PriorizationLevel"
                }
              ]
            }
          },
          {
            "name": "vendor_ids",
            "in": "query",
            "description": "Comma-separated vendor IDs restricting perimeter product matches.",
            "required": false,
            "schema": {
              "type": [
                "string",
                "null"
              ]
            }
          },
          {
            "name": "processing_status",
            "in": "query",
            "description": "Action-plan processing status filter (`new`, `pending`, `ongoing`, `completed`, `dismissed`).",
            "required": false,
            "schema": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Dashboard time series",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DashboardSeriesResponse"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "429": {
            "description": "API rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/import/watchlist": {
      "get": {
        "tags": [
          "watchlist_import"
        ],
        "summary": "Lists import jobs created by the current user.",
        "description": "Returns jobs from every active watchlist the user can view in their organization, plus\nwatchlists accessible through an active backoffice consent grant. Results are ordered by\ncreation date (newest first) and paginated.",
        "operationId": "list_imports",
        "parameters": [
          {
            "name": "watchlist_id",
            "in": "query",
            "description": "Optional filter by watchlist ID. When omitted, imports from all watchlists the user can view are listed.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Page number (1-indexed). Defaults to 1.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "Items per page. Max 100. Defaults to 20.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Import history for the current user",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaginatedResponse_WatchlistImportJobResponse"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "Watchlist import is not available on this pricing tier",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "Watchlist not found or not accessible",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/import/watchlist/fields": {
      "get": {
        "tags": [
          "watchlist_import"
        ],
        "summary": "Returns column mapping field metadata for the import UI.",
        "description": "Describes each target watchlist field (label and identifier) that file columns can be\nmapped to. Requires a pricing tier that includes watchlist import, or a backoffice role.",
        "operationId": "list_import_fields",
        "responses": {
          "200": {
            "description": "Mapping field metadata",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ImportFieldOptionsResponse"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "Watchlist import is not available on this pricing tier",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/import/watchlist/{watchlist_id}": {
      "post": {
        "tags": [
          "watchlist_import"
        ],
        "summary": "Uploads a file and creates a new watchlist import draft job.",
        "description": "Requires edit permission on the target watchlist. The uploaded file is stored as a draft\nthat expires after seven days unless committed or deleted. An optional\n`mapping_template_id` pre-applies a saved column mapping template owned by the current user.",
        "operationId": "upload_import",
        "parameters": [
          {
            "name": "watchlist_id",
            "in": "path",
            "description": "ID of the watchlist to import into",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "mapping_template_id",
            "in": "query",
            "description": "Optional saved mapping template whose locked columns override auto-suggestions during parse",
            "required": false,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "multipart/form-data": {
              "schema": {
                "$ref": "#/components/schemas/WatchlistImportUploadForm"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Import job created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WatchlistImportJobResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid or empty upload",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "Plan or watchlist edit permission denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "Watchlist or mapping template not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "Failed to store the uploaded file",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/import/watchlist/{watchlist_id}/{job_id}": {
      "get": {
        "tags": [
          "watchlist_import"
        ],
        "summary": "Returns the current status and metadata of a single import job.",
        "description": "Requires view permission on the watchlist. Only jobs created by the authenticated user\nare accessible.",
        "operationId": "get_import",
        "parameters": [
          {
            "name": "watchlist_id",
            "in": "path",
            "description": "ID of the watchlist that owns the import job",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "job_id",
            "in": "path",
            "description": "UUID of the import job (returned by the upload endpoint)",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Import job detail",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WatchlistImportJobResponse"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "Plan or watchlist view permission denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "Watchlist or import job not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      },
      "delete": {
        "tags": [
          "watchlist_import"
        ],
        "summary": "Deletes an import draft and its uploaded file.",
        "description": "Requires edit permission on the watchlist. Cancel any in-progress background work first.\nDraft rows are removed, the stored file is deleted, and the job is marked as cancelled\nwith an immediate expiry.",
        "operationId": "delete_import",
        "parameters": [
          {
            "name": "watchlist_id",
            "in": "path",
            "description": "ID of the watchlist that owns the import job",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "job_id",
            "in": "path",
            "description": "UUID of the import draft job to delete",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Draft deleted"
          },
          "400": {
            "description": "Cancel the job before deleting",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "Plan or watchlist edit permission denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "Watchlist or import job not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/import/watchlist/{watchlist_id}/{job_id}/cancel": {
      "post": {
        "tags": [
          "watchlist_import"
        ],
        "summary": "Cancels a background import job that is still in progress.",
        "description": "Requires edit permission on the watchlist. Only jobs in `queued`, `parsing`, `validating`,\nor `processing` status can be cancelled. Use the delete endpoint to remove a finished\nor cancelled draft.",
        "operationId": "cancel_import",
        "parameters": [
          {
            "name": "watchlist_id",
            "in": "path",
            "description": "ID of the watchlist that owns the import job",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "job_id",
            "in": "path",
            "description": "UUID of the queued or in-progress import job to cancel",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Import job cancelled",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WatchlistImportJobResponse"
                }
              }
            }
          },
          "400": {
            "description": "Job cannot be cancelled in its current status",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "Plan or watchlist edit permission denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "Watchlist or import job not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/import/watchlist/{watchlist_id}/{job_id}/commit": {
      "post": {
        "tags": [
          "watchlist_import"
        ],
        "summary": "Commits validated draft rows into the watchlist.",
        "description": "Requires edit permission on the watchlist. The import must be in `ready` status with a\ncompleted preview (at least one valid or warning row). Commit is preflighted against\norganization watchlist limits before the background job is queued: plan-limit and\nno-valid-rows failures return structured errors while keeping the draft in `ready` so the\nuser can edit and retry. An optional `commit_mode` in the request body selects whether\nimported items are merged into the watchlist or replace existing items of the same type.",
        "operationId": "commit_import",
        "parameters": [
          {
            "name": "watchlist_id",
            "in": "path",
            "description": "ID of the watchlist that owns the import job",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "job_id",
            "in": "path",
            "description": "UUID of the import job to commit into the watchlist",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CommitImportRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Import queued for commit",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WatchlistImportJobResponse"
                }
              }
            }
          },
          "400": {
            "description": "Import is not ready for commit, or plan watchlist item limit would be exceeded (`plan_limit_reached`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "Plan or watchlist edit permission denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "Watchlist or import job not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "422": {
            "description": "No valid rows to import (`import_no_valid_rows`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/import/watchlist/{watchlist_id}/{job_id}/export": {
      "get": {
        "tags": [
          "watchlist_import"
        ],
        "summary": "Downloads a CSV report of draft rows with validation warnings or errors.",
        "description": "Requires view permission on the watchlist. The response is a `text/csv` attachment named\n`import-issues-{job_id}.csv` with columns: row index, product name, vendor name, version,\nvalidation status, and validation messages.",
        "operationId": "export_import_issues",
        "parameters": [
          {
            "name": "watchlist_id",
            "in": "path",
            "description": "ID of the watchlist that owns the import job",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "job_id",
            "in": "path",
            "description": "UUID of the import job to export issue rows from",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "CSV file of draft rows with validation warnings or errors",
            "content": {
              "text/csv": {
                "schema": {
                  "$ref": "#/components/schemas/WatchlistImportIssuesCsvExport"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "Plan or watchlist view permission denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "Watchlist or import job not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/import/watchlist/{watchlist_id}/{job_id}/mappings": {
      "put": {
        "tags": [
          "watchlist_import"
        ],
        "summary": "Updates column-to-field mappings for an import job.",
        "description": "Requires edit permission on the watchlist. Mappings may be edited while the job is `ready`,\nor while `failed` if draft rows were already parsed (reopens to `ready`). Updating mappings\nclears the preview summary and any prior `error_message`; run the preview endpoint before\ncommitting. Optionally saves the mapping as a reusable template (`save_template_name`) or\nlinks an existing template (`mapping_template_id`). The commit mode (`merge` or `replace`)\ncan also be set for the eventual commit step.",
        "operationId": "update_import_mappings",
        "parameters": [
          {
            "name": "watchlist_id",
            "in": "path",
            "description": "ID of the watchlist that owns the import job",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "job_id",
            "in": "path",
            "description": "UUID of the import job to update",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateImportMappingsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Mappings updated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WatchlistImportJobResponse"
                }
              }
            }
          },
          "400": {
            "description": "Import is not in a state that allows mapping edits",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "Plan or watchlist edit permission denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "Watchlist or import job not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/import/watchlist/{watchlist_id}/{job_id}/preview": {
      "post": {
        "tags": [
          "watchlist_import"
        ],
        "summary": "Returns a paginated preview of draft import rows with validation results.",
        "description": "Requires edit permission on the watchlist. The job must be in `ready` (including after a\nrecoverable commit failure). When `revalidate` is true, or when no preview counts exist\nyet, the job is queued for catalog resolution before rows are returned. Poll the job\nstatus via `GET /{job_id}` while validation is in progress.",
        "operationId": "regenerate_import_preview",
        "parameters": [
          {
            "name": "watchlist_id",
            "in": "path",
            "description": "ID of the watchlist that owns the import job",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "job_id",
            "in": "path",
            "description": "UUID of the import job to validate and preview",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Preview page (1-indexed). Defaults to 1.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "Rows per page. Max 100. Defaults to 20.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          },
          {
            "name": "revalidate",
            "in": "query",
            "description": "When true, re-runs catalog resolution. Defaults to false once preview exists.",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Preview page",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WatchlistImportPreviewResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid pagination parameters",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "Plan or watchlist edit permission denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "Watchlist or import job not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/import/watchlist/{watchlist_id}/{job_id}/rows": {
      "patch": {
        "tags": [
          "watchlist_import"
        ],
        "summary": "Applies manual corrections to draft import rows.",
        "description": "Requires edit permission on the watchlist. Rows can only be edited while the job is in\n`ready` status (after parsing and validation complete, including after recoverable commit\nfailures such as plan limits). Supports resolving products and vendors from the catalog,\nupdating versions, marking rows as discarded, and adjusting criticality or exposure.\nReturns the updated rows and refreshed preview summary counts.",
        "operationId": "patch_import_rows",
        "parameters": [
          {
            "name": "watchlist_id",
            "in": "path",
            "description": "ID of the watchlist that owns the import job",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "job_id",
            "in": "path",
            "description": "UUID of the import job whose draft rows are updated",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PatchImportRowsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Rows updated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PatchImportRowsResponse"
                }
              }
            }
          },
          "400": {
            "description": "Import is not in a state that allows row edits",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "Plan or watchlist edit permission denied",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "Watchlist or import job not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/organization": {
      "put": {
        "tags": [
          "organization"
        ],
        "summary": "Updates the properties of the current user's organization.\nRequires the \"organization.edit_properties\" permission.",
        "operationId": "update_organization",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateOrganizationRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "The organization could be updated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OrganizationResponse"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "The user is not authorized to update organizations",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred while updating the organization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/organization/entitlements": {
      "get": {
        "tags": [
          "organization"
        ],
        "summary": "Returns the effective entitlements of the current user's organization.",
        "operationId": "get_organization_entitlements",
        "responses": {
          "200": {
            "description": "Effective entitlements for the current organization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OrganizationEntitlementsResponse"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "The organization was not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred while loading entitlements",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/organization/members": {
      "get": {
        "tags": [
          "organization"
        ],
        "summary": "Lists all members of the current user's organization.\nRequires the \"organization.view_members\" permission.",
        "operationId": "list_organization_members",
        "responses": {
          "200": {
            "description": "The list of organization members",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/OrganizationMemberResponse"
                  }
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "The user is not authorized to view organization members",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred while fetching organization members",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/packages": {
      "get": {
        "tags": [
          "package"
        ],
        "summary": "Lists packages with optional manager, distro, name, and search filters.",
        "description": "Requires the \"data.view_basic_data\" permission. There is no anonymous package API.",
        "operationId": "list_packages",
        "parameters": [
          {
            "name": "search",
            "in": "query",
            "description": "Full-text search on package name, uid, and aliases",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "name",
            "in": "query",
            "description": "Case-insensitive partial match on package name",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "package_manager",
            "in": "query",
            "description": "Package manager slug (apk, dpkg, rpm)",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "distro_family",
            "in": "query",
            "description": "Distro family slug (alpine, debian, ubuntu, rhel)",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "distro_name",
            "in": "query",
            "description": "Case-insensitive partial match on distro display name",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "distro_version",
            "in": "query",
            "description": "Restrict to packages that have a version in this distro release",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "package_ids",
            "in": "query",
            "description": "Filter by package IDs (comma-separated)",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Page number (1-indexed). Defaults to 1.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "Number of items per page. Maximum 100. Defaults to 20.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paginated list of packages",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaginatedResponse_PackageResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid pagination or filter parameters",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "The user is not authorized to view packages",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "429": {
            "description": "API rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/packages/{package_id}": {
      "get": {
        "tags": [
          "package"
        ],
        "summary": "Retrieves a package by ID.",
        "operationId": "get_package_by_id",
        "parameters": [
          {
            "name": "package_id",
            "in": "path",
            "description": "The package ID",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The package",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PackageResponse"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "The user is not authorized to view packages",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "The package was not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "429": {
            "description": "API rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/packages/{package_id}/versions": {
      "get": {
        "tags": [
          "package"
        ],
        "summary": "Lists versions of a package, optionally filtered by distro release stream.",
        "operationId": "list_package_versions",
        "parameters": [
          {
            "name": "package_id",
            "in": "path",
            "description": "The package ID",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "distro_version",
            "in": "query",
            "description": "Optional distro release stream",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Page number (1-indexed). Defaults to 1.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "Number of items per page. Maximum 100. Defaults to 20.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paginated package versions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaginatedResponse_PackageVersionResponse"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "The user is not authorized to view packages",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "The package was not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "429": {
            "description": "API rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/packages/{package_id}/versions/{version_id}/vulnerabilities": {
      "get": {
        "tags": [
          "package"
        ],
        "summary": "Lists vulnerability links (affected / fixed) for a package version.",
        "operationId": "list_package_version_vulnerabilities",
        "parameters": [
          {
            "name": "package_id",
            "in": "path",
            "description": "The package ID",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "version_id",
            "in": "path",
            "description": "The package version ID",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Advisory links for the package version",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/PackageVersionVulnerabilityResponse"
                  }
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "The user is not authorized to view packages",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "The package or version was not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "429": {
            "description": "API rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/shares": {
      "get": {
        "tags": [
          "share"
        ],
        "summary": "Lists share links created by the current user (including expired / revoked).",
        "operationId": "list_share_links",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "description": "Page number (1-indexed). Defaults to 1.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "Number of items per page. Maximum 100. Defaults to 20.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Share links created by the current user",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaginatedResponse_ShareLinkResponse"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "429": {
            "description": "API rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      },
      "post": {
        "tags": [
          "share"
        ],
        "summary": "Creates or reuses an active share link for an object the caller can already read.",
        "operationId": "create_share_link",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateShareLinkRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Created or existing active share link",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ShareLinkResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request (e.g. TTL out of range)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "The user cannot read the object",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "The shared object was not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "429": {
            "description": "API rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/shares/{share_key}": {
      "get": {
        "tags": [
          "share"
        ],
        "summary": "Resolves a share key to the live shared object. No session required; the key is the credential.",
        "operationId": "retrieve_share_link",
        "parameters": [
          {
            "name": "share_key",
            "in": "path",
            "description": "Opaque share key",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Shared object payload",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ShareRetrieveResponse"
                }
              }
            }
          },
          "404": {
            "description": "Unknown, revoked, or expired share key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "429": {
            "description": "API rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "share"
        ],
        "summary": "Soft-revokes a share link owned by the current user.",
        "operationId": "revoke_share_link",
        "parameters": [
          {
            "name": "share_key",
            "in": "path",
            "description": "Opaque share key to revoke",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Revoked share link",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ShareLinkResponse"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "Share link not found or not owned by the caller",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "429": {
            "description": "API rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/user": {
      "get": {
        "tags": [
          "user"
        ],
        "summary": "Retrieves the properties of the current user from the session.",
        "operationId": "get_current_user",
        "responses": {
          "200": {
            "description": "The current user could be retrieved",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserResponse"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/user/api-keys": {
      "get": {
        "tags": [
          "user"
        ],
        "summary": "Lists all API keys for the current user.",
        "description": "Only returns the API key ID and expiration date.",
        "operationId": "list_api_keys",
        "responses": {
          "200": {
            "description": "The API keys could be retrieved",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListApiKeysResponse"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred while retrieving the API keys",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      },
      "post": {
        "tags": [
          "user"
        ],
        "summary": "Creates a new API key for the current user.",
        "operationId": "create_api_key",
        "responses": {
          "200": {
            "description": "The API key could be created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateApiKeyResponse"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "The user is not authorized to create API keys",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred while creating the API key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/user/api-keys/{api_key_id}/revoke": {
      "put": {
        "tags": [
          "user"
        ],
        "summary": "Disable a given API key for the current user.",
        "operationId": "revoke_api_key",
        "parameters": [
          {
            "name": "api_key_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The API key could be disabled"
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "The API key could not be found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred while disabling the API key",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/user/login": {
      "post": {
        "tags": [
          "user"
        ],
        "summary": "Creates a new session for a user using an API key by providing a token to use in the Authorization header of the request.",
        "operationId": "login",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LoginRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "The user could be authenticated from the given API key and secret",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LoginResponse"
                }
              }
            }
          },
          "401": {
            "description": "The API key or secret is invalid",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "The user account is disabled",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/user/logout": {
      "post": {
        "tags": [
          "user"
        ],
        "summary": "Logs out the current user by clearing the session.",
        "operationId": "logout",
        "responses": {
          "200": {
            "description": "The user could be logged out"
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/user/role/{user_id}": {
      "put": {
        "tags": [
          "user"
        ],
        "summary": "Change the role of a given user belonging to the same organization as the current user.",
        "description": "Requires the \"organization.edit_members\" permission.",
        "operationId": "change_user_role",
        "parameters": [
          {
            "name": "user_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ChangeUserRoleRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "The user role could be changed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserResponse"
                }
              }
            }
          },
          "400": {
            "description": "The user role could not be changed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/user/summary": {
      "get": {
        "tags": [
          "user"
        ],
        "summary": "Retrieves the latest generated summary for the current user.",
        "operationId": "get_latest_summary",
        "responses": {
          "200": {
            "description": "The latest summary for the authenticated user",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UserSummaryResponse"
                }
              }
            }
          },
          "204": {
            "description": "No summary is available yet for the authenticated user"
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/vendors": {
      "get": {
        "tags": [
          "vendor"
        ],
        "summary": "Lists vendors with optional search by name or cpe_name.",
        "description": "Results are ordered with featured vendors first, then alphabetically by name.\n\nSupports pagination with page and page_size query parameters.\nMaximum page_size is 100. Default page_size is 20.\n\nRequires the \"data.view_basic_data\" permission.",
        "operationId": "list_vendors",
        "parameters": [
          {
            "name": "name",
            "in": "query",
            "description": "Optional full-text search on vendor name and aliases",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cpe_name",
            "in": "query",
            "description": "Optional filter to search by CPE name",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Page number (1-indexed). Defaults to 1.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "Number of items per page. Maximum 100. Defaults to 20.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          },
          {
            "name": "vendor_ids",
            "in": "query",
            "description": "Filter by vendor IDs (comma-separated list of vendor IDs)",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "tags",
            "in": "query",
            "description": "Filter by tags (comma-separated, OR). Matches any of the tags.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "featured",
            "in": "query",
            "description": "Get only featured vendors",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paginated list of vendors matching the search criteria",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaginatedResponse_VendorResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid pagination parameters (e.g., page_size > 100)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "The user is not authorized to view vendors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "429": {
            "description": "API rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred while listing vendors",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/vendors/products": {
      "get": {
        "tags": [
          "vendor"
        ],
        "summary": "Lists products with optional filtering, sorting, and pagination.",
        "description": "Supports the following filters:\n- `search`: Search in name, aliases, and cpe_names (case-insensitive partial match)\n- `vendor_id`: Filter by vendor ID\n- `tags`: Filter by tags (comma-separated list of tag names)\n- `created_after`/`created_before`: Filter by creation date range\n- `updated_after`/`updated_before`: Filter by last update date range\n\nFeatured products are listed first; within each group, results follow `sort_by` and `sort_order`\n(defaults: name ascending).\n\nSupports pagination with page and page_size query parameters.\nMaximum page_size is 100. Default page_size is 20.\n\nRequires the \"data.view_basic_data\" permission.",
        "operationId": "list_products",
        "parameters": [
          {
            "name": "search",
            "in": "query",
            "description": "Full-text search on product name, aliases, CPE names, descriptions, and vendor name. CPE 2.2/2.3 strings are matched structurally.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cpe",
            "in": "query",
            "description": "Optional CPE 2.2/2.3 string to match catalog products using CPE name matching",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "vendor_id",
            "in": "query",
            "description": "Filter by vendor ID",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "tags",
            "in": "query",
            "description": "Filter by tags (comma-separated), this is an OR condition matching any of the tags",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "featured",
            "in": "query",
            "description": "Get only featured products",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "created_after",
            "in": "query",
            "description": "Filter by minimum creation date (ISO 8601 format)",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "created_before",
            "in": "query",
            "description": "Filter by maximum creation date (ISO 8601 format)",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "updated_after",
            "in": "query",
            "description": "Filter by minimum last update date (ISO 8601 format)",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "updated_before",
            "in": "query",
            "description": "Filter by maximum last update date (ISO 8601 format)",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "sort_by",
            "in": "query",
            "description": "Sort field (name, creation_date, last_update_date). Defaults to name.",
            "required": false,
            "schema": {
              "$ref": "#/components/schemas/ProductSortField"
            }
          },
          {
            "name": "sort_order",
            "in": "query",
            "description": "Sort order (asc, desc). Defaults to asc.",
            "required": false,
            "schema": {
              "$ref": "#/components/schemas/OrderDirection"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Page number (1-indexed). Defaults to 1.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "Number of items per page. Maximum 100. Defaults to 20.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          },
          {
            "name": "product_ids",
            "in": "query",
            "description": "Filter by product IDs (comma-separated list of product IDs)",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paginated list of products matching the search criteria",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaginatedResponse_ProductResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid pagination parameters (e.g., page_size > 100)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "The user is not authorized to view products",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "429": {
            "description": "API rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred while listing products",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/vendors/products/{product_id}": {
      "get": {
        "tags": [
          "vendor"
        ],
        "summary": "Retrieves a specific product by ID with full details.",
        "description": "Returns the product with references, websites, and related products. Catalog versions\nare omitted; list them with `GET /api/v1/vendors/products/{product_id}/versions`.\n\nRequires the \"data.view_basic_data\" permission.",
        "operationId": "get_product_by_id",
        "parameters": [
          {
            "name": "product_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductDetailResponse"
                }
              }
            }
          },
          "401": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "429": {
            "description": "API rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/vendors/products/{product_id}/versions": {
      "get": {
        "tags": [
          "vendor"
        ],
        "summary": "Lists catalog versions of a product.",
        "description": "Versions stay off the product detail payload. Filter with `branch` (the first\nversion component, so `1` matches `1.2.3`) or `version` (the complete version\nnumber, such as `1.2.3`). When both are set, a row matches either value.\n\nRequires the \"data.view_basic_data\" permission.",
        "operationId": "list_product_versions",
        "parameters": [
          {
            "name": "product_id",
            "in": "path",
            "description": "The product ID",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "branch",
            "in": "query",
            "description": "First version component. `1` matches `1.2.3`. A value with no dot, such as `bionic`, matches that exact version value.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "version",
            "in": "query",
            "description": "Exact complete version number. Matches a version value that contains a digit, such as `1.2.3`.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Page number (1-indexed). Defaults to 1.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "Number of items per page. Maximum 100. Defaults to 20.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paginated catalog versions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaginatedResponse_Version"
                }
              }
            }
          },
          "400": {
            "description": "Invalid pagination or filter parameters",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "The user is not authorized to view products",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "The product was not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "429": {
            "description": "API rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred while listing product versions",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/vendors/{vendor_id}": {
      "get": {
        "tags": [
          "vendor"
        ],
        "summary": "Retrieves a specific vendor by ID with full details.",
        "description": "Returns the vendor with all available fields including websites and product count.\n\nRequires the \"data.view_basic_data\" permission.",
        "operationId": "get_vendor_by_id",
        "parameters": [
          {
            "name": "vendor_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VendorDetailResponse"
                }
              }
            }
          },
          "401": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "429": {
            "description": "API rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/vulnerabilities": {
      "get": {
        "tags": [
          "vulnerability"
        ],
        "summary": "Lists all published vulnerabilities with optional filters and ordering.",
        "description": "Unlike the monitor endpoint, this route is not scoped to watchlist action plans.\nSupports pagination with page and page_size query parameters.\nMaximum page_size is 100. Default page_size is 20.",
        "operationId": "list_vulnerabilities",
        "parameters": [
          {
            "name": "beescore_min",
            "in": "query",
            "description": "Optional minimum beescore threshold",
            "required": false,
            "schema": {
              "type": "number",
              "format": "double"
            }
          },
          {
            "name": "beescore_max",
            "in": "query",
            "description": "Optional maximum beescore threshold",
            "required": false,
            "schema": {
              "type": "number",
              "format": "double"
            }
          },
          {
            "name": "cvss_score_min",
            "in": "query",
            "description": "Optional minimum CVSS score threshold",
            "required": false,
            "schema": {
              "type": "number",
              "format": "double"
            }
          },
          {
            "name": "cvss_score_max",
            "in": "query",
            "description": "Optional maximum CVSS score threshold",
            "required": false,
            "schema": {
              "type": "number",
              "format": "double"
            }
          },
          {
            "name": "tags",
            "in": "query",
            "description": "Optional filter by tags (comma-separated, OR). Use `trending` or exploitation_status values; trending matches any trending date.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "Search by STB/CVE/GHSA id (exact) or full-text in title, descriptions, alternative ids, and aliases",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "product_ids",
            "in": "query",
            "description": "Optional filter by product IDs (comma-separated list)",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "vendor_ids",
            "in": "query",
            "description": "Optional filter by vendor IDs (comma-separated list). Combined with product_ids using OR.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "creation_date_from",
            "in": "query",
            "description": "Optional filter by creation date start (ISO 8601 format)",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "creation_date_to",
            "in": "query",
            "description": "Optional filter by creation date end (ISO 8601 format)",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "modification_date_from",
            "in": "query",
            "description": "Optional filter by modification date start (ISO 8601 format)",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "modification_date_to",
            "in": "query",
            "description": "Optional filter by modification date end (ISO 8601 format)",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "published_date_from",
            "in": "query",
            "description": "Optional filter by publication date start (ISO 8601 format)",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "published_date_to",
            "in": "query",
            "description": "Optional filter by publication date end (ISO 8601 format)",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "order_by",
            "in": "query",
            "description": "Order by field: publication date, modification date, creation date, beescore, cvss, or epss. Defaults to publication date.",
            "required": false,
            "schema": {
              "$ref": "#/components/schemas/OrderVulnerabilityResultsBy"
            }
          },
          {
            "name": "order_direction",
            "in": "query",
            "description": "Order direction. Defaults to 'desc'.",
            "required": false,
            "schema": {
              "$ref": "#/components/schemas/OrderDirection"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Page number (1-indexed). Defaults to 1.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "Number of items per page. Maximum 100. Defaults to 20.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paginated list of published vulnerabilities matching the search criteria.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaginatedResponse_VulnerabilityResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid pagination or filter parameters",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "The user is not authorized to view vulnerabilities",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "429": {
            "description": "API rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred while listing vulnerabilities",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/vulnerabilities/monitor": {
      "get": {
        "tags": [
          "vulnerability"
        ],
        "summary": "Monitors vulnerabilities associated with action plans from watchlists the user has access to.",
        "description": "Returns a paginated list of vulnerabilities filtered by date range and optionally by watchlist IDs.\nSupports sorting by beescore (default), publication date, CVSS, or EPSS.",
        "operationId": "monitor",
        "parameters": [
          {
            "name": "start_date",
            "in": "query",
            "description": "Optional filter by publication date start (ISO 8601 format)",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "end_date",
            "in": "query",
            "description": "Optional filter by publication date end (ISO 8601 format)",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "watchlist_ids",
            "in": "query",
            "description": "Optional filter by watchlist IDs (comma-separated list)",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "product_ids",
            "in": "query",
            "description": "Optional filter by product IDs (comma-separated list)",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "vendor_ids",
            "in": "query",
            "description": "Optional filter by vendor IDs (comma-separated list). Combined with product_ids using OR.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "order_by",
            "in": "query",
            "description": "Order by field: beescore, publication date, cvss, or epss. Defaults to beescore.",
            "required": false,
            "schema": {
              "$ref": "#/components/schemas/OrderMonitorResultsBy"
            }
          },
          {
            "name": "order_direction",
            "in": "query",
            "description": "Order direction. Defaults to 'desc'.",
            "required": false,
            "schema": {
              "$ref": "#/components/schemas/OrderDirection"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Page number (1-indexed). Defaults to 1.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "Number of items per page. Maximum 100. Defaults to 20.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          },
          {
            "name": "beescore_min",
            "in": "query",
            "description": "Optional minimum beescore threshold",
            "required": false,
            "schema": {
              "type": "number",
              "format": "double"
            }
          },
          {
            "name": "beescore_max",
            "in": "query",
            "description": "Optional maximum beescore threshold",
            "required": false,
            "schema": {
              "type": "number",
              "format": "double"
            }
          },
          {
            "name": "cvss_score_min",
            "in": "query",
            "description": "Optional minimum CVSS score threshold",
            "required": false,
            "schema": {
              "type": "number",
              "format": "double"
            }
          },
          {
            "name": "cvss_score_max",
            "in": "query",
            "description": "Optional maximum CVSS score threshold",
            "required": false,
            "schema": {
              "type": "number",
              "format": "double"
            }
          },
          {
            "name": "tags",
            "in": "query",
            "description": "Optional filter by tags (comma-separated, OR). Use `trending` or exploitation_status values; trending matches any trending date.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "description": "Optional free-text search in title and vulnerability id",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "include_terminal_action_plans",
            "in": "query",
            "description": "When true, include vulnerabilities whose action plan is completed or dismissed. Defaults to false.",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paginated list of vulnerabilities from action plans",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaginatedResponse_MonitorVulnerabilityResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid pagination or filter parameters",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "The user is not authorized to view vulnerabilities",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "429": {
            "description": "API rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred while fetching monitored vulnerabilities",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/vulnerabilities/{id}": {
      "get": {
        "tags": [
          "vulnerability"
        ],
        "summary": "Gets a vulnerability by ID.",
        "description": "The ID can be either a Sentibee ID (e.g., \"STB-2025-1234\") or an external\ndatabase ID (e.g., \"CVE-2024-12345\", \"GHSA-xxxx-xxxx-xxxx\", or prefixed\n`cve:…` / `ghsa:…`).\n\nWhen `action_plan_id` is provided, the response includes the personalized beescore from that\naction plan's link to this vulnerability (aligned with the monitor view).",
        "operationId": "get_vulnerability_by_id",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "description": "Vulnerability ID: STB-…, CVE-…, GHSA-…, or prefixed cve:/ghsa: form",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "action_plan_id",
            "in": "query",
            "description": "Optional action plan context for personalized beescore",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The vulnerability matching the provided ID",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VulnerabilityDetailedResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid vulnerability ID format",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "The user is not authorized to view vulnerabilities",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "Vulnerability not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "429": {
            "description": "API rate limit exceeded",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred while fetching the vulnerability",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/watchlists": {
      "get": {
        "tags": [
          "watchlist"
        ],
        "summary": "Lists watchlists available to the current user.",
        "description": "Returns watchlists that the user has permission to view:\n- Organization administrators can view all watchlists in their organization\n- Other users can only view watchlists where they are members with the \"scope.view_watchlist\" permission\n\nNote that watchlist configuration is not returned in the response for response size optimization. Load a specific watchlist to get the configuration.",
        "operationId": "list_watchlists",
        "responses": {
          "200": {
            "description": "The list of watchlists available to the user",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/WatchlistResponse"
                  }
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred while listing watchlists",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      },
      "post": {
        "tags": [
          "watchlist"
        ],
        "summary": "Creates a new watchlist for the current user's organization.",
        "description": "Requires the \"organization.edit_scopes\" permission.",
        "operationId": "create_watchlist",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateWatchlistRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "The watchlist was successfully created",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WatchlistDetailResponse"
                }
              }
            }
          },
          "400": {
            "description": "The user's plan limit has been reached",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "The user is not authorized to create watchlists",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred while creating the watchlist",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/watchlists/{watchlist_id}": {
      "get": {
        "tags": [
          "watchlist"
        ],
        "summary": "Retrieves a specific watchlist by ID.",
        "description": "Returns the watchlist with full configuration if the user has permission to view it:\n- Organization administrators can view any watchlist in their organization\n- Other users can only view watchlists where they are members with the \"scope.view_watchlist\" permission",
        "operationId": "get_watchlist",
        "parameters": [
          {
            "name": "watchlist_id",
            "in": "path",
            "description": "The ID of the watchlist to retrieve",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The watchlist was successfully retrieved",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WatchlistDetailResponse"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "The watchlist was not found or the user does not have permission to view it",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred while retrieving the watchlist",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      },
      "put": {
        "tags": [
          "watchlist"
        ],
        "summary": "Updates a watchlist for the current user's organization.",
        "description": "Requires the \"organization.edit_scopes\" permission.\nOnly watchlists belonging to the user's organization can be updated.",
        "operationId": "update_watchlist",
        "parameters": [
          {
            "name": "watchlist_id",
            "in": "path",
            "description": "The ID of the watchlist to update",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateWatchlistRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "The watchlist was successfully updated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WatchlistDetailResponse"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "The user is not authorized to update watchlists",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "The watchlist was not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred while updating the watchlist",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      },
      "delete": {
        "tags": [
          "watchlist"
        ],
        "summary": "Deletes a watchlist from the current user's organization.",
        "description": "Requires the \"organization.edit_scopes\" permission.\nOnly watchlists belonging to the user's organization can be deleted.",
        "operationId": "delete_watchlist",
        "parameters": [
          {
            "name": "watchlist_id",
            "in": "path",
            "description": "The ID of the watchlist to delete",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The watchlist was successfully deleted"
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "The user is not authorized to delete watchlists",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "The watchlist was not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred while deleting the watchlist",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/watchlists/{watchlist_id}/consent": {
      "post": {
        "tags": [
          "consent"
        ],
        "summary": "Grants Sentibee backoffice access to a watchlist.",
        "description": "Requires an organization admin or backoffice role. Any previously active grant for the same\nwatchlist is revoked before the new one is created. A backoffice assistance task is\nopened and notification emails are sent to the collaboration team.",
        "operationId": "grant_watchlist_consent",
        "parameters": [
          {
            "name": "watchlist_id",
            "in": "path",
            "description": "Watchlist ID",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GrantConsentRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "The created watchlist consent grant",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WatchlistConsentResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid duration or organization plan does not support collaboration",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "The user is not an organization admin or backoffice user",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "The watchlist was not found in the user's organization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/watchlists/{watchlist_id}/consent/{grant_id}": {
      "delete": {
        "tags": [
          "consent"
        ],
        "summary": "Revokes a watchlist consent grant.",
        "description": "Requires an organization admin or backoffice role. Marks the grant as revoked, closes any\nopen backoffice assistance tasks linked to it, and records the action in the audit log.",
        "operationId": "revoke_watchlist_consent",
        "parameters": [
          {
            "name": "watchlist_id",
            "in": "path",
            "description": "Watchlist ID",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "grant_id",
            "in": "path",
            "description": "Consent grant ID",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The revoked consent grant",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WatchlistConsentResponse"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "The user is not an organization admin or backoffice user",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "The consent grant was not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/watchlists/{watchlist_id}/consents": {
      "get": {
        "tags": [
          "consent"
        ],
        "summary": "Lists consent grants issued for a watchlist.",
        "description": "Requires an organization admin or backoffice role. Returns grants for the watchlist\nbelonging to the authenticated user's organization, including revoked grants. Each entry\nincludes the linked open backoffice task ID when one exists.",
        "operationId": "list_watchlist_consents",
        "parameters": [
          {
            "name": "watchlist_id",
            "in": "path",
            "description": "Watchlist ID",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "page",
            "in": "query",
            "description": "Page number (1-indexed). Defaults to 1.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "description": "Number of items per page. Maximum 100. Defaults to 20.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "minimum": 0
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paginated consent grants for the watchlist in the user's organization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PaginatedResponse_WatchlistConsentResponse"
                }
              }
            }
          },
          "400": {
            "description": "Invalid pagination parameters",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "The user is not an organization admin or backoffice user",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/watchlists/{watchlist_id}/enable": {
      "post": {
        "tags": [
          "watchlist"
        ],
        "summary": "Enables a watchlist for the current user's organization.",
        "description": "Requires the \"organization.edit_scopes\" permission and that the organization's plan\nis not expired. Enabling fails when the organization is already at `max_scopes`, or\nwhen this watchlist would grow the organization's products, packages, or vendors past\ntheir caps. Those caps count distinct catalog ids across every active watchlist.",
        "operationId": "enable_watchlist",
        "parameters": [
          {
            "name": "watchlist_id",
            "in": "path",
            "description": "The ID of the watchlist to enable",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The watchlist was successfully enabled",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WatchlistDetailResponse"
                }
              }
            }
          },
          "400": {
            "description": "The organization's plan has expired, or enabling this watchlist would exceed the watchlist, product, package, or vendor quota",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "The user is not authorized to enable watchlists",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "The watchlist was not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred while enabling the watchlist",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/watchlists/{watchlist_id}/items": {
      "post": {
        "tags": [
          "watchlist"
        ],
        "summary": "Adds a new watchlist item to a watchlist.",
        "description": "Requires the \"scope.edit_watchlist\" permission or organization admin role.\nOnly watchlists belonging to the user's organization can be modified.",
        "operationId": "add_watchlist_item",
        "parameters": [
          {
            "name": "watchlist_id",
            "in": "path",
            "description": "The ID of the watchlist to add the item to",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AddWatchlistItemsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "The watchlist item was successfully added",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WatchlistDetailResponse"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "The user is not authorized to edit watchlists",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "The watchlist was not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred while adding the watchlist item",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      },
      "delete": {
        "tags": [
          "watchlist"
        ],
        "summary": "Removes a watchlist item from a watchlist.",
        "description": "Requires the \"scope.edit_watchlist\" permission or organization admin role.\nOnly watchlists belonging to the user's organization can be modified.",
        "operationId": "remove_watchlist_item",
        "parameters": [
          {
            "name": "watchlist_id",
            "in": "path",
            "description": "The ID of the watchlist to remove the item from",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AddWatchlistItemsRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "The watchlist item was successfully removed",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WatchlistDetailResponse"
                }
              }
            }
          },
          "400": {
            "description": "None of the specified items were not found in the watchlist",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "The user is not authorized to edit watchlists",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "The watchlist was not found or the item was not found in the watchlist",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred while removing the watchlist item",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/watchlists/{watchlist_id}/members": {
      "get": {
        "tags": [
          "watchlist"
        ],
        "summary": "Retrieves the list of members for a given watchlist.",
        "description": "Returns all users who are members of the specified watchlist, including their\nuser ID, first name, last name, and role within the watchlist.",
        "operationId": "get_watchlist_members",
        "parameters": [
          {
            "name": "watchlist_id",
            "in": "path",
            "description": "The ID of the watchlist whose members should be listed",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The list of members for the watchlist",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/WatchlistMemberResponse"
                  }
                }
              }
            }
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "The watchlist was not found or the user does not have permission to view it",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred while retrieving the members of the watchlist",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/api/v1/watchlists/{watchlist_id}/members/{user_id}": {
      "put": {
        "tags": [
          "watchlist"
        ],
        "summary": "Changes the role of a user on the selected watchlist.",
        "description": "Requires the user to be an organization administrator.\nOnly users from the administrator's organization can have their role changed.\nThe user must already be a member of the watchlist.",
        "operationId": "change_user_role_on_watchlist",
        "parameters": [
          {
            "name": "watchlist_id",
            "in": "path",
            "description": "The ID of the watchlist",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "user_id",
            "in": "path",
            "description": "The ID of the user whose role should be changed",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ChangeUserRoleOnWatchlistRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "The user's role was successfully changed on the watchlist"
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "The user is not authorized to change roles on this watchlist",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "The watchlist, user, or watchlist member was not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred while changing the user's role on the watchlist",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      },
      "post": {
        "tags": [
          "watchlist"
        ],
        "summary": "Adds a user belonging to the current organization to the selected watchlist.",
        "description": "Requires the user to be an organization administrator.\nOnly users from the administrator's organization can be added to a watchlist.",
        "operationId": "add_user_to_watchlist",
        "parameters": [
          {
            "name": "watchlist_id",
            "in": "path",
            "description": "The ID of the watchlist",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "user_id",
            "in": "path",
            "description": "The ID of the user to add to the watchlist",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AddUserToWatchlistRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "The user was successfully added to the watchlist"
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "The user is not authorized to add members to this watchlist, or the user does not belong to the same organization",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "The watchlist or user was not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred while adding the user to the watchlist",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      },
      "delete": {
        "tags": [
          "watchlist"
        ],
        "summary": "Removes a user from the selected watchlist.",
        "description": "Requires the user to be an organization administrator.\nOnly users from the administrator's organization can be removed.\nThe user must be a member of the watchlist.",
        "operationId": "remove_user_from_watchlist",
        "parameters": [
          {
            "name": "watchlist_id",
            "in": "path",
            "description": "The ID of the watchlist",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "user_id",
            "in": "path",
            "description": "The ID of the user to remove from the watchlist",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The user was successfully removed from the watchlist"
          },
          "401": {
            "description": "The user is not authenticated",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "403": {
            "description": "The user is not authorized to remove members from this watchlist",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "404": {
            "description": "The watchlist, user, or watchlist member was not found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          },
          "500": {
            "description": "An unexpected error occurred while removing the user from the watchlist",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorMessage"
                }
              }
            }
          }
        },
        "security": [
          {
            "http": []
          }
        ]
      }
    },
    "/billing": {
      "get": {
        "tags": [
          "billing"
        ],
        "summary": "Redirects a billing admin to Stripe Checkout or back to the pricing page.",
        "operationId": "billing_checkout",
        "parameters": [
          {
            "name": "offering",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "quantity",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32",
              "minimum": 0
            }
          },
          {
            "name": "grant",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "302": {
            "description": "Redirect to Stripe Checkout, or to the app pricing page when checkout fails"
          },
          "303": {
            "description": "Redirect to the app pricing page"
          }
        }
      }
    },
    "/billing/cancel": {
      "get": {
        "tags": [
          "billing"
        ],
        "summary": "Verifies the Stripe cancel state and redirects to the app pricing page.",
        "operationId": "billing_cancel",
        "parameters": [
          {
            "name": "exp",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "sig",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "kind",
            "in": "query",
            "description": "Display hint: `payment` or `subscription`. Not part of the signature.",
            "required": false,
            "schema": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        ],
        "responses": {
          "302": {
            "description": "Redirect to the app pricing page, including when the cancel state is invalid"
          }
        }
      }
    },
    "/billing/return": {
      "get": {
        "tags": [
          "billing"
        ],
        "summary": "Verifies the Stripe success state and redirects to the app return page.",
        "operationId": "billing_return",
        "parameters": [
          {
            "name": "exp",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "sig",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "kind",
            "in": "query",
            "description": "Display hint: `payment` or `subscription`. Not part of the signature.",
            "required": false,
            "schema": {
              "type": [
                "string",
                "null"
              ]
            }
          }
        ],
        "responses": {
          "302": {
            "description": "Redirect to the app billing return page, or to the pricing page when the return state is invalid"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "ActionPlanCockpitStatsQuery": {
        "type": "object",
        "description": "Query parameters for cockpit statistics over action-plan vulnerabilities.",
        "properties": {
          "include_terminal_action_plans": {
            "type": "boolean",
            "description": "When true, count vulnerabilities whose action plan is completed or dismissed.\nDefaults to false."
          },
          "period_from": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Inclusive start of the publication window (ISO 8601). Defaults to the first instant of the last 30 days (UTC) when omitted."
          },
          "period_to": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Inclusive end of the publication window (ISO 8601). Omitted leaves the window open."
          },
          "watchlist_ids": {
            "type": [
              "string",
              "null"
            ],
            "description": "Comma-separated watchlist IDs, or the literal `all` (case-insensitive) for every watchlist visible to the user."
          }
        }
      },
      "ActionPlanCockpitStatsResponse": {
        "type": "object",
        "description": "Aggregated vulnerability statistics for the cockpit, scoped to action plans the user can see.",
        "required": [
          "total_vulnerabilities",
          "exploited_vulnerabilities",
          "affected_products",
          "high_beescore_vulnerabilities"
        ],
        "properties": {
          "affected_products": {
            "type": "integer",
            "format": "int64",
            "description": "Distinct products on vulnerability specifications that are also in the watchlist scope (explicit product entries plus all products for listed vendors).",
            "minimum": 0
          },
          "exploited_vulnerabilities": {
            "type": "integer",
            "format": "int64",
            "description": "Links in that same set whose vulnerability is tagged as actively exploited, proof-of-concept, or known exploited.",
            "minimum": 0
          },
          "high_beescore_vulnerabilities": {
            "type": "integer",
            "format": "int64",
            "description": "Links in that same set whose personalized beescore is at least the high band threshold (4.5).",
            "minimum": 0
          },
          "total_vulnerabilities": {
            "type": "integer",
            "format": "int64",
            "description": "Action-plan vulnerability links whose publication date is in the selected window.\nThis is the same row count as the monitor list for the same watchlists, dates, and terminal-plan filter.",
            "minimum": 0
          }
        }
      },
      "ActionPlanConsentPermission": {
        "type": "string",
        "description": "Permissions a customer can grant for action plan assistance.",
        "enum": [
          "view",
          "edit",
          "comment"
        ]
      },
      "ActionPlanConsentResponse": {
        "type": "object",
        "description": "An action plan consent grant returned to the customer organization.",
        "required": [
          "id",
          "action_plan_id",
          "watchlist_id",
          "organization_id",
          "permissions",
          "duration_days",
          "expires_at",
          "created_at"
        ],
        "properties": {
          "action_plan_id": {
            "type": "integer",
            "format": "int64",
            "description": "Action plan the grant applies to."
          },
          "backoffice_task_id": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Open backoffice assistance task linked to this grant, if any."
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "UTC timestamp when the grant was created."
          },
          "duration_days": {
            "type": "integer",
            "format": "int32",
            "description": "Requested duration in days (7, 14, or 30)."
          },
          "expires_at": {
            "type": "string",
            "format": "date-time",
            "description": "UTC timestamp when the grant expires."
          },
          "id": {
            "type": "integer",
            "format": "int64",
            "description": "Unique identifier of the consent grant."
          },
          "organization_id": {
            "type": "integer",
            "format": "int32",
            "description": "Customer organization that issued the grant."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ActionPlanConsentPermission"
            },
            "description": "Permissions granted to the backoffice team."
          },
          "reason": {
            "type": [
              "string",
              "null"
            ],
            "description": "Optional reason provided by the customer."
          },
          "revoked_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "UTC timestamp when the grant was revoked, if applicable."
          },
          "watchlist_id": {
            "type": "integer",
            "format": "int32",
            "description": "Parent watchlist of the action plan."
          }
        }
      },
      "ActionPlanDetailedResponse": {
        "type": "object",
        "description": "Represents an action plan in detailed API response with consolidated products.",
        "required": [
          "id",
          "watchlist_id",
          "title",
          "descriptions",
          "tasks",
          "tags",
          "created_at",
          "updated_at",
          "products",
          "packages",
          "can_edit",
          "origin"
        ],
        "properties": {
          "beescore": {
            "type": [
              "number",
              "null"
            ],
            "format": "double",
            "description": "Maximum beescore among linked vulnerabilities"
          },
          "can_edit": {
            "type": "boolean",
            "description": "Whether the current user may edit this action plan's content.\n\nTrue when the org has the edit entitlement, the user is in the same org,\nand they have `action_plan.can_edit` (org admin or WatchList write)."
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "Creation date of the action plan"
          },
          "descriptions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MultilingualDescription"
            },
            "description": "Descriptions of the action plan"
          },
          "id": {
            "type": "integer",
            "format": "int64",
            "description": "Unique identifier of the action plan"
          },
          "origin": {
            "$ref": "#/components/schemas/ActionPlanOrigin",
            "description": "Whether the plan was created by matching or by a backoffice user."
          },
          "packages": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ActionPlanPackageDetail"
            },
            "description": "Consolidated packages with persisted affected and fixed versions"
          },
          "processing_status": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/BulletinProcessingStatus",
                "description": "Processing status of the action plan"
              }
            ]
          },
          "products": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ActionPlanProductDetail"
            },
            "description": "Consolidated products affected across all linked vulnerabilities"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Tags of the action plan"
          },
          "tasks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ActionPlanTask"
            },
            "description": "Tasks proposed for the action plan"
          },
          "title": {
            "type": "string",
            "description": "Title of the action plan"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "description": "Last update date of the action plan"
          },
          "watchlist_id": {
            "type": "integer",
            "format": "int32",
            "description": "ID of the watchlist this action plan belongs to"
          }
        }
      },
      "ActionPlanOrderBy": {
        "type": "string",
        "enum": [
          "UpdatedAt",
          "CreatedAt"
        ]
      },
      "ActionPlanOrigin": {
        "type": "string",
        "description": "How an action plan was created.",
        "enum": [
          "matching",
          "manual"
        ]
      },
      "ActionPlanPackageDetail": {
        "type": "object",
        "description": "Package association on an action plan with persisted affected and fixed versions.",
        "required": [
          "id",
          "name",
          "package_manager",
          "distro_family",
          "distro_name",
          "matched",
          "affected_versions",
          "fixed_versions",
          "wont_fix_versions",
          "not_affected_versions",
          "deferred_versions"
        ],
        "properties": {
          "affected_versions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "deferred_versions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "distro_family": {
            "type": "string"
          },
          "distro_name": {
            "type": "string"
          },
          "distro_version": {
            "type": [
              "string",
              "null"
            ]
          },
          "fixed_versions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "id": {
            "type": "integer",
            "format": "int32"
          },
          "matched": {
            "type": "boolean"
          },
          "name": {
            "type": "string"
          },
          "not_affected_versions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "package_manager": {
            "type": "string"
          },
          "wont_fix_versions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "ActionPlanProcessingStatusHistoryResponse": {
        "type": "object",
        "description": "One processing-status transition for an action plan.",
        "required": [
          "id",
          "action_plan_id",
          "changed_at"
        ],
        "properties": {
          "action_plan_id": {
            "type": "integer",
            "format": "int64"
          },
          "change_reason": {
            "type": [
              "string",
              "null"
            ]
          },
          "changed_at": {
            "type": "string",
            "format": "date-time"
          },
          "changed_by_user_id": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32"
          },
          "from_status": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/BulletinProcessingStatus"
              }
            ]
          },
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "to_status": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/BulletinProcessingStatus"
              }
            ]
          }
        }
      },
      "ActionPlanProductDetail": {
        "type": "object",
        "description": "Represents a product in an action plan (detailed view).",
        "required": [
          "id",
          "name",
          "vendor_id",
          "vendor_name",
          "matched",
          "versions",
          "affected_status"
        ],
        "properties": {
          "affected_status": {
            "$ref": "#/components/schemas/ProductStatus",
            "description": "Affected status of the product"
          },
          "id": {
            "type": "integer",
            "format": "int32",
            "description": "Product ID"
          },
          "matched": {
            "type": "boolean",
            "description": "Did this product match the watchlist?"
          },
          "name": {
            "type": "string",
            "description": "Name of the product"
          },
          "vendor_id": {
            "type": "integer",
            "format": "int32",
            "description": "Vendor ID"
          },
          "vendor_name": {
            "type": "string",
            "description": "Vendor name"
          },
          "versions": {
            "$ref": "#/components/schemas/AffectedVersions",
            "description": "Versions of the product"
          }
        }
      },
      "ActionPlanResponse": {
        "type": "object",
        "description": "Represents an action plan in the API response (summary view for listings).",
        "required": [
          "id",
          "watchlist_id",
          "title",
          "descriptions",
          "created_at",
          "updated_at",
          "origin"
        ],
        "properties": {
          "beescore": {
            "type": [
              "number",
              "null"
            ],
            "format": "float"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "Creation date of the action plan"
          },
          "descriptions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MultilingualDescription"
            },
            "description": "Descriptions of the action plan"
          },
          "id": {
            "type": "integer",
            "format": "int64",
            "description": "Unique identifier of the action plan"
          },
          "origin": {
            "$ref": "#/components/schemas/ActionPlanOrigin",
            "description": "Whether the plan was created by matching or by a backoffice user."
          },
          "processing_status": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/BulletinProcessingStatus",
                "description": "Processing status of the action plan"
              }
            ]
          },
          "title": {
            "type": "string",
            "description": "Title of the action plan"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "description": "Last update date of the action plan"
          },
          "watchlist_id": {
            "type": "integer",
            "format": "int32",
            "description": "ID of the watchlist this action plan belongs to"
          }
        }
      },
      "ActionPlanSheetVulnerabilityDetail": {
        "type": "object",
        "description": "Paginated response for action plan vulnerabilities.\nRepresents a vulnerability row for action plan sheet display.",
        "required": [
          "vulnerability_id",
          "title",
          "alternative_ids",
          "descriptions"
        ],
        "properties": {
          "alternative_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Alternative IDs of the vulnerability"
          },
          "beescore": {
            "type": [
              "number",
              "null"
            ],
            "format": "double",
            "description": "Beescore (personalized prioritization score) for this vulnerability in the action plan context"
          },
          "descriptions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MultilingualDescription"
            },
            "description": "Most relevant summary description only (single item at most)"
          },
          "timeline_data": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/VulnerabilityTimelineItem"
            },
            "description": "Timeline of the vulnerability"
          },
          "title": {
            "type": "string",
            "description": "Title of the vulnerability"
          },
          "vulnerability_id": {
            "type": "string",
            "description": "Sentibee vulnerability ID"
          }
        }
      },
      "ActionPlanTask": {
        "type": "object",
        "description": "Represents a task in an action plan.",
        "required": [
          "description",
          "validated"
        ],
        "properties": {
          "description": {
            "$ref": "#/components/schemas/MultilingualDescription",
            "description": "The task description."
          },
          "status": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/ActionPlanTaskStatus",
                "description": "Optional workflow status (defaults to todo when absent)."
              }
            ]
          },
          "validated": {
            "type": "boolean",
            "description": "Whether the task has been validated."
          }
        }
      },
      "ActionPlanTaskStatus": {
        "type": "string",
        "description": "Task status for customer-facing action plan items.",
        "enum": [
          "todo",
          "in_progress",
          "done"
        ]
      },
      "ActionPlanVulnerabilityDetail": {
        "type": "object",
        "description": "Represents a vulnerability in an action plan (detailed view).",
        "required": [
          "vulnerability_id",
          "title",
          "alternative_ids",
          "descriptions",
          "products",
          "tags",
          "refs"
        ],
        "properties": {
          "alternative_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Alternative IDs of the vulnerability"
          },
          "beescore": {
            "type": [
              "number",
              "null"
            ],
            "format": "double",
            "description": "Beescore (personalized prioritization score) for this vulnerability in the action plan context"
          },
          "cvss_score": {
            "type": [
              "number",
              "null"
            ],
            "format": "double",
            "description": "CVSS score from the personalized score"
          },
          "cvss_vector": {
            "type": [
              "string",
              "null"
            ],
            "description": "CVSS vector from the personalized score"
          },
          "descriptions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MultilingualDescription"
            },
            "description": "Descriptions of the vulnerability (multilingual)"
          },
          "epss_score": {
            "type": [
              "number",
              "null"
            ],
            "format": "float",
            "description": "EPSS score from the personalized score"
          },
          "products": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ActionPlanProductDetail"
            },
            "description": "Names of products affected by this vulnerability"
          },
          "refs": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Reference"
            },
            "description": "References of the vulnerability"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Tags of the vulnerability"
          },
          "timeline_data": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/VulnerabilityTimelineItem"
            },
            "description": "Timeline of the vulnerability"
          },
          "title": {
            "type": "string",
            "description": "Title of the vulnerability"
          },
          "vulnerability_id": {
            "type": "string",
            "description": "Sentibee vulnerability ID"
          }
        }
      },
      "AddUserToWatchlistRequest": {
        "type": "object",
        "description": "Represents the request to add a user to a watchlist.",
        "required": [
          "role"
        ],
        "properties": {
          "role": {
            "$ref": "#/components/schemas/ScopeUserRole",
            "description": "Role to grant to the user in the watchlist"
          }
        }
      },
      "AddWatchlistItemsRequest": {
        "type": "object",
        "description": "Represents the request to add or remove watchlist items.",
        "required": [
          "items"
        ],
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/WatchlistItemRequest"
            },
            "description": "The watchlist item to add or remove (without creation date)"
          }
        }
      },
      "AffectedVersionRange": {
        "type": "object",
        "description": "A single affected version range for a product (min/max bounds and/or a discrete list).",
        "properties": {
          "max_exclusive": {
            "type": "boolean",
            "description": "When true, `max_version` is an exclusive upper bound (`< max`)."
          },
          "max_version": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/Version",
                "description": "The maximum version of the product (inclusive unless `max_exclusive`)."
              }
            ]
          },
          "min_exclusive": {
            "type": "boolean",
            "description": "When true, `min_version` is an exclusive lower bound (`> min`)."
          },
          "min_version": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/Version",
                "description": "The minimum version of the product (inclusive unless `min_exclusive`)."
              }
            ]
          },
          "version_list": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/Version"
            },
            "description": "The list of versions of the product, in case a range is not provided."
          }
        }
      },
      "AffectedVersions": {
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/AffectedVersionRange"
        },
        "description": "Represents the affected versions of a product for a vulnerability as one or more ranges."
      },
      "ApiKeyListItem": {
        "type": "object",
        "description": "Represents an API key in the list response, containing only the ID and expiration date.",
        "required": [
          "id",
          "expiration_date"
        ],
        "properties": {
          "expiration_date": {
            "type": "string",
            "format": "date-time"
          },
          "id": {
            "type": "string",
            "format": "uuid"
          }
        }
      },
      "ArticleResponse": {
        "type": "object",
        "description": "Single article returned by the public API.",
        "required": [
          "id",
          "title",
          "short_description",
          "source_link",
          "vulnerability_ids",
          "tags",
          "publication_date"
        ],
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "publication_date": {
            "type": "string",
            "format": "date-time"
          },
          "short_description": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MultilingualDescription"
            }
          },
          "source_id": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Linked article source. Null when the article is not attached to a source."
          },
          "source_link": {
            "type": "string"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "title": {
            "type": "string"
          },
          "vulnerability_ids": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "Beescore": {
        "type": "object",
        "description": "The BEESCORE score for a vulnerability/product couple.",
        "required": [
          "beescore",
          "beescore_priorization_level",
          "cvss_score",
          "cvss_vector"
        ],
        "properties": {
          "beescore": {
            "type": "number",
            "format": "double",
            "description": "The BEESCORE score"
          },
          "beescore_priorization_level": {
            "$ref": "#/components/schemas/PriorizationLevel",
            "description": "The priorization level of the BEESCORE score"
          },
          "cvss_score": {
            "type": "number",
            "format": "double",
            "description": "The CVSS score"
          },
          "cvss_vector": {
            "type": "string",
            "description": "The CVSS vector"
          },
          "epss_score": {
            "type": [
              "number",
              "null"
            ],
            "format": "float",
            "description": "The EPSS score"
          }
        }
      },
      "BulletinProcessingStatus": {
        "type": "string",
        "description": "Processing status of an action plan bulletin.",
        "enum": [
          "new",
          "pending",
          "ongoing",
          "completed",
          "dismissed"
        ]
      },
      "ChangeUserRoleOnWatchlistRequest": {
        "type": "object",
        "description": "Represents the request to change a user's role on a watchlist.",
        "required": [
          "role"
        ],
        "properties": {
          "role": {
            "$ref": "#/components/schemas/ScopeUserRole",
            "description": "New role to assign to the user in the watchlist"
          }
        }
      },
      "ChangeUserRoleRequest": {
        "type": "object",
        "description": "Represents the request to change the role of a user.",
        "required": [
          "new_role"
        ],
        "properties": {
          "new_role": {
            "$ref": "#/components/schemas/UserRoleForChange"
          }
        }
      },
      "CommitImportRequest": {
        "type": "object",
        "properties": {
          "commit_mode": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/WatchlistImportCommitMode"
              }
            ]
          }
        }
      },
      "CreateApiKeyResponse": {
        "type": "object",
        "description": "Represents the response to create a new API key, containing the API key secret and the API key ID.",
        "required": [
          "api_secret",
          "api_key_id"
        ],
        "properties": {
          "api_key_id": {
            "type": "string",
            "format": "uuid"
          },
          "api_secret": {
            "type": "string"
          }
        }
      },
      "CreateShareLinkRequest": {
        "type": "object",
        "description": "Request body for creating (or reusing) a share link.",
        "required": [
          "object_type",
          "object_id"
        ],
        "properties": {
          "object_id": {
            "type": "string",
            "description": "STB id for vulnerabilities, numeric action-plan id for action plans."
          },
          "object_type": {
            "$ref": "#/components/schemas/ShareObjectTypeDto"
          },
          "ttl_days": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Optional TTL in days (default 7, max 30)."
          }
        }
      },
      "CreateWatchlistRequest": {
        "type": "object",
        "description": "Represents the request to create a new watchlist.",
        "required": [
          "name",
          "description",
          "asset_types"
        ],
        "properties": {
          "asset_types": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Asset types of interest for the watchlist"
          },
          "description": {
            "type": "string",
            "description": "Description of the watchlist"
          },
          "enable_processing": {
            "type": "boolean",
            "description": "Whether to enable action plan processing status for the watchlist"
          },
          "name": {
            "type": "string",
            "description": "Name of the watchlist"
          },
          "sensitivity_level": {
            "$ref": "#/components/schemas/ScopeSensitivityLevel",
            "description": "Sensitivity level for the watchlist, this is used to set thresholds to adjust the priorization scoring process."
          }
        }
      },
      "DashboardCardsPayload": {
        "type": "object",
        "required": [
          "fixed_vs_not_fixed",
          "vulns_published",
          "exploited",
          "beescore_out_of_cycle_or_above",
          "affected_products",
          "poc_weaponized",
          "avg_vulns_released_per_day",
          "avg_hours_to_exploit_published",
          "vulns_in_new",
          "mttp"
        ],
        "properties": {
          "affected_products": {
            "$ref": "#/components/schemas/RatioTrendCardDto"
          },
          "avg_hours_to_exploit_published": {
            "$ref": "#/components/schemas/FloatTrendCardDto"
          },
          "avg_vulns_released_per_day": {
            "$ref": "#/components/schemas/FloatTrendCardDto"
          },
          "beescore_out_of_cycle_or_above": {
            "$ref": "#/components/schemas/TrendCardDto"
          },
          "exploited": {
            "$ref": "#/components/schemas/TrendCardDto"
          },
          "fixed_vs_not_fixed": {
            "$ref": "#/components/schemas/FixedVsNotFixedCardDto"
          },
          "mttp": {
            "$ref": "#/components/schemas/MttpCardDto"
          },
          "poc_weaponized": {
            "$ref": "#/components/schemas/TrendCardDto"
          },
          "vulns_in_new": {
            "$ref": "#/components/schemas/TrendCardDto"
          },
          "vulns_published": {
            "$ref": "#/components/schemas/TrendCardDto",
            "description": "Perimeter vulnerabilities published in the period (WatchList-scoped, not platform-wide ingest)."
          }
        }
      },
      "DashboardCardsResponse": {
        "type": "object",
        "required": [
          "period",
          "previous_period",
          "cards"
        ],
        "properties": {
          "cards": {
            "$ref": "#/components/schemas/DashboardCardsPayload"
          },
          "period": {
            "$ref": "#/components/schemas/PeriodDto"
          },
          "previous_period": {
            "$ref": "#/components/schemas/PeriodDto"
          }
        }
      },
      "DashboardDistributionsResponse": {
        "type": "object",
        "required": [
          "most_affected_vendors",
          "by_processing_status",
          "by_beescore_band"
        ],
        "properties": {
          "by_beescore_band": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/NamedCountDto"
            }
          },
          "by_processing_status": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/NamedCountDto"
            }
          },
          "most_affected_vendors": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/VendorBucketDto"
            }
          }
        }
      },
      "DashboardHotTrendingItemDto": {
        "type": "object",
        "required": [
          "vulnerability_id",
          "title",
          "watchlist_titles"
        ],
        "properties": {
          "beescore": {
            "type": [
              "number",
              "null"
            ],
            "format": "double"
          },
          "title": {
            "type": "string"
          },
          "vulnerability_id": {
            "type": "string"
          },
          "watchlist_titles": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "DashboardInactiveWatchlistDto": {
        "type": "object",
        "required": [
          "watchlist_id",
          "name"
        ],
        "properties": {
          "name": {
            "type": "string"
          },
          "watchlist_id": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "DashboardListQuery": {
        "type": "object",
        "properties": {
          "limit": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Max items to return (default 10, max 50).",
            "minimum": 0
          },
          "period_from": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Inclusive period start (ISO 8601)."
          },
          "period_to": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Inclusive period end (ISO 8601)."
          },
          "priority": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/PriorizationLevel",
                "description": "Priority / BeeScore band filter."
              }
            ]
          },
          "processing_status": {
            "type": [
              "string",
              "null"
            ],
            "description": "Action-plan processing status filter."
          },
          "vendor_ids": {
            "type": [
              "string",
              "null"
            ],
            "description": "Comma-separated vendor IDs."
          },
          "watchlist_ids": {
            "type": [
              "string",
              "null"
            ],
            "description": "Comma-separated watchlist IDs, or `all`."
          }
        }
      },
      "DashboardMetricsQuery": {
        "type": "object",
        "description": "Shared filters for all dashboard metrics endpoints.\n\nAggregates are eventually consistent with materialized views refreshed on a schedule\n(typically every few minutes).",
        "properties": {
          "period_from": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Inclusive period start (ISO 8601). Defaults to now − 30 days UTC when omitted with `period_to`."
          },
          "period_to": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Inclusive period end (ISO 8601). Defaults to now when omitted."
          },
          "priority": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/PriorizationLevel",
                "description": "Priority / BeeScore band filter."
              }
            ]
          },
          "processing_status": {
            "type": [
              "string",
              "null"
            ],
            "description": "Action-plan processing status filter (`new`, `pending`, `ongoing`, `completed`, `dismissed`)."
          },
          "vendor_ids": {
            "type": [
              "string",
              "null"
            ],
            "description": "Comma-separated vendor IDs restricting perimeter product matches."
          },
          "watchlist_ids": {
            "type": [
              "string",
              "null"
            ],
            "description": "Comma-separated watchlist IDs, or `all` (default) for every watchlist the user can view."
          }
        }
      },
      "DashboardNewsItemDto": {
        "type": "object",
        "required": [
          "id",
          "title",
          "source_link",
          "publication_date"
        ],
        "properties": {
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "publication_date": {
            "type": "string",
            "format": "date-time"
          },
          "source_link": {
            "type": "string"
          },
          "source_title": {
            "type": [
              "string",
              "null"
            ],
            "description": "Title of the linked article source. Null when the article is not linked."
          },
          "title": {
            "type": "string"
          }
        }
      },
      "DashboardSeriesResponse": {
        "type": "object",
        "required": [
          "granularity",
          "published_before_period",
          "points"
        ],
        "properties": {
          "granularity": {
            "$ref": "#/components/schemas/SeriesGranularityDto"
          },
          "points": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SeriesPointDto"
            }
          },
          "published_before_period": {
            "type": "integer",
            "format": "int64",
            "description": "Publications with `published_date < period.from`. Cumulative at bucket i =\n`published_before_period + sum(points[0..=i].enters_vulnpilot)`.",
            "minimum": 0
          }
        }
      },
      "DeepLinkDto": {
        "type": "object",
        "required": [
          "resource",
          "query"
        ],
        "properties": {
          "query": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DeepLinkQueryParam"
            }
          },
          "resource": {
            "$ref": "#/components/schemas/DeepLinkResourceDto"
          }
        }
      },
      "DeepLinkQueryParam": {
        "type": "object",
        "required": [
          "key",
          "value"
        ],
        "properties": {
          "key": {
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        }
      },
      "DeepLinkResourceDto": {
        "type": "string",
        "enum": [
          "action_plans",
          "monitor",
          "products"
        ]
      },
      "DescriptionTags": {
        "oneOf": [
          {
            "type": "string",
            "description": "The description is generated by an artificial intelligence.",
            "enum": [
              "artificial_intelligence"
            ]
          },
          {
            "type": "string",
            "description": "The description has been reviewed by a human.",
            "enum": [
              "human_review"
            ]
          },
          {
            "type": "object",
            "description": "Ingested from a source without change.",
            "required": [
              "ingested"
            ],
            "properties": {
              "ingested": {
                "$ref": "#/components/schemas/IngestionSource",
                "description": "Ingested from a source without change."
              }
            }
          }
        ],
        "description": "Represents a tag used to categorize descriptions to provide context on how the description was created."
      },
      "DescriptionType": {
        "type": "string",
        "description": "Represents the type of a description regarding the content.",
        "enum": [
          "summary",
          "impact",
          "remediation",
          "detection",
          "other"
        ]
      },
      "EolCycleLink": {
        "type": "object",
        "description": "Link from a product version to an endoflife.date cycle.",
        "required": [
          "product_slug",
          "cycle_name"
        ],
        "properties": {
          "cycle_name": {
            "type": "string"
          },
          "product_slug": {
            "type": "string"
          }
        }
      },
      "ErrorMessage": {
        "type": "object",
        "description": "JSON body returned to API clients. `code` is the HTTP status and is not serialized.",
        "required": [
          "error",
          "message"
        ],
        "properties": {
          "error": {
            "type": "string"
          },
          "feature": {
            "type": [
              "string",
              "null"
            ]
          },
          "message": {
            "type": "string"
          }
        }
      },
      "FixedVsNotFixedCardDto": {
        "type": "object",
        "required": [
          "fixed",
          "not_fixed",
          "previous_fixed",
          "previous_not_fixed",
          "deep_link_fixed",
          "deep_link_not_fixed"
        ],
        "properties": {
          "deep_link_fixed": {
            "$ref": "#/components/schemas/DeepLinkDto"
          },
          "deep_link_not_fixed": {
            "$ref": "#/components/schemas/DeepLinkDto"
          },
          "fixed": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "not_fixed": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "previous_fixed": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "previous_not_fixed": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          }
        }
      },
      "FloatTrendCardDto": {
        "type": "object",
        "required": [
          "sample_size",
          "previous_sample_size"
        ],
        "properties": {
          "previous": {
            "type": [
              "number",
              "null"
            ],
            "format": "double"
          },
          "previous_sample_size": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "sample_size": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "value": {
            "type": [
              "number",
              "null"
            ],
            "format": "double"
          }
        }
      },
      "GetVulnerabilityQuery": {
        "type": "object",
        "description": "Query parameters for fetching a single vulnerability (detailed sheet).",
        "properties": {
          "action_plan_id": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Optional action plan context. When set, the response includes the personalized\nbeescore from that action plan's link to this vulnerability."
          }
        }
      },
      "GrantActionPlanConsentRequest": {
        "type": "object",
        "description": "Request body for granting backoffice access to an action plan.",
        "required": [
          "duration_days"
        ],
        "properties": {
          "duration_days": {
            "type": "integer",
            "format": "int32",
            "description": "Grant duration in days. Must be 7, 14, or 30."
          },
          "permissions": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/ActionPlanConsentPermission"
            },
            "description": "Permissions granted to the backoffice team. Defaults to edit access when omitted."
          },
          "reason": {
            "type": [
              "string",
              "null"
            ],
            "description": "Optional reason shown to the backoffice team."
          }
        }
      },
      "GrantConsentRequest": {
        "type": "object",
        "description": "Request body for granting backoffice access to a watchlist.",
        "required": [
          "duration_days"
        ],
        "properties": {
          "duration_days": {
            "type": "integer",
            "format": "int32",
            "description": "Grant duration in days. Must be 7, 14, or 30."
          },
          "permissions": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/WatchlistConsentPermission"
            },
            "description": "Permissions granted to the backoffice team. Defaults to edit access when omitted."
          },
          "reason": {
            "type": [
              "string",
              "null"
            ],
            "description": "Optional reason shown to the backoffice team."
          }
        }
      },
      "ImportFieldOptionsResponse": {
        "type": "object",
        "description": "Response listing the watchlist fields available for column mapping in the import UI.",
        "required": [
          "fields"
        ],
        "properties": {
          "fields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/WatchlistImportFieldOption"
            },
            "description": "Target fields the user can assign file columns to (product name, vendor, version, etc.)."
          }
        }
      },
      "IndustryWatchlistItemResponse": {
        "type": "object",
        "required": [
          "industry_id",
          "creation_date",
          "comment",
          "tags"
        ],
        "properties": {
          "comment": {
            "type": "string"
          },
          "creation_date": {
            "type": "string",
            "format": "date-time"
          },
          "industry_id": {
            "type": "integer",
            "format": "int32"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "IngestionSource": {
        "type": "string",
        "description": "Represents the source of an ingestion.",
        "enum": [
          "cve_record",
          "rss_feed",
          "nvd",
          "ghsa",
          "misc"
        ]
      },
      "ListActionPlanVulnerabilitiesQuery": {
        "allOf": [
          {
            "$ref": "#/components/schemas/PaginationQuery"
          }
        ],
        "description": "Query parameters for paginated action plan vulnerabilities."
      },
      "ListActionPlansQuery": {
        "allOf": [
          {
            "$ref": "#/components/schemas/PaginationQuery"
          },
          {
            "type": "object",
            "properties": {
              "beescore_max": {
                "type": [
                  "number",
                  "null"
                ],
                "format": "double",
                "description": "Beescore maximum"
              },
              "beescore_min": {
                "type": [
                  "number",
                  "null"
                ],
                "format": "double",
                "description": "Beescore threshold"
              },
              "creation_date_from": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "date-time",
                "description": "Optional filter by creation date start (ISO 8601 format).\nWhen neither creation_date_from nor creation_date_to is provided, defaults to the current month."
              },
              "creation_date_to": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "date-time",
                "description": "Optional filter by creation date end (ISO 8601 format).\nWhen neither creation_date_from nor creation_date_to is provided, defaults to the current month."
              },
              "order_by": {
                "oneOf": [
                  {
                    "type": "null"
                  },
                  {
                    "$ref": "#/components/schemas/ActionPlanOrderBy",
                    "description": "Order by field"
                  }
                ]
              },
              "order_direction": {
                "oneOf": [
                  {
                    "type": "null"
                  },
                  {
                    "$ref": "#/components/schemas/OrderDirection",
                    "description": "Order direction"
                  }
                ]
              },
              "processing_status": {
                "oneOf": [
                  {
                    "type": "null"
                  },
                  {
                    "$ref": "#/components/schemas/BulletinProcessingStatus",
                    "description": "Optional filter by processing status"
                  }
                ]
              },
              "search": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Optional filter to search in action plan title, descriptions, and tags"
              },
              "watchlist_ids": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Watchlist IDs (comma-separated list of watchlist IDs)"
              }
            }
          }
        ],
        "description": "Query parameters for listing action plans"
      },
      "ListApiKeysResponse": {
        "type": "object",
        "description": "Represents the response to list API keys.",
        "required": [
          "api_keys"
        ],
        "properties": {
          "api_keys": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ApiKeyListItem"
            }
          }
        }
      },
      "ListArticlesQuery": {
        "allOf": [
          {
            "$ref": "#/components/schemas/PaginationQuery"
          },
          {
            "type": "object",
            "properties": {
              "title": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Optional full-text search on title and short description."
              },
              "vulnerability_id": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Optional filter: articles referencing this external vulnerability id (e.g. `cve:CVE-2024-1234`)."
              }
            }
          }
        ]
      },
      "ListConsentsQuery": {
        "allOf": [
          {
            "$ref": "#/components/schemas/PaginationQuery"
          }
        ],
        "description": "Query parameters for listing consent grants."
      },
      "ListPackageVersionsQuery": {
        "allOf": [
          {
            "$ref": "#/components/schemas/PaginationQuery"
          },
          {
            "type": "object",
            "properties": {
              "distro_version": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Optional distro release stream (`3.18`, `22.04`, `bookworm`, …)."
              }
            }
          }
        ],
        "description": "Query parameters for listing versions of a package."
      },
      "ListPackagesQuery": {
        "allOf": [
          {
            "$ref": "#/components/schemas/PaginationQuery"
          },
          {
            "type": "object",
            "properties": {
              "distro_family": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Distro family slug (`alpine`, `debian`, `ubuntu`, `rhel`)."
              },
              "distro_name": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Case-insensitive partial match on distro display name."
              },
              "distro_version": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Restrict to packages that have a version in this distro release stream."
              },
              "name": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Case-insensitive partial match on package name."
              },
              "package_ids": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Comma-separated package IDs."
              },
              "package_manager": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Package manager slug (`apk`, `dpkg`, `rpm`)."
              },
              "search": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Full-text search on package name, uid, and aliases."
              }
            }
          }
        ],
        "description": "Query parameters for listing packages."
      },
      "ListProductVersionsQuery": {
        "allOf": [
          {
            "$ref": "#/components/schemas/PaginationQuery"
          },
          {
            "type": "object",
            "properties": {
              "branch": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "First version component. `1` matches `1`, `1.2`, and `1.2.3`. `bionic` matches that exact value."
              },
              "version": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Exact complete version number. Matches a version value that contains a digit."
              }
            }
          }
        ],
        "description": "Query parameters for listing catalog versions of a product."
      },
      "ListProductsQuery": {
        "allOf": [
          {
            "$ref": "#/components/schemas/PaginationQuery"
          },
          {
            "type": "object",
            "properties": {
              "cpe": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Optional CPE 2.2/2.3 string used to match catalog products by WFN relation"
              },
              "created_after": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "date-time",
                "description": "Optional filter for creation date - minimum (inclusive)"
              },
              "created_before": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "date-time",
                "description": "Optional filter for creation date - maximum (inclusive)"
              },
              "featured": {
                "type": "boolean",
                "description": "Optional filter to select products that are featured"
              },
              "include_groups": {
                "type": "boolean",
                "description": "Include hidden catalog groups. Ignored unless the caller can edit the catalog."
              },
              "product_ids": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "List only products with the given IDs (comma-separated list of product IDs)"
              },
              "search": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Optional search filter to look in name, aliases, and cpe_names (case-insensitive partial match)"
              },
              "sort_by": {
                "$ref": "#/components/schemas/ProductSortField",
                "description": "Sort field for the results. Defaults to \"name\"."
              },
              "sort_order": {
                "$ref": "#/components/schemas/OrderDirection",
                "description": "Sort order for the results. Defaults to \"asc\"."
              },
              "tags": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Optional filter to select products by tags (comma-separated list of tag names)"
              },
              "updated_after": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "date-time",
                "description": "Optional filter for last update date - minimum (inclusive)"
              },
              "updated_before": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "date-time",
                "description": "Optional filter for last update date - maximum (inclusive)"
              },
              "vendor_id": {
                "type": [
                  "integer",
                  "null"
                ],
                "format": "int32",
                "description": "Optional filter to select products by vendor ID"
              }
            }
          }
        ],
        "description": "Query parameters for listing products"
      },
      "ListShareLinksQuery": {
        "allOf": [
          {
            "$ref": "#/components/schemas/PaginationQuery"
          }
        ],
        "description": "Query for listing the current user's share links."
      },
      "ListVendorsQuery": {
        "allOf": [
          {
            "$ref": "#/components/schemas/PaginationQuery"
          },
          {
            "type": "object",
            "properties": {
              "cpe_name": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Optional filter to search by CPE name (case-insensitive partial match)"
              },
              "featured": {
                "type": "boolean",
                "description": "Optional filter to search by featured vendors"
              },
              "include_groups": {
                "type": "boolean",
                "description": "Include hidden catalog groups. Ignored unless the caller can edit the catalog."
              },
              "name": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Optional filter to search by vendor name (case-insensitive partial match)"
              },
              "tags": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Optional filter to search by tags (comma-separated list of tag names)"
              },
              "vendor_ids": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "List only vendors with the given IDs (comma-separated list of vendor IDs)"
              }
            }
          }
        ]
      },
      "ListVulnerabilitiesQuery": {
        "allOf": [
          {
            "$ref": "#/components/schemas/PaginationQuery"
          },
          {
            "type": "object",
            "properties": {
              "beescore_max": {
                "type": [
                  "number",
                  "null"
                ],
                "format": "double",
                "description": "Maximum beescore threshold"
              },
              "beescore_min": {
                "type": [
                  "number",
                  "null"
                ],
                "format": "double",
                "description": "Minimum beescore threshold"
              },
              "creation_date_from": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "date-time",
                "description": "Optional filter by creation date start (ISO 8601 format, e.g., \"2025-01-01T00:00:00Z\")"
              },
              "creation_date_to": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "date-time",
                "description": "Optional filter by creation date end (ISO 8601 format, e.g., \"2025-12-31T23:59:59Z\")"
              },
              "cvss_score_max": {
                "type": [
                  "number",
                  "null"
                ],
                "format": "double",
                "description": "Maximum CVSS score threshold"
              },
              "cvss_score_min": {
                "type": [
                  "number",
                  "null"
                ],
                "format": "double",
                "description": "Minimum CVSS score threshold"
              },
              "modification_date_from": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "date-time",
                "description": "Optional filter by modification date start (ISO 8601 format, e.g., \"2025-01-01T00:00:00Z\")"
              },
              "modification_date_to": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "date-time",
                "description": "Optional filter by modification date end (ISO 8601 format, e.g., \"2025-12-31T23:59:59Z\")"
              },
              "order_by": {
                "$ref": "#/components/schemas/OrderVulnerabilityResultsBy",
                "description": "Order by field: publication date, modification date, creation date, beescore, cvss, or epss. Defaults to publication date."
              },
              "order_direction": {
                "$ref": "#/components/schemas/OrderDirection",
                "description": "Order direction: \"asc\" or \"desc\". Defaults to \"desc\"."
              },
              "product_ids": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Optional filter by product IDs (comma-separated list of product IDs)"
              },
              "published_date_from": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "date-time",
                "description": "Optional filter by publication date start (ISO 8601 format, e.g., \"2025-01-01T00:00:00Z\")"
              },
              "published_date_to": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "date-time",
                "description": "Optional filter by publication date end (ISO 8601 format, e.g., \"2025-12-31T23:59:59Z\")"
              },
              "search": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Optional full-text search in vulnerability text fields (title, descriptions, ids, aliases)"
              },
              "tags": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Optional filter by tags (comma-separated list of tags)"
              },
              "vendor_ids": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Optional filter by vendor IDs (comma-separated list of vendor IDs)"
              }
            }
          }
        ],
        "description": "Query parameters for listing vulnerabilities"
      },
      "ListWatchlistImportsQuery": {
        "allOf": [
          {
            "$ref": "#/components/schemas/PaginationQuery"
          },
          {
            "type": "object",
            "properties": {
              "watchlist_id": {
                "type": [
                  "integer",
                  "null"
                ],
                "format": "int32",
                "description": "When set, only imports for this watchlist are returned. The user must have view access."
              }
            }
          }
        ],
        "description": "Query parameters for `GET /api/import/watchlist`."
      },
      "LoginRequest": {
        "type": "object",
        "required": [
          "api_key_id",
          "api_key_secret"
        ],
        "properties": {
          "api_key_id": {
            "type": "string",
            "format": "uuid"
          },
          "api_key_secret": {
            "type": "string"
          }
        }
      },
      "LoginResponse": {
        "type": "object",
        "required": [
          "token",
          "expiry_date"
        ],
        "properties": {
          "expiry_date": {
            "type": "string",
            "format": "date-time"
          },
          "token": {
            "type": "string"
          }
        }
      },
      "MonitorQuery": {
        "allOf": [
          {
            "$ref": "#/components/schemas/PaginationQuery"
          },
          {
            "type": "object",
            "properties": {
              "beescore_max": {
                "type": [
                  "number",
                  "null"
                ],
                "format": "double",
                "description": "Maximum beescore threshold"
              },
              "beescore_min": {
                "type": [
                  "number",
                  "null"
                ],
                "format": "double",
                "description": "Minimum beescore threshold"
              },
              "cvss_score_max": {
                "type": [
                  "number",
                  "null"
                ],
                "format": "double",
                "description": "Maximum CVSS score threshold"
              },
              "cvss_score_min": {
                "type": [
                  "number",
                  "null"
                ],
                "format": "double",
                "description": "Minimum CVSS score threshold"
              },
              "end_date": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "date-time",
                "description": "Optional filter by publication date end (ISO 8601 format, e.g., \"2025-12-31T23:59:59Z\")\nIf not provided, the end date is today."
              },
              "include_terminal_action_plans": {
                "type": "boolean",
                "description": "When true, include vulnerabilities whose action plan is completed or dismissed.\nDefaults to false."
              },
              "order_by": {
                "$ref": "#/components/schemas/OrderMonitorResultsBy",
                "description": "Order by field: beescore, publication date, cvss, or epss. Defaults to beescore."
              },
              "order_direction": {
                "$ref": "#/components/schemas/OrderDirection",
                "description": "Order direction: \"asc\" or \"desc\". Defaults to \"desc\"."
              },
              "product_ids": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Optional filter by product IDs (comma-separated list of product IDs)"
              },
              "search": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Freetext search"
              },
              "start_date": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "date-time",
                "description": "Optional filter by publication date start (ISO 8601 format, e.g., \"2025-01-01T00:00:00Z\")\nIf not provided, we return all times."
              },
              "tags": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Tags to filter by (comma-separated list of tags)"
              },
              "vendor_ids": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Optional filter by vendor IDs (comma-separated list of vendor IDs)"
              },
              "watchlist_ids": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Optional filter by watchlist IDs (comma-separated list of watchlist IDs)"
              }
            }
          }
        ],
        "description": "Query parameters for monitoring vulnerabilities from action plans"
      },
      "MonitorVulnerabilityResponse": {
        "type": "object",
        "description": "Represents a vulnerability in the monitor API response.",
        "required": [
          "vulnerability_id",
          "alternative_ids",
          "descriptions",
          "watchlists",
          "action_plan_id",
          "published_date",
          "vulnerability_title",
          "tags",
          "products",
          "estimated"
        ],
        "properties": {
          "action_plan_id": {
            "type": "integer",
            "format": "int64",
            "description": "Action plan ID that links this vulnerability in the monitor context"
          },
          "alternative_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Alternative IDs of the vulnerability"
          },
          "beescore": {
            "type": [
              "number",
              "null"
            ],
            "format": "double",
            "description": "Beescore (personalized prioritization score) for this vulnerability in the action plan context"
          },
          "cvss_score": {
            "type": [
              "number",
              "null"
            ],
            "format": "double",
            "description": "CVSS score from the personalized score"
          },
          "cvss_vector": {
            "type": [
              "string",
              "null"
            ],
            "description": "CVSS vector from the personalized score"
          },
          "descriptions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MultilingualDescription"
            },
            "description": "Descriptions of the vulnerability (multilingual)"
          },
          "epss_score": {
            "type": [
              "number",
              "null"
            ],
            "format": "float",
            "description": "EPSS score from the personalized score (when a CVE/EPSS row is available)"
          },
          "estimated": {
            "type": "boolean",
            "description": "Have score components been estimated?"
          },
          "products": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ShortProductResponse"
            },
            "description": "Product specifications of the vulnerability"
          },
          "published_date": {
            "type": "string",
            "format": "date-time",
            "description": "Publication date"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Tags of the vulnerability"
          },
          "vulnerability_id": {
            "type": "string",
            "description": "Sentibee vulnerability ID (e.g., \"STB-2025-1234\")"
          },
          "vulnerability_title": {
            "type": "string",
            "description": "Title of the vulnerability"
          },
          "watchlists": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MonitorWatchlistResponse"
            },
            "description": "Associated watchlist IDs and names"
          }
        }
      },
      "MonitorWatchlistResponse": {
        "type": "object",
        "required": [
          "id",
          "name"
        ],
        "properties": {
          "id": {
            "type": "integer",
            "format": "int32"
          },
          "name": {
            "type": "string"
          }
        }
      },
      "MttpCardDto": {
        "allOf": [
          {
            "$ref": "#/components/schemas/MttpStatsDto"
          },
          {
            "type": "object",
            "required": [
              "previous"
            ],
            "properties": {
              "previous": {
                "$ref": "#/components/schemas/MttpStatsDto"
              }
            }
          }
        ]
      },
      "MttpStatsDto": {
        "type": "object",
        "required": [
          "status",
          "sample_size"
        ],
        "properties": {
          "mean_hours": {
            "type": [
              "number",
              "null"
            ],
            "format": "double"
          },
          "median_hours": {
            "type": [
              "number",
              "null"
            ],
            "format": "double"
          },
          "p25_hours": {
            "type": [
              "number",
              "null"
            ],
            "format": "double"
          },
          "p75_hours": {
            "type": [
              "number",
              "null"
            ],
            "format": "double"
          },
          "sample_size": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "status": {
            "$ref": "#/components/schemas/MttpStatusDto"
          }
        }
      },
      "MttpStatusDto": {
        "type": "string",
        "enum": [
          "ok",
          "insufficient_data"
        ]
      },
      "MultilingualDescription": {
        "type": "object",
        "description": "A multilingual description. It allows specification of a description taking into account multiple languages.",
        "required": [
          "lang",
          "value",
          "tags"
        ],
        "properties": {
          "description_type": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/DescriptionType",
                "description": "The type of the description."
              }
            ]
          },
          "lang": {
            "type": "string",
            "description": "The language of the description (BCP 47 language code)."
          },
          "tags": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/DescriptionTags"
            },
            "description": "The tags of the description.",
            "uniqueItems": true
          },
          "value": {
            "type": "string",
            "description": "The value of the description."
          }
        }
      },
      "NamedCountDto": {
        "type": "object",
        "required": [
          "key",
          "count"
        ],
        "properties": {
          "count": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "key": {
            "type": "string"
          }
        }
      },
      "OrderDirection": {
        "type": "string",
        "enum": [
          "Asc",
          "Desc"
        ]
      },
      "OrderMonitorResultsBy": {
        "type": "string",
        "enum": [
          "Beescore",
          "PublicationDate",
          "Cvss",
          "Epss"
        ]
      },
      "OrderVulnerabilityResultsBy": {
        "type": "string",
        "description": "Ordering options for vulnerability results",
        "enum": [
          "PublicationDate",
          "ModificationDate",
          "CreationDate",
          "Beescore",
          "Cvss",
          "Epss"
        ]
      },
      "OrganizationConfiguration": {
        "type": "object",
        "description": "Organization configuration exposed by the API.",
        "required": [
          "first_run",
          "context"
        ],
        "properties": {
          "context": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "propertyNames": {
              "type": "string"
            }
          },
          "first_run": {
            "type": "boolean"
          },
          "last_normalization_triggered_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "retain_notifications_when_pending_review": {
            "type": "boolean",
            "description": "When true, keep sending notifications for action plans in pending review."
          }
        }
      },
      "OrganizationEntitlementsResponse": {
        "type": "object",
        "required": [
          "pricing_tier",
          "display_name",
          "limits",
          "usage"
        ],
        "properties": {
          "display_name": {
            "type": "string"
          },
          "limits": {
            "$ref": "#/components/schemas/OrganizationPlanLimits"
          },
          "pricing_tier": {
            "type": "string"
          },
          "usage": {
            "$ref": "#/components/schemas/OrganizationQuotaUsageResponse"
          }
        }
      },
      "OrganizationMemberResponse": {
        "type": "object",
        "description": "Represents a member of an organization as returned by the API.",
        "required": [
          "id",
          "name",
          "surname",
          "email",
          "role",
          "enabled"
        ],
        "properties": {
          "email": {
            "type": "string",
            "description": "The email address of the user."
          },
          "enabled": {
            "type": "boolean",
            "description": "Whether the user account is enabled."
          },
          "id": {
            "type": "integer",
            "format": "int32",
            "description": "The id of the user."
          },
          "name": {
            "type": "string",
            "description": "The name of the user."
          },
          "role": {
            "$ref": "#/components/schemas/UserRoleResponse",
            "description": "The role of the user."
          },
          "surname": {
            "type": "string",
            "description": "The surname of the user."
          }
        }
      },
      "OrganizationPlanLimits": {
        "type": "object",
        "description": "Plan limits for an organization.\n\nNumeric fields are `null` when not included, `0` when unlimited, and a positive cap otherwise.",
        "properties": {
          "api_burst": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "minimum": 0
          },
          "api_requests_per_hour": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "minimum": 0
          },
          "api_requests_per_month": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "minimum": 0
          },
          "assistance_requests_included_total": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "minimum": 0
          },
          "assistance_requests_per_month": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "minimum": 0
          },
          "can_configure_webhook_notifiers": {
            "type": "boolean"
          },
          "can_create_api_keys": {
            "type": "boolean"
          },
          "can_create_share_links": {
            "type": "boolean"
          },
          "can_edit_action_plans": {
            "type": "boolean"
          },
          "can_export_dashboards": {
            "type": "boolean"
          },
          "can_import_watchlist": {
            "type": "boolean"
          },
          "can_request_action_plan_assistance": {
            "type": "boolean"
          },
          "can_use_custom_branding": {
            "type": "boolean"
          },
          "can_use_immediate_notifications": {
            "type": "boolean"
          },
          "can_use_personalized_dashboards": {
            "type": "boolean"
          },
          "can_use_rbac": {
            "type": "boolean"
          },
          "can_use_sso": {
            "type": "boolean"
          },
          "max_action_plan_changes_per_month": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "minimum": 0
          },
          "max_packages": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "minimum": 0
          },
          "max_products": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "minimum": 0
          },
          "max_scopes": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "minimum": 0
          },
          "max_users": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "minimum": 0
          },
          "max_vendors": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "minimum": 0
          },
          "overrides": {
            "$ref": "#/components/schemas/PlanLimitOverrides"
          },
          "trial_period_days": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Absent when the plan has no trial. Otherwise the number of days a trial runs.",
            "minimum": 0
          }
        }
      },
      "OrganizationQuotaUsageResponse": {
        "type": "object",
        "required": [
          "period_start",
          "period_end",
          "action_plan_changes",
          "assistance_requests_total",
          "assistance_requests_in_period",
          "api_requests_in_period",
          "scopes",
          "users",
          "products",
          "packages",
          "vendors"
        ],
        "properties": {
          "action_plan_changes": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "api_requests_in_period": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "assistance_requests_in_period": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "assistance_requests_total": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "packages": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "period_end": {
            "type": "string",
            "format": "date-time"
          },
          "period_start": {
            "type": "string",
            "format": "date-time"
          },
          "products": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "scopes": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "users": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "vendors": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          }
        }
      },
      "OrganizationResponse": {
        "type": "object",
        "description": "Represents the properties of an organization as returned by the API.",
        "required": [
          "name",
          "pricing_tier",
          "pricing_tier_display_name",
          "created_at",
          "updated_at",
          "on_trial",
          "organization_plan_limits",
          "configuration"
        ],
        "properties": {
          "configuration": {
            "$ref": "#/components/schemas/OrganizationConfiguration"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "name": {
            "type": "string"
          },
          "on_trial": {
            "type": "boolean"
          },
          "organization_plan_limits": {
            "$ref": "#/components/schemas/OrganizationPlanLimits"
          },
          "pricing_tier": {
            "type": "string",
            "description": "Technical tier name."
          },
          "pricing_tier_display_name": {
            "type": "string"
          },
          "pricing_tier_expiration_date": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "renews_automatically": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "True when an active Stripe subscription will renew at the current period end.\nOlder responses omit it; treat a missing value as false."
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "PackageResponse": {
        "type": "object",
        "description": "Package catalog row for list and detail views.",
        "required": [
          "id",
          "package_uid",
          "name",
          "package_manager",
          "distro_family",
          "distro_name",
          "refs",
          "aliases",
          "status",
          "created_at",
          "updated_at",
          "last_ingested_at"
        ],
        "properties": {
          "aliases": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "architecture": {
            "type": [
              "string",
              "null"
            ]
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "distro_family": {
            "type": "string"
          },
          "distro_name": {
            "type": "string"
          },
          "homepage": {
            "type": [
              "string",
              "null"
            ]
          },
          "id": {
            "type": "integer",
            "format": "int32"
          },
          "last_ingested_at": {
            "type": "string",
            "format": "date-time"
          },
          "name": {
            "type": "string"
          },
          "package_manager": {
            "type": "string"
          },
          "package_uid": {
            "type": "string"
          },
          "purl": {
            "type": [
              "string",
              "null"
            ]
          },
          "refs": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Reference"
            }
          },
          "short_description": {
            "type": [
              "string",
              "null"
            ]
          },
          "source_package_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "status": {
            "type": "string"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "upstream_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "upstream_product_id": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32"
          }
        }
      },
      "PackageVersionResponse": {
        "type": "object",
        "description": "One shipped package version.",
        "required": [
          "id",
          "package_id",
          "package_version",
          "version_convention",
          "is_yanked",
          "is_obsolete",
          "created_at",
          "updated_at"
        ],
        "properties": {
          "architecture": {
            "type": [
              "string",
              "null"
            ]
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "distro_version": {
            "type": [
              "string",
              "null"
            ]
          },
          "epoch": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32"
          },
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "is_obsolete": {
            "type": "boolean"
          },
          "is_yanked": {
            "type": "boolean"
          },
          "package_id": {
            "type": "integer",
            "format": "int32"
          },
          "package_version": {
            "type": "string"
          },
          "patch_level": {
            "type": [
              "string",
              "null"
            ]
          },
          "released_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "revision": {
            "type": [
              "string",
              "null"
            ]
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "version_convention": {
            "$ref": "#/components/schemas/VersionConvention"
          }
        }
      },
      "PackageVersionVulnerabilityResponse": {
        "type": "object",
        "description": "Advisory link from a package version to a published vulnerability or CVE.",
        "required": [
          "id",
          "package_version_id",
          "relation",
          "source"
        ],
        "properties": {
          "advisory_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "advisory_url": {
            "type": [
              "string",
              "null"
            ]
          },
          "confidence": {
            "type": [
              "string",
              "null"
            ]
          },
          "cve_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "package_version_id": {
            "type": "integer",
            "format": "int64"
          },
          "relation": {
            "type": "string"
          },
          "source": {
            "type": "string"
          },
          "vulnerability_id": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32"
          }
        }
      },
      "PackageWatchlistItemRequest": {
        "type": "object",
        "description": "Represents a package watchlist item request (without creation date).",
        "required": [
          "package_id",
          "criticality",
          "exposure",
          "comment",
          "tags",
          "version"
        ],
        "properties": {
          "comment": {
            "type": "string",
            "description": "Comment for the watchlist item"
          },
          "criticality": {
            "$ref": "#/components/schemas/WatchlistItemCriticality",
            "description": "Criticality of the package"
          },
          "distro_version": {
            "type": [
              "string",
              "null"
            ],
            "description": "Optional distribution/release stream (e.g. `22.04`, `bookworm`, `3.18`)"
          },
          "exposure": {
            "$ref": "#/components/schemas/ProductExposure",
            "description": "Exposure of the package"
          },
          "package_id": {
            "type": "integer",
            "format": "int32",
            "description": "ID of the package"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Tags for the watchlist item"
          },
          "version": {
            "$ref": "#/components/schemas/WatchlistVersion",
            "description": "Package version frame that should be monitored"
          }
        }
      },
      "PackageWatchlistItemResponse": {
        "type": "object",
        "required": [
          "package_id",
          "criticality",
          "exposure",
          "creation_date",
          "comment",
          "tags",
          "version"
        ],
        "properties": {
          "comment": {
            "type": "string"
          },
          "creation_date": {
            "type": "string",
            "format": "date-time"
          },
          "criticality": {
            "$ref": "#/components/schemas/WatchlistItemCriticality"
          },
          "distro_version": {
            "type": [
              "string",
              "null"
            ]
          },
          "exposure": {
            "$ref": "#/components/schemas/ProductExposure"
          },
          "package_id": {
            "type": "integer",
            "format": "int32"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "version": {
            "$ref": "#/components/schemas/WatchlistVersion"
          }
        }
      },
      "PaginatedResponse_ActionPlanConsentResponse": {
        "type": "object",
        "description": "Generic paginated API response.\n\n`total` represents the total number of items available for the current query.\nWhen `total_is_approximate` is true, `total` is a planner estimate from `EXPLAIN`, not an exact count.",
        "required": [
          "total",
          "page",
          "page_size",
          "data"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "An action plan consent grant returned to the customer organization.",
              "required": [
                "id",
                "action_plan_id",
                "watchlist_id",
                "organization_id",
                "permissions",
                "duration_days",
                "expires_at",
                "created_at"
              ],
              "properties": {
                "action_plan_id": {
                  "type": "integer",
                  "format": "int64",
                  "description": "Action plan the grant applies to."
                },
                "backoffice_task_id": {
                  "type": [
                    "integer",
                    "null"
                  ],
                  "format": "int64",
                  "description": "Open backoffice assistance task linked to this grant, if any."
                },
                "created_at": {
                  "type": "string",
                  "format": "date-time",
                  "description": "UTC timestamp when the grant was created."
                },
                "duration_days": {
                  "type": "integer",
                  "format": "int32",
                  "description": "Requested duration in days (7, 14, or 30)."
                },
                "expires_at": {
                  "type": "string",
                  "format": "date-time",
                  "description": "UTC timestamp when the grant expires."
                },
                "id": {
                  "type": "integer",
                  "format": "int64",
                  "description": "Unique identifier of the consent grant."
                },
                "organization_id": {
                  "type": "integer",
                  "format": "int32",
                  "description": "Customer organization that issued the grant."
                },
                "permissions": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ActionPlanConsentPermission"
                  },
                  "description": "Permissions granted to the backoffice team."
                },
                "reason": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Optional reason provided by the customer."
                },
                "revoked_at": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "format": "date-time",
                  "description": "UTC timestamp when the grant was revoked, if applicable."
                },
                "watchlist_id": {
                  "type": "integer",
                  "format": "int32",
                  "description": "Parent watchlist of the action plan."
                }
              }
            }
          },
          "page": {
            "type": "integer",
            "format": "int64",
            "description": "Current page number (1-indexed)",
            "minimum": 0
          },
          "page_size": {
            "type": "integer",
            "format": "int64",
            "description": "Number of items per page",
            "minimum": 0
          },
          "total": {
            "type": "integer",
            "format": "int64",
            "description": "Total number of items",
            "minimum": 0
          },
          "total_is_approximate": {
            "type": "boolean",
            "description": "When true, `total` is a rough estimate rather than an exact count."
          }
        }
      },
      "PaginatedResponse_ActionPlanProcessingStatusHistoryResponse": {
        "type": "object",
        "description": "Generic paginated API response.\n\n`total` represents the total number of items available for the current query.\nWhen `total_is_approximate` is true, `total` is a planner estimate from `EXPLAIN`, not an exact count.",
        "required": [
          "total",
          "page",
          "page_size",
          "data"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "One processing-status transition for an action plan.",
              "required": [
                "id",
                "action_plan_id",
                "changed_at"
              ],
              "properties": {
                "action_plan_id": {
                  "type": "integer",
                  "format": "int64"
                },
                "change_reason": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "changed_at": {
                  "type": "string",
                  "format": "date-time"
                },
                "changed_by_user_id": {
                  "type": [
                    "integer",
                    "null"
                  ],
                  "format": "int32"
                },
                "from_status": {
                  "oneOf": [
                    {
                      "type": "null"
                    },
                    {
                      "$ref": "#/components/schemas/BulletinProcessingStatus"
                    }
                  ]
                },
                "id": {
                  "type": "integer",
                  "format": "int64"
                },
                "to_status": {
                  "oneOf": [
                    {
                      "type": "null"
                    },
                    {
                      "$ref": "#/components/schemas/BulletinProcessingStatus"
                    }
                  ]
                }
              }
            }
          },
          "page": {
            "type": "integer",
            "format": "int64",
            "description": "Current page number (1-indexed)",
            "minimum": 0
          },
          "page_size": {
            "type": "integer",
            "format": "int64",
            "description": "Number of items per page",
            "minimum": 0
          },
          "total": {
            "type": "integer",
            "format": "int64",
            "description": "Total number of items",
            "minimum": 0
          },
          "total_is_approximate": {
            "type": "boolean",
            "description": "When true, `total` is a rough estimate rather than an exact count."
          }
        }
      },
      "PaginatedResponse_ActionPlanResponse": {
        "type": "object",
        "description": "Generic paginated API response.\n\n`total` represents the total number of items available for the current query.\nWhen `total_is_approximate` is true, `total` is a planner estimate from `EXPLAIN`, not an exact count.",
        "required": [
          "total",
          "page",
          "page_size",
          "data"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "Represents an action plan in the API response (summary view for listings).",
              "required": [
                "id",
                "watchlist_id",
                "title",
                "descriptions",
                "created_at",
                "updated_at",
                "origin"
              ],
              "properties": {
                "beescore": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "format": "float"
                },
                "created_at": {
                  "type": "string",
                  "format": "date-time",
                  "description": "Creation date of the action plan"
                },
                "descriptions": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/MultilingualDescription"
                  },
                  "description": "Descriptions of the action plan"
                },
                "id": {
                  "type": "integer",
                  "format": "int64",
                  "description": "Unique identifier of the action plan"
                },
                "origin": {
                  "$ref": "#/components/schemas/ActionPlanOrigin",
                  "description": "Whether the plan was created by matching or by a backoffice user."
                },
                "processing_status": {
                  "oneOf": [
                    {
                      "type": "null"
                    },
                    {
                      "$ref": "#/components/schemas/BulletinProcessingStatus",
                      "description": "Processing status of the action plan"
                    }
                  ]
                },
                "title": {
                  "type": "string",
                  "description": "Title of the action plan"
                },
                "updated_at": {
                  "type": "string",
                  "format": "date-time",
                  "description": "Last update date of the action plan"
                },
                "watchlist_id": {
                  "type": "integer",
                  "format": "int32",
                  "description": "ID of the watchlist this action plan belongs to"
                }
              }
            }
          },
          "page": {
            "type": "integer",
            "format": "int64",
            "description": "Current page number (1-indexed)",
            "minimum": 0
          },
          "page_size": {
            "type": "integer",
            "format": "int64",
            "description": "Number of items per page",
            "minimum": 0
          },
          "total": {
            "type": "integer",
            "format": "int64",
            "description": "Total number of items",
            "minimum": 0
          },
          "total_is_approximate": {
            "type": "boolean",
            "description": "When true, `total` is a rough estimate rather than an exact count."
          }
        }
      },
      "PaginatedResponse_ActionPlanSheetVulnerabilityDetail": {
        "type": "object",
        "description": "Generic paginated API response.\n\n`total` represents the total number of items available for the current query.\nWhen `total_is_approximate` is true, `total` is a planner estimate from `EXPLAIN`, not an exact count.",
        "required": [
          "total",
          "page",
          "page_size",
          "data"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "Paginated response for action plan vulnerabilities.\nRepresents a vulnerability row for action plan sheet display.",
              "required": [
                "vulnerability_id",
                "title",
                "alternative_ids",
                "descriptions"
              ],
              "properties": {
                "alternative_ids": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Alternative IDs of the vulnerability"
                },
                "beescore": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "format": "double",
                  "description": "Beescore (personalized prioritization score) for this vulnerability in the action plan context"
                },
                "descriptions": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/MultilingualDescription"
                  },
                  "description": "Most relevant summary description only (single item at most)"
                },
                "timeline_data": {
                  "type": [
                    "array",
                    "null"
                  ],
                  "items": {
                    "$ref": "#/components/schemas/VulnerabilityTimelineItem"
                  },
                  "description": "Timeline of the vulnerability"
                },
                "title": {
                  "type": "string",
                  "description": "Title of the vulnerability"
                },
                "vulnerability_id": {
                  "type": "string",
                  "description": "Sentibee vulnerability ID"
                }
              }
            }
          },
          "page": {
            "type": "integer",
            "format": "int64",
            "description": "Current page number (1-indexed)",
            "minimum": 0
          },
          "page_size": {
            "type": "integer",
            "format": "int64",
            "description": "Number of items per page",
            "minimum": 0
          },
          "total": {
            "type": "integer",
            "format": "int64",
            "description": "Total number of items",
            "minimum": 0
          },
          "total_is_approximate": {
            "type": "boolean",
            "description": "When true, `total` is a rough estimate rather than an exact count."
          }
        }
      },
      "PaginatedResponse_ArticleResponse": {
        "type": "object",
        "description": "Generic paginated API response.\n\n`total` represents the total number of items available for the current query.\nWhen `total_is_approximate` is true, `total` is a planner estimate from `EXPLAIN`, not an exact count.",
        "required": [
          "total",
          "page",
          "page_size",
          "data"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "Single article returned by the public API.",
              "required": [
                "id",
                "title",
                "short_description",
                "source_link",
                "vulnerability_ids",
                "tags",
                "publication_date"
              ],
              "properties": {
                "id": {
                  "type": "integer",
                  "format": "int64"
                },
                "publication_date": {
                  "type": "string",
                  "format": "date-time"
                },
                "short_description": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/MultilingualDescription"
                  }
                },
                "source_id": {
                  "type": [
                    "integer",
                    "null"
                  ],
                  "format": "int64",
                  "description": "Linked article source. Null when the article is not attached to a source."
                },
                "source_link": {
                  "type": "string"
                },
                "tags": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "title": {
                  "type": "string"
                },
                "vulnerability_ids": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "page": {
            "type": "integer",
            "format": "int64",
            "description": "Current page number (1-indexed)",
            "minimum": 0
          },
          "page_size": {
            "type": "integer",
            "format": "int64",
            "description": "Number of items per page",
            "minimum": 0
          },
          "total": {
            "type": "integer",
            "format": "int64",
            "description": "Total number of items",
            "minimum": 0
          },
          "total_is_approximate": {
            "type": "boolean",
            "description": "When true, `total` is a rough estimate rather than an exact count."
          }
        }
      },
      "PaginatedResponse_MonitorVulnerabilityResponse": {
        "type": "object",
        "description": "Generic paginated API response.\n\n`total` represents the total number of items available for the current query.\nWhen `total_is_approximate` is true, `total` is a planner estimate from `EXPLAIN`, not an exact count.",
        "required": [
          "total",
          "page",
          "page_size",
          "data"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "Represents a vulnerability in the monitor API response.",
              "required": [
                "vulnerability_id",
                "alternative_ids",
                "descriptions",
                "watchlists",
                "action_plan_id",
                "published_date",
                "vulnerability_title",
                "tags",
                "products",
                "estimated"
              ],
              "properties": {
                "action_plan_id": {
                  "type": "integer",
                  "format": "int64",
                  "description": "Action plan ID that links this vulnerability in the monitor context"
                },
                "alternative_ids": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Alternative IDs of the vulnerability"
                },
                "beescore": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "format": "double",
                  "description": "Beescore (personalized prioritization score) for this vulnerability in the action plan context"
                },
                "cvss_score": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "format": "double",
                  "description": "CVSS score from the personalized score"
                },
                "cvss_vector": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "CVSS vector from the personalized score"
                },
                "descriptions": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/MultilingualDescription"
                  },
                  "description": "Descriptions of the vulnerability (multilingual)"
                },
                "epss_score": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "format": "float",
                  "description": "EPSS score from the personalized score (when a CVE/EPSS row is available)"
                },
                "estimated": {
                  "type": "boolean",
                  "description": "Have score components been estimated?"
                },
                "products": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ShortProductResponse"
                  },
                  "description": "Product specifications of the vulnerability"
                },
                "published_date": {
                  "type": "string",
                  "format": "date-time",
                  "description": "Publication date"
                },
                "tags": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Tags of the vulnerability"
                },
                "vulnerability_id": {
                  "type": "string",
                  "description": "Sentibee vulnerability ID (e.g., \"STB-2025-1234\")"
                },
                "vulnerability_title": {
                  "type": "string",
                  "description": "Title of the vulnerability"
                },
                "watchlists": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/MonitorWatchlistResponse"
                  },
                  "description": "Associated watchlist IDs and names"
                }
              }
            }
          },
          "page": {
            "type": "integer",
            "format": "int64",
            "description": "Current page number (1-indexed)",
            "minimum": 0
          },
          "page_size": {
            "type": "integer",
            "format": "int64",
            "description": "Number of items per page",
            "minimum": 0
          },
          "total": {
            "type": "integer",
            "format": "int64",
            "description": "Total number of items",
            "minimum": 0
          },
          "total_is_approximate": {
            "type": "boolean",
            "description": "When true, `total` is a rough estimate rather than an exact count."
          }
        }
      },
      "PaginatedResponse_PackageResponse": {
        "type": "object",
        "description": "Generic paginated API response.\n\n`total` represents the total number of items available for the current query.\nWhen `total_is_approximate` is true, `total` is a planner estimate from `EXPLAIN`, not an exact count.",
        "required": [
          "total",
          "page",
          "page_size",
          "data"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "Package catalog row for list and detail views.",
              "required": [
                "id",
                "package_uid",
                "name",
                "package_manager",
                "distro_family",
                "distro_name",
                "refs",
                "aliases",
                "status",
                "created_at",
                "updated_at",
                "last_ingested_at"
              ],
              "properties": {
                "aliases": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "architecture": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "created_at": {
                  "type": "string",
                  "format": "date-time"
                },
                "distro_family": {
                  "type": "string"
                },
                "distro_name": {
                  "type": "string"
                },
                "homepage": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "id": {
                  "type": "integer",
                  "format": "int32"
                },
                "last_ingested_at": {
                  "type": "string",
                  "format": "date-time"
                },
                "name": {
                  "type": "string"
                },
                "package_manager": {
                  "type": "string"
                },
                "package_uid": {
                  "type": "string"
                },
                "purl": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "refs": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Reference"
                  }
                },
                "short_description": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "source_package_name": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "status": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string",
                  "format": "date-time"
                },
                "upstream_name": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "upstream_product_id": {
                  "type": [
                    "integer",
                    "null"
                  ],
                  "format": "int32"
                }
              }
            }
          },
          "page": {
            "type": "integer",
            "format": "int64",
            "description": "Current page number (1-indexed)",
            "minimum": 0
          },
          "page_size": {
            "type": "integer",
            "format": "int64",
            "description": "Number of items per page",
            "minimum": 0
          },
          "total": {
            "type": "integer",
            "format": "int64",
            "description": "Total number of items",
            "minimum": 0
          },
          "total_is_approximate": {
            "type": "boolean",
            "description": "When true, `total` is a rough estimate rather than an exact count."
          }
        }
      },
      "PaginatedResponse_PackageVersionResponse": {
        "type": "object",
        "description": "Generic paginated API response.\n\n`total` represents the total number of items available for the current query.\nWhen `total_is_approximate` is true, `total` is a planner estimate from `EXPLAIN`, not an exact count.",
        "required": [
          "total",
          "page",
          "page_size",
          "data"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "One shipped package version.",
              "required": [
                "id",
                "package_id",
                "package_version",
                "version_convention",
                "is_yanked",
                "is_obsolete",
                "created_at",
                "updated_at"
              ],
              "properties": {
                "architecture": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "created_at": {
                  "type": "string",
                  "format": "date-time"
                },
                "distro_version": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "epoch": {
                  "type": [
                    "integer",
                    "null"
                  ],
                  "format": "int32"
                },
                "id": {
                  "type": "integer",
                  "format": "int64"
                },
                "is_obsolete": {
                  "type": "boolean"
                },
                "is_yanked": {
                  "type": "boolean"
                },
                "package_id": {
                  "type": "integer",
                  "format": "int32"
                },
                "package_version": {
                  "type": "string"
                },
                "patch_level": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "released_at": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "format": "date-time"
                },
                "revision": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "updated_at": {
                  "type": "string",
                  "format": "date-time"
                },
                "version_convention": {
                  "$ref": "#/components/schemas/VersionConvention"
                }
              }
            }
          },
          "page": {
            "type": "integer",
            "format": "int64",
            "description": "Current page number (1-indexed)",
            "minimum": 0
          },
          "page_size": {
            "type": "integer",
            "format": "int64",
            "description": "Number of items per page",
            "minimum": 0
          },
          "total": {
            "type": "integer",
            "format": "int64",
            "description": "Total number of items",
            "minimum": 0
          },
          "total_is_approximate": {
            "type": "boolean",
            "description": "When true, `total` is a rough estimate rather than an exact count."
          }
        }
      },
      "PaginatedResponse_ProductResponse": {
        "type": "object",
        "description": "Generic paginated API response.\n\n`total` represents the total number of items available for the current query.\nWhen `total_is_approximate` is true, `total` is a planner estimate from `EXPLAIN`, not an exact count.",
        "required": [
          "total",
          "page",
          "page_size",
          "data"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "Represents a product in the API response.",
              "required": [
                "id",
                "name",
                "aliases",
                "cpe_names",
                "descriptions",
                "tags"
              ],
              "properties": {
                "aliases": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Aliases of the product"
                },
                "cpe_names": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Names of the product as specified in the Common Platform Enumeration (CPE) format"
                },
                "creation_date": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "format": "date-time",
                  "description": "Creation date of the product"
                },
                "descriptions": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/MultilingualDescription"
                  },
                  "description": "Descriptions for the product"
                },
                "id": {
                  "type": "integer",
                  "format": "int32",
                  "description": "Unique identifier for the product"
                },
                "is_group": {
                  "type": "boolean",
                  "description": "True when this product stands for other products."
                },
                "last_update_date": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "format": "date-time",
                  "description": "Last update date of the product"
                },
                "logo": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Logo URL for the product"
                },
                "name": {
                  "type": "string",
                  "description": "Name of the product"
                },
                "parent_product_id": {
                  "type": [
                    "integer",
                    "null"
                  ],
                  "format": "int32",
                  "description": "Parent product, when this product is an edition of another."
                },
                "parent_product_name": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Name of the parent product."
                },
                "tags": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Tags associated with the product"
                },
                "vendor_id": {
                  "type": [
                    "integer",
                    "null"
                  ],
                  "format": "int32",
                  "description": "ID of the vendor (if any)"
                },
                "vendor_name": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Name of the vendor (if any)"
                }
              }
            }
          },
          "page": {
            "type": "integer",
            "format": "int64",
            "description": "Current page number (1-indexed)",
            "minimum": 0
          },
          "page_size": {
            "type": "integer",
            "format": "int64",
            "description": "Number of items per page",
            "minimum": 0
          },
          "total": {
            "type": "integer",
            "format": "int64",
            "description": "Total number of items",
            "minimum": 0
          },
          "total_is_approximate": {
            "type": "boolean",
            "description": "When true, `total` is a rough estimate rather than an exact count."
          }
        }
      },
      "PaginatedResponse_ShareLinkResponse": {
        "type": "object",
        "description": "Generic paginated API response.\n\n`total` represents the total number of items available for the current query.\nWhen `total_is_approximate` is true, `total` is a planner estimate from `EXPLAIN`, not an exact count.",
        "required": [
          "total",
          "page",
          "page_size",
          "data"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "Metadata returned after create / list / revoke.",
              "required": [
                "share_key",
                "object_type",
                "object_id",
                "created_at",
                "expires_at"
              ],
              "properties": {
                "created_at": {
                  "type": "string",
                  "format": "date-time"
                },
                "expires_at": {
                  "type": "string",
                  "format": "date-time"
                },
                "object_id": {
                  "type": "string"
                },
                "object_type": {
                  "$ref": "#/components/schemas/ShareObjectTypeDto"
                },
                "revoked_at": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "format": "date-time"
                },
                "share_key": {
                  "type": "string"
                }
              }
            }
          },
          "page": {
            "type": "integer",
            "format": "int64",
            "description": "Current page number (1-indexed)",
            "minimum": 0
          },
          "page_size": {
            "type": "integer",
            "format": "int64",
            "description": "Number of items per page",
            "minimum": 0
          },
          "total": {
            "type": "integer",
            "format": "int64",
            "description": "Total number of items",
            "minimum": 0
          },
          "total_is_approximate": {
            "type": "boolean",
            "description": "When true, `total` is a rough estimate rather than an exact count."
          }
        }
      },
      "PaginatedResponse_VendorResponse": {
        "type": "object",
        "description": "Generic paginated API response.\n\n`total` represents the total number of items available for the current query.\nWhen `total_is_approximate` is true, `total` is a planner estimate from `EXPLAIN`, not an exact count.",
        "required": [
          "total",
          "page",
          "page_size",
          "data"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "Represents a vendor in the API response (summary view for listings).",
              "required": [
                "id",
                "name",
                "cpe_name",
                "product_count",
                "refs",
                "vulnerability_count",
                "tags"
              ],
              "properties": {
                "cpe_name": {
                  "type": "string",
                  "description": "Name of the vendor as specified in the Common Platform Enumeration (CPE) format"
                },
                "id": {
                  "type": "integer",
                  "format": "int32",
                  "description": "Unique identifier for the vendor"
                },
                "is_group": {
                  "type": "boolean",
                  "description": "True when this vendor stands for other vendors."
                },
                "name": {
                  "type": "string",
                  "description": "Displayable name of the vendor"
                },
                "product_count": {
                  "type": "integer",
                  "format": "int64",
                  "description": "Number of products associated with the vendor"
                },
                "refs": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Reference"
                  },
                  "description": "References for the vendor"
                },
                "tags": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Tags associated with the vendor"
                },
                "vulnerability_count": {
                  "type": "integer",
                  "format": "int64",
                  "description": "Number of vulnerabilities associated with the vendor"
                }
              }
            }
          },
          "page": {
            "type": "integer",
            "format": "int64",
            "description": "Current page number (1-indexed)",
            "minimum": 0
          },
          "page_size": {
            "type": "integer",
            "format": "int64",
            "description": "Number of items per page",
            "minimum": 0
          },
          "total": {
            "type": "integer",
            "format": "int64",
            "description": "Total number of items",
            "minimum": 0
          },
          "total_is_approximate": {
            "type": "boolean",
            "description": "When true, `total` is a rough estimate rather than an exact count."
          }
        }
      },
      "PaginatedResponse_Version": {
        "type": "object",
        "description": "Generic paginated API response.\n\n`total` represents the total number of items available for the current query.\nWhen `total_is_approximate` is true, `total` is a planner estimate from `EXPLAIN`, not an exact count.",
        "required": [
          "total",
          "page",
          "page_size",
          "data"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "Represents the version of a product. Versions objects are composed of a convention (Semver, others) and a value.\nThey may also contain a reference to a previous and a next version of the product to allow for version history.",
              "required": [
                "version_convention",
                "version_value"
              ],
              "properties": {
                "eoas_from": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "format": "date",
                  "description": "End of active support."
                },
                "eoes_from": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "format": "date",
                  "description": "End of expanded security support. Does not suppress EOL alerts."
                },
                "eol_cycle": {
                  "oneOf": [
                    {
                      "type": "null"
                    },
                    {
                      "$ref": "#/components/schemas/EolCycleLink",
                      "description": "endoflife.date product slug and cycle name."
                    }
                  ]
                },
                "eol_from": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "format": "date",
                  "description": "Date standard security support ends."
                },
                "eol_locked": {
                  "type": "boolean",
                  "description": "When true, catalog sync will not overwrite these EOL fields."
                },
                "is_eol": {
                  "type": [
                    "boolean",
                    "null"
                  ],
                  "description": "Whether the version is EOL (End of Life)"
                },
                "next_version": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Next version of the product"
                },
                "previous_version": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Previous version of the product"
                },
                "status": {
                  "oneOf": [
                    {
                      "type": "null"
                    },
                    {
                      "$ref": "#/components/schemas/ProductStatus",
                      "description": "Status of the version (affected, unaffected, unknown)"
                    }
                  ]
                },
                "version_convention": {
                  "$ref": "#/components/schemas/VersionConvention",
                  "description": "Convention used for the versionning"
                },
                "version_value": {
                  "type": "string",
                  "description": "Value of the version"
                }
              }
            }
          },
          "page": {
            "type": "integer",
            "format": "int64",
            "description": "Current page number (1-indexed)",
            "minimum": 0
          },
          "page_size": {
            "type": "integer",
            "format": "int64",
            "description": "Number of items per page",
            "minimum": 0
          },
          "total": {
            "type": "integer",
            "format": "int64",
            "description": "Total number of items",
            "minimum": 0
          },
          "total_is_approximate": {
            "type": "boolean",
            "description": "When true, `total` is a rough estimate rather than an exact count."
          }
        }
      },
      "PaginatedResponse_VulnerabilityResponse": {
        "type": "object",
        "description": "Generic paginated API response.\n\n`total` represents the total number of items available for the current query.\nWhen `total_is_approximate` is true, `total` is a planner estimate from `EXPLAIN`, not an exact count.",
        "required": [
          "total",
          "page",
          "page_size",
          "data"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "Represents a vulnerability in the API response.",
              "required": [
                "vulnerability_id",
                "title",
                "descriptions",
                "modification_date",
                "creation_date",
                "alternative_ids",
                "tags",
                "products",
                "estimated"
              ],
              "properties": {
                "alternative_ids": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Alternative IDs of the vulnerability"
                },
                "beescore": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "format": "double",
                  "description": "Beescore (personalized prioritization score) for this vulnerability in the action plan context"
                },
                "creation_date": {
                  "type": "string",
                  "format": "date-time",
                  "description": "Creation date of the vulnerability"
                },
                "cvss_score": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "format": "double",
                  "description": "CVSS score from the personalized score"
                },
                "cvss_vector": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "CVSS vector from the personalized score"
                },
                "descriptions": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/MultilingualDescription"
                  },
                  "description": "Descriptions of the vulnerability (multilingual)"
                },
                "epss_score": {
                  "type": [
                    "number",
                    "null"
                  ],
                  "format": "float",
                  "description": "EPSS score from the personalized score (when a CVE/EPSS row is available)"
                },
                "estimated": {
                  "type": "boolean",
                  "description": "Have score components been estimated?"
                },
                "modification_date": {
                  "type": "string",
                  "format": "date-time",
                  "description": "Modification date of the vulnerability"
                },
                "products": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/ShortProductResponse"
                  },
                  "description": "Product specifications of the vulnerability"
                },
                "published_date": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "format": "date-time",
                  "description": "Publication date of the vulnerability (if published)"
                },
                "tags": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Tags of the vulnerability"
                },
                "title": {
                  "type": "string",
                  "description": "Title of the vulnerability"
                },
                "vulnerability_id": {
                  "type": "string",
                  "description": "Sentibee vulnerability ID (e.g., \"STB-2025-1234\")"
                }
              }
            }
          },
          "page": {
            "type": "integer",
            "format": "int64",
            "description": "Current page number (1-indexed)",
            "minimum": 0
          },
          "page_size": {
            "type": "integer",
            "format": "int64",
            "description": "Number of items per page",
            "minimum": 0
          },
          "total": {
            "type": "integer",
            "format": "int64",
            "description": "Total number of items",
            "minimum": 0
          },
          "total_is_approximate": {
            "type": "boolean",
            "description": "When true, `total` is a rough estimate rather than an exact count."
          }
        }
      },
      "PaginatedResponse_WatchlistConsentResponse": {
        "type": "object",
        "description": "Generic paginated API response.\n\n`total` represents the total number of items available for the current query.\nWhen `total_is_approximate` is true, `total` is a planner estimate from `EXPLAIN`, not an exact count.",
        "required": [
          "total",
          "page",
          "page_size",
          "data"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "A watchlist consent grant returned to the customer organization.",
              "required": [
                "id",
                "watchlist_id",
                "organization_id",
                "permissions",
                "duration_days",
                "expires_at",
                "created_at"
              ],
              "properties": {
                "backoffice_task_id": {
                  "type": [
                    "integer",
                    "null"
                  ],
                  "format": "int64",
                  "description": "Open backoffice assistance task linked to this grant, if any."
                },
                "created_at": {
                  "type": "string",
                  "format": "date-time",
                  "description": "UTC timestamp when the grant was created."
                },
                "duration_days": {
                  "type": "integer",
                  "format": "int32",
                  "description": "Requested duration in days (7, 14, or 30)."
                },
                "expires_at": {
                  "type": "string",
                  "format": "date-time",
                  "description": "UTC timestamp when the grant expires."
                },
                "id": {
                  "type": "integer",
                  "format": "int64",
                  "description": "Unique identifier of the consent grant."
                },
                "organization_id": {
                  "type": "integer",
                  "format": "int32",
                  "description": "Customer organization that issued the grant."
                },
                "permissions": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/WatchlistConsentPermission"
                  },
                  "description": "Permissions granted to the backoffice team."
                },
                "reason": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Optional reason provided by the customer."
                },
                "revoked_at": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "format": "date-time",
                  "description": "UTC timestamp when the grant was revoked, if applicable."
                },
                "watchlist_id": {
                  "type": "integer",
                  "format": "int32",
                  "description": "Watchlist the grant applies to."
                }
              }
            }
          },
          "page": {
            "type": "integer",
            "format": "int64",
            "description": "Current page number (1-indexed)",
            "minimum": 0
          },
          "page_size": {
            "type": "integer",
            "format": "int64",
            "description": "Number of items per page",
            "minimum": 0
          },
          "total": {
            "type": "integer",
            "format": "int64",
            "description": "Total number of items",
            "minimum": 0
          },
          "total_is_approximate": {
            "type": "boolean",
            "description": "When true, `total` is a rough estimate rather than an exact count."
          }
        }
      },
      "PaginatedResponse_WatchlistImportJobResponse": {
        "type": "object",
        "description": "Generic paginated API response.\n\n`total` represents the total number of items available for the current query.\nWhen `total_is_approximate` is true, `total` is a planner estimate from `EXPLAIN`, not an exact count.",
        "required": [
          "total",
          "page",
          "page_size",
          "data"
        ],
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "description": "Import job summary for list/detail responses.",
              "required": [
                "id",
                "watchlist_id",
                "status",
                "file_name",
                "file_mime",
                "file_size_bytes",
                "progress_percent",
                "commit_mode",
                "total_rows",
                "valid_count",
                "warning_count",
                "error_count",
                "created_at",
                "updated_at",
                "expires_at"
              ],
              "properties": {
                "commit_mode": {
                  "$ref": "#/components/schemas/WatchlistImportCommitMode"
                },
                "created_at": {
                  "type": "string",
                  "format": "date-time"
                },
                "error_count": {
                  "type": "integer",
                  "format": "int32"
                },
                "error_message": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "expires_at": {
                  "type": "string",
                  "format": "date-time"
                },
                "file_mime": {
                  "type": "string"
                },
                "file_name": {
                  "type": "string"
                },
                "file_size_bytes": {
                  "type": "integer",
                  "format": "int64"
                },
                "id": {
                  "type": "string",
                  "format": "uuid"
                },
                "mappings": {
                  "oneOf": [
                    {
                      "type": "null"
                    },
                    {
                      "$ref": "#/components/schemas/WatchlistImportMappings"
                    }
                  ]
                },
                "preview_summary": {
                  "oneOf": [
                    {
                      "type": "null"
                    },
                    {
                      "$ref": "#/components/schemas/WatchlistImportPreviewSummary"
                    }
                  ]
                },
                "progress_message": {
                  "type": [
                    "string",
                    "null"
                  ]
                },
                "progress_percent": {
                  "type": "integer",
                  "format": "int32"
                },
                "status": {
                  "$ref": "#/components/schemas/WatchlistImportJobStatus"
                },
                "total_rows": {
                  "type": "integer",
                  "format": "int32"
                },
                "updated_at": {
                  "type": "string",
                  "format": "date-time"
                },
                "valid_count": {
                  "type": "integer",
                  "format": "int32"
                },
                "warning_count": {
                  "type": "integer",
                  "format": "int32"
                },
                "watchlist_id": {
                  "type": "integer",
                  "format": "int32"
                }
              }
            }
          },
          "page": {
            "type": "integer",
            "format": "int64",
            "description": "Current page number (1-indexed)",
            "minimum": 0
          },
          "page_size": {
            "type": "integer",
            "format": "int64",
            "description": "Number of items per page",
            "minimum": 0
          },
          "total": {
            "type": "integer",
            "format": "int64",
            "description": "Total number of items",
            "minimum": 0
          },
          "total_is_approximate": {
            "type": "boolean",
            "description": "When true, `total` is a rough estimate rather than an exact count."
          }
        }
      },
      "PaginationQuery": {
        "type": "object",
        "description": "Shared query fragment for offset-based pagination (`page` is 1-indexed).",
        "properties": {
          "page": {
            "type": "integer",
            "format": "int64",
            "description": "Page number (1-indexed). Defaults to 1.",
            "minimum": 0
          },
          "page_size": {
            "type": "integer",
            "format": "int64",
            "description": "Number of items per page. Defaults to 20.",
            "minimum": 0
          }
        }
      },
      "PatchImportRowUpdate": {
        "type": "object",
        "required": [
          "row_id"
        ],
        "properties": {
          "criticality": {
            "type": [
              "string",
              "null"
            ],
            "description": "When present, updates criticality (`null` clears the value)."
          },
          "discarded": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "When set, updates whether the row is excluded from commit."
          },
          "exposure": {
            "type": [
              "string",
              "null"
            ],
            "description": "When present, updates exposure (`null` clears the value)."
          },
          "resolved_product_id": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Catalog product ID selected for this row."
          },
          "resolved_vendor_id": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Catalog vendor ID selected for this row (vendor-only rows)."
          },
          "row_id": {
            "type": "string",
            "format": "uuid"
          },
          "version_raw": {
            "type": [
              "string",
              "null"
            ],
            "description": "Version string for this row (product rows only affects the proposed watchlist item)."
          }
        }
      },
      "PatchImportRowsRequest": {
        "type": "object",
        "required": [
          "rows"
        ],
        "properties": {
          "rows": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PatchImportRowUpdate"
            }
          }
        }
      },
      "PatchImportRowsResponse": {
        "type": "object",
        "required": [
          "job",
          "rows"
        ],
        "properties": {
          "job": {
            "$ref": "#/components/schemas/WatchlistImportJobResponse"
          },
          "rows": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/WatchlistImportDraftRowResponse"
            }
          }
        }
      },
      "PeriodDto": {
        "type": "object",
        "required": [
          "from",
          "to"
        ],
        "properties": {
          "from": {
            "type": "string",
            "format": "date-time"
          },
          "to": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "PlanLimitOverrides": {
        "type": "object",
        "description": "Per-field flags. `true` keeps the org value when the pricing catalog changes.",
        "properties": {
          "api_burst": {
            "type": "boolean"
          },
          "api_requests_per_hour": {
            "type": "boolean"
          },
          "api_requests_per_month": {
            "type": "boolean"
          },
          "assistance_requests_included_total": {
            "type": "boolean"
          },
          "assistance_requests_per_month": {
            "type": "boolean"
          },
          "can_configure_webhook_notifiers": {
            "type": "boolean"
          },
          "can_create_api_keys": {
            "type": "boolean"
          },
          "can_create_share_links": {
            "type": "boolean"
          },
          "can_edit_action_plans": {
            "type": "boolean"
          },
          "can_export_dashboards": {
            "type": "boolean"
          },
          "can_import_watchlist": {
            "type": "boolean"
          },
          "can_request_action_plan_assistance": {
            "type": "boolean"
          },
          "can_use_custom_branding": {
            "type": "boolean"
          },
          "can_use_immediate_notifications": {
            "type": "boolean"
          },
          "can_use_personalized_dashboards": {
            "type": "boolean"
          },
          "can_use_rbac": {
            "type": "boolean"
          },
          "can_use_sso": {
            "type": "boolean"
          },
          "max_action_plan_changes_per_month": {
            "type": "boolean"
          },
          "max_packages": {
            "type": "boolean"
          },
          "max_products": {
            "type": "boolean"
          },
          "max_scopes": {
            "type": "boolean"
          },
          "max_users": {
            "type": "boolean"
          },
          "max_vendors": {
            "type": "boolean"
          },
          "trial_period_days": {
            "type": "boolean"
          }
        }
      },
      "PriorizationLevel": {
        "type": "string",
        "description": "The levels of priorization for remediating a vulnerability.\n\nNamed after the SSVC deployer outcomes: Defer, Scheduled, Out-of-Cycle, Immediate.",
        "enum": [
          "Defer",
          "Scheduled",
          "OutOfCycle",
          "Immediate"
        ]
      },
      "ProductDetailResponse": {
        "type": "object",
        "description": "Represents a product with full details in the API response.",
        "required": [
          "id",
          "name",
          "aliases",
          "cpe_names",
          "descriptions",
          "tags",
          "refs",
          "websites",
          "versions",
          "subproducts"
        ],
        "properties": {
          "aliases": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Aliases of the product"
          },
          "cpe_names": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Names of the product as specified in the Common Platform Enumeration (CPE) format"
          },
          "cpes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Full CPE 2.2/2.3 strings linked to this product"
          },
          "creation_date": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Creation date of the product"
          },
          "descriptions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MultilingualDescription"
            },
            "description": "Descriptions for the product"
          },
          "group_members": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ProductRelationResponse"
            },
            "description": "Products this group matches. Empty for a normal product."
          },
          "id": {
            "type": "integer",
            "format": "int32",
            "description": "Unique identifier for the product"
          },
          "is_group": {
            "type": "boolean",
            "description": "True when this product stands for other products."
          },
          "last_update_date": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Last update date of the product"
          },
          "logo": {
            "type": [
              "string",
              "null"
            ],
            "description": "Logo URL for the product"
          },
          "name": {
            "type": "string",
            "description": "Name of the product"
          },
          "parent_product_id": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Parent product, when this product is an edition of another."
          },
          "parent_product_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Name of the parent product."
          },
          "refs": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Reference"
            },
            "description": "References for the product"
          },
          "subproducts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ProductRelationResponse"
            },
            "description": "Direct subproducts of this product."
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Tags associated with the product"
          },
          "vendor_id": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "ID of the vendor (if any)"
          },
          "versions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Version"
            },
            "description": "Catalog versions are listed by `GET /api/v1/vendors/products/{id}/versions`. This field is empty."
          },
          "websites": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Websites associated with the product"
          }
        }
      },
      "ProductExposure": {
        "type": "string",
        "description": "Network exposure of a product in a watchlist.",
        "enum": [
          "RestrictedAdminNetwork",
          "LocalNetwork",
          "Internet",
          "LocalMachine"
        ]
      },
      "ProductRelationResponse": {
        "type": "object",
        "description": "A product referenced as a parent or direct subproduct.",
        "required": [
          "id",
          "name"
        ],
        "properties": {
          "id": {
            "type": "integer",
            "format": "int32",
            "description": "Unique identifier for the related product"
          },
          "name": {
            "type": "string",
            "description": "Name of the related product"
          }
        }
      },
      "ProductResponse": {
        "type": "object",
        "description": "Represents a product in the API response.",
        "required": [
          "id",
          "name",
          "aliases",
          "cpe_names",
          "descriptions",
          "tags"
        ],
        "properties": {
          "aliases": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Aliases of the product"
          },
          "cpe_names": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Names of the product as specified in the Common Platform Enumeration (CPE) format"
          },
          "creation_date": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Creation date of the product"
          },
          "descriptions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MultilingualDescription"
            },
            "description": "Descriptions for the product"
          },
          "id": {
            "type": "integer",
            "format": "int32",
            "description": "Unique identifier for the product"
          },
          "is_group": {
            "type": "boolean",
            "description": "True when this product stands for other products."
          },
          "last_update_date": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Last update date of the product"
          },
          "logo": {
            "type": [
              "string",
              "null"
            ],
            "description": "Logo URL for the product"
          },
          "name": {
            "type": "string",
            "description": "Name of the product"
          },
          "parent_product_id": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "Parent product, when this product is an edition of another."
          },
          "parent_product_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Name of the parent product."
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Tags associated with the product"
          },
          "vendor_id": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32",
            "description": "ID of the vendor (if any)"
          },
          "vendor_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Name of the vendor (if any)"
          }
        }
      },
      "ProductSortField": {
        "type": "string",
        "description": "Sort field options for products",
        "enum": [
          "name",
          "creation_date",
          "last_update_date"
        ]
      },
      "ProductSpecificationResponse": {
        "type": "object",
        "description": "Represents a product specification in the API response.",
        "required": [
          "product",
          "versions",
          "affected_status"
        ],
        "properties": {
          "affected_status": {
            "$ref": "#/components/schemas/ProductStatus",
            "description": "The affected status of the product for the vulnerability."
          },
          "beescore": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/Beescore",
                "description": "The beescore of the vulnerability for the product."
              }
            ]
          },
          "product": {
            "$ref": "#/components/schemas/ShortProductResponse",
            "description": "The product of the vulnerability product specification."
          },
          "versions": {
            "$ref": "#/components/schemas/AffectedVersions",
            "description": "The affected versions of the product for the vulnerability."
          }
        }
      },
      "ProductStatus": {
        "type": "string",
        "description": "Represents the affected status of a product for a vulnerability.",
        "enum": [
          "vulnerable",
          "not_vulnerable",
          "unknown"
        ]
      },
      "ProductTypeWatchlistItemResponse": {
        "type": "object",
        "required": [
          "product_type_id",
          "creation_date",
          "comment",
          "tags"
        ],
        "properties": {
          "comment": {
            "type": "string"
          },
          "creation_date": {
            "type": "string",
            "format": "date-time"
          },
          "product_type_id": {
            "type": "integer",
            "format": "int32"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "ProductWatchlistItemRequest": {
        "type": "object",
        "description": "Represents a product watchlist item request (without creation date).",
        "required": [
          "product_id",
          "criticality",
          "exposure",
          "comment",
          "tags",
          "version"
        ],
        "properties": {
          "comment": {
            "type": "string",
            "description": "Comment for the watchlist item"
          },
          "criticality": {
            "$ref": "#/components/schemas/WatchlistItemCriticality",
            "description": "Criticality of the product"
          },
          "exposure": {
            "$ref": "#/components/schemas/ProductExposure",
            "description": "Exposure of the product"
          },
          "product_id": {
            "type": "integer",
            "format": "int32",
            "description": "ID of the product"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Tags for the watchlist item"
          },
          "version": {
            "$ref": "#/components/schemas/WatchlistVersion",
            "description": "Version of the product that should be monitored"
          }
        }
      },
      "ProductWatchlistItemResponse": {
        "type": "object",
        "required": [
          "product_id",
          "criticality",
          "exposure",
          "creation_date",
          "comment",
          "tags",
          "version"
        ],
        "properties": {
          "comment": {
            "type": "string"
          },
          "creation_date": {
            "type": "string",
            "format": "date-time"
          },
          "criticality": {
            "$ref": "#/components/schemas/WatchlistItemCriticality"
          },
          "exposure": {
            "$ref": "#/components/schemas/ProductExposure"
          },
          "product_id": {
            "type": "integer",
            "format": "int32"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "version": {
            "$ref": "#/components/schemas/WatchlistVersion"
          }
        }
      },
      "RatioTrendCardDto": {
        "type": "object",
        "required": [
          "affected",
          "total_watchlist_products",
          "previous_affected",
          "deep_link"
        ],
        "properties": {
          "affected": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "deep_link": {
            "$ref": "#/components/schemas/DeepLinkDto"
          },
          "previous_affected": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "total_watchlist_products": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          }
        }
      },
      "RefTag": {
        "oneOf": [
          {
            "type": "string",
            "enum": [
              "primary-reference"
            ]
          },
          {
            "type": "string",
            "enum": [
              "national-cert-advisory"
            ]
          },
          {
            "type": "string",
            "enum": [
              "vulnerability-database"
            ]
          },
          {
            "type": "string",
            "enum": [
              "repository"
            ]
          },
          {
            "type": "string",
            "enum": [
              "package-collection"
            ]
          },
          {
            "type": "object",
            "description": "CVE record tag value without the `cve:` prefix (serialized as `cve:{value}`).",
            "required": [
              "cve-record"
            ],
            "properties": {
              "cve-record": {
                "type": "string",
                "description": "CVE record tag value without the `cve:` prefix (serialized as `cve:{value}`)."
              }
            }
          },
          {
            "type": "string",
            "enum": [
              "featured"
            ]
          }
        ],
        "description": "Tag used to categorize references for automated use."
      },
      "Reference": {
        "type": "object",
        "description": "Reference to an external resource.",
        "required": [
          "url",
          "title",
          "tags"
        ],
        "properties": {
          "tags": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RefTag"
            },
            "description": "Tags giving additional context for automated use.",
            "uniqueItems": true
          },
          "title": {
            "type": "string",
            "description": "Title of the resource."
          },
          "url": {
            "type": "string",
            "description": "URL of the resource."
          }
        }
      },
      "ScopeConfigurationResponse": {
        "type": "object",
        "description": "Scope configuration returned in watchlist detail responses.",
        "required": [
          "configuration",
          "watchlist"
        ],
        "properties": {
          "configuration": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "propertyNames": {
              "type": "string"
            }
          },
          "watchlist": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/WatchlistItemResponse"
            }
          }
        }
      },
      "ScopeSensitivityLevel": {
        "type": "string",
        "description": "Sensitivity level for a watchlist scope.",
        "enum": [
          "Low",
          "Medium",
          "High"
        ]
      },
      "ScopeUserRole": {
        "type": "string",
        "description": "Represents the role of a user in a scope.",
        "enum": [
          "ScopeAdmin",
          "ScopeMember"
        ]
      },
      "SeriesGranularityDto": {
        "type": "string",
        "enum": [
          "day",
          "week"
        ]
      },
      "SeriesPointDto": {
        "type": "object",
        "required": [
          "bucket_start",
          "enters_vulnpilot",
          "affects_perimeter",
          "out_of_cycle_or_above",
          "by_processing_status"
        ],
        "properties": {
          "affects_perimeter": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "bucket_start": {
            "type": "string",
            "format": "date-time"
          },
          "by_processing_status": {
            "$ref": "#/components/schemas/SeriesStatusCountsDto"
          },
          "enters_vulnpilot": {
            "type": "integer",
            "format": "int64",
            "description": "Absolute additions to VulnPilot in this bucket (platform-wide, by `published_date`).",
            "minimum": 0
          },
          "out_of_cycle_or_above": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          }
        }
      },
      "SeriesStatusCountsDto": {
        "type": "object",
        "required": [
          "new",
          "pending",
          "ongoing",
          "completed",
          "dismissed"
        ],
        "properties": {
          "completed": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "dismissed": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "new": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "ongoing": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "pending": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          }
        }
      },
      "ShareActionPlanPayload": {
        "type": "object",
        "description": "Live action-plan payload for share retrieve.",
        "required": [
          "action_plan",
          "vulnerabilities"
        ],
        "properties": {
          "action_plan": {
            "$ref": "#/components/schemas/ActionPlanResponse"
          },
          "vulnerabilities": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ShareActionPlanVulnerabilityIds"
            }
          }
        }
      },
      "ShareActionPlanVulnerabilityIds": {
        "type": "object",
        "description": "Slim vulnerability identity for shared action plans.",
        "required": [
          "vulnerability_id",
          "alternative_ids"
        ],
        "properties": {
          "alternative_ids": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "vulnerability_id": {
            "type": "string"
          }
        }
      },
      "ShareLinkResponse": {
        "type": "object",
        "description": "Metadata returned after create / list / revoke.",
        "required": [
          "share_key",
          "object_type",
          "object_id",
          "created_at",
          "expires_at"
        ],
        "properties": {
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "expires_at": {
            "type": "string",
            "format": "date-time"
          },
          "object_id": {
            "type": "string"
          },
          "object_type": {
            "$ref": "#/components/schemas/ShareObjectTypeDto"
          },
          "revoked_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time"
          },
          "share_key": {
            "type": "string"
          }
        }
      },
      "ShareObjectTypeDto": {
        "type": "string",
        "description": "Shareable object kinds accepted by the create endpoint (v1).",
        "enum": [
          "vulnerability",
          "action_plan"
        ]
      },
      "ShareRetrieveResponse": {
        "oneOf": [
          {
            "type": "object",
            "required": [
              "object_id",
              "expires_at",
              "payload",
              "object_type"
            ],
            "properties": {
              "expires_at": {
                "type": "string",
                "format": "date-time"
              },
              "object_id": {
                "type": "string"
              },
              "object_type": {
                "type": "string",
                "enum": [
                  "vulnerability"
                ]
              },
              "payload": {
                "$ref": "#/components/schemas/VulnerabilityDetailedResponse"
              }
            }
          },
          {
            "type": "object",
            "required": [
              "object_id",
              "expires_at",
              "payload",
              "object_type"
            ],
            "properties": {
              "expires_at": {
                "type": "string",
                "format": "date-time"
              },
              "object_id": {
                "type": "string"
              },
              "object_type": {
                "type": "string",
                "enum": [
                  "action_plan"
                ]
              },
              "payload": {
                "$ref": "#/components/schemas/ShareActionPlanPayload"
              }
            }
          }
        ],
        "description": "Discriminated retrieve response: live object + remaining validity."
      },
      "ShortProductResponse": {
        "type": "object",
        "required": [
          "id",
          "name",
          "vendor_id",
          "vendor_name"
        ],
        "properties": {
          "id": {
            "type": "integer",
            "format": "int32",
            "description": "The ID of the product"
          },
          "name": {
            "type": "string",
            "description": "The name of the product"
          },
          "vendor_id": {
            "type": "integer",
            "format": "int32",
            "description": "The vendor ID of the product"
          },
          "vendor_name": {
            "type": "string",
            "description": "The vendor name of the product"
          }
        }
      },
      "TrendCardDto": {
        "type": "object",
        "required": [
          "value",
          "previous",
          "deep_link"
        ],
        "properties": {
          "deep_link": {
            "$ref": "#/components/schemas/DeepLinkDto"
          },
          "previous": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "value": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          }
        }
      },
      "UpdateActionPlanContentRequest": {
        "type": "object",
        "description": "Partial update of editable action plan content fields.\n\nAll fields are optional; omitted fields are left unchanged.\nProcessing status must be changed via `PUT .../processing_status`.\nIdentity fields (id, watchlist, creation time) are immutable.",
        "properties": {
          "descriptions": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/MultilingualDescription"
            },
            "description": "Updated multilingual descriptions / remediation body"
          },
          "tags": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Updated tags"
          },
          "tasks": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/ActionPlanTask"
            },
            "description": "Updated task list"
          },
          "title": {
            "type": [
              "string",
              "null"
            ],
            "description": "Updated title of the action plan"
          }
        }
      },
      "UpdateImportMappingsRequest": {
        "type": "object",
        "required": [
          "mappings"
        ],
        "properties": {
          "commit_mode": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/WatchlistImportCommitMode"
              }
            ]
          },
          "locked_columns": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Column headers the user locked against auto-mapping overrides."
          },
          "mapping_template_id": {
            "type": [
              "string",
              "null"
            ],
            "format": "uuid",
            "description": "When set on upload or mapping update, parse uses this template's locked columns."
          },
          "mappings": {
            "$ref": "#/components/schemas/WatchlistImportMappings"
          },
          "save_template_name": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      },
      "UpdateOrganizationRequest": {
        "type": "object",
        "description": "Represents the request to update an organization.",
        "properties": {
          "configuration": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/OrganizationConfiguration",
                "description": "Organization settings to update."
              }
            ]
          },
          "name": {
            "type": [
              "string",
              "null"
            ],
            "description": "The name of the organization."
          }
        }
      },
      "UpdateProcessingStatusRequest": {
        "type": "object",
        "description": "Request body for updating an action plan's processing status.",
        "required": [
          "processing_status"
        ],
        "properties": {
          "processing_status": {
            "$ref": "#/components/schemas/BulletinProcessingStatus",
            "description": "The new processing status: new, pending, ongoing, completed, or dismissed"
          }
        }
      },
      "UpdateWatchlistRequest": {
        "type": "object",
        "description": "Represents the request to update a watchlist.",
        "properties": {
          "asset_types": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "Asset types of interest for the watchlist"
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Description of the watchlist"
          },
          "enable_processing": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether to enable action plan processing status for the watchlist"
          },
          "name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Name of the watchlist"
          },
          "sensitivity_level": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/ScopeSensitivityLevel",
                "description": "Sensitivity level for the watchlist, this is used to set thresholds to adjust the priorization scoring process."
              }
            ]
          }
        }
      },
      "UserIdentityResponse": {
        "type": "object",
        "description": "User identity attributes exposed by the API.",
        "required": [
          "identity_elems"
        ],
        "properties": {
          "identity_elems": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "propertyNames": {
              "type": "string"
            }
          }
        }
      },
      "UserResponse": {
        "type": "object",
        "description": "Represents the properties of a user as returned by the public API.",
        "required": [
          "id",
          "name",
          "surname",
          "email",
          "locale",
          "role",
          "organization",
          "created_at",
          "updated_at",
          "permissions",
          "enabled",
          "user_identity"
        ],
        "properties": {
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "email": {
            "type": "string"
          },
          "enabled": {
            "type": "boolean"
          },
          "id": {
            "type": "integer",
            "format": "int32"
          },
          "idp_id": {
            "type": [
              "string",
              "null"
            ],
            "format": "uuid"
          },
          "locale": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "organization": {
            "$ref": "#/components/schemas/OrganizationResponse"
          },
          "permissions": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "phone_number": {
            "type": [
              "string",
              "null"
            ]
          },
          "role": {
            "$ref": "#/components/schemas/UserRoleResponse"
          },
          "surname": {
            "type": "string"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "user_identity": {
            "$ref": "#/components/schemas/UserIdentityResponse"
          }
        }
      },
      "UserRoleForChange": {
        "type": "string",
        "description": "Represents the new role an organization admin can assign to a user.",
        "enum": [
          "OrganizationAdmin",
          "ScopeAdmin",
          "ScopeMember"
        ]
      },
      "UserRoleResponse": {
        "type": "string",
        "enum": [
          "organization_admin",
          "scope_admin",
          "scope_member",
          "backoffice_admin",
          "backoffice_user",
          "service_admin",
          "service_user",
          "basic_user",
          "guest_user",
          "other"
        ]
      },
      "UserSummaryResponse": {
        "type": "object",
        "required": [
          "summary",
          "language",
          "created_at"
        ],
        "properties": {
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "language": {
            "type": "string"
          },
          "summary": {
            "type": "string"
          }
        }
      },
      "VendorBucketDto": {
        "type": "object",
        "required": [
          "vendor_id",
          "vendor_name",
          "count"
        ],
        "properties": {
          "count": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "vendor_id": {
            "type": "integer",
            "format": "int32"
          },
          "vendor_name": {
            "type": "string"
          }
        }
      },
      "VendorDetailResponse": {
        "type": "object",
        "description": "Represents a vendor with full details in the API response.",
        "required": [
          "id",
          "name",
          "cpe_name",
          "aliases",
          "refs",
          "websites",
          "tags"
        ],
        "properties": {
          "aliases": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Aliases of the vendor"
          },
          "cpe_name": {
            "type": "string",
            "description": "Name of the vendor as specified in the Common Platform Enumeration (CPE) format"
          },
          "group_members": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ProductRelationResponse"
            },
            "description": "Vendors this group matches. Empty for a normal vendor."
          },
          "id": {
            "type": "integer",
            "format": "int32",
            "description": "Unique identifier for the vendor"
          },
          "is_group": {
            "type": "boolean",
            "description": "True when this vendor stands for other vendors."
          },
          "name": {
            "type": "string",
            "description": "Displayable name of the vendor"
          },
          "refs": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Reference"
            },
            "description": "References for the vendor"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Tags associated with the vendor"
          },
          "websites": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Websites associated with the vendor"
          }
        }
      },
      "VendorResponse": {
        "type": "object",
        "description": "Represents a vendor in the API response (summary view for listings).",
        "required": [
          "id",
          "name",
          "cpe_name",
          "product_count",
          "refs",
          "vulnerability_count",
          "tags"
        ],
        "properties": {
          "cpe_name": {
            "type": "string",
            "description": "Name of the vendor as specified in the Common Platform Enumeration (CPE) format"
          },
          "id": {
            "type": "integer",
            "format": "int32",
            "description": "Unique identifier for the vendor"
          },
          "is_group": {
            "type": "boolean",
            "description": "True when this vendor stands for other vendors."
          },
          "name": {
            "type": "string",
            "description": "Displayable name of the vendor"
          },
          "product_count": {
            "type": "integer",
            "format": "int64",
            "description": "Number of products associated with the vendor"
          },
          "refs": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Reference"
            },
            "description": "References for the vendor"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Tags associated with the vendor"
          },
          "vulnerability_count": {
            "type": "integer",
            "format": "int64",
            "description": "Number of vulnerabilities associated with the vendor"
          }
        }
      },
      "VendorWatchlistItemRequest": {
        "type": "object",
        "description": "Represents a vendor watchlist item request (without creation date).",
        "required": [
          "vendor_id",
          "criticality",
          "comment",
          "tags"
        ],
        "properties": {
          "comment": {
            "type": "string",
            "description": "Comment for the watchlist item"
          },
          "criticality": {
            "$ref": "#/components/schemas/WatchlistItemCriticality",
            "description": "Criticality of the vendor"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Tags for the watchlist item"
          },
          "vendor_id": {
            "type": "integer",
            "format": "int32",
            "description": "ID of the vendor"
          }
        }
      },
      "VendorWatchlistItemResponse": {
        "type": "object",
        "required": [
          "vendor_id",
          "criticality",
          "creation_date",
          "comment",
          "tags"
        ],
        "properties": {
          "comment": {
            "type": "string"
          },
          "creation_date": {
            "type": "string",
            "format": "date-time"
          },
          "criticality": {
            "$ref": "#/components/schemas/WatchlistItemCriticality"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "vendor_id": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "Version": {
        "type": "object",
        "description": "Represents the version of a product. Versions objects are composed of a convention (Semver, others) and a value.\nThey may also contain a reference to a previous and a next version of the product to allow for version history.",
        "required": [
          "version_convention",
          "version_value"
        ],
        "properties": {
          "eoas_from": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "End of active support."
          },
          "eoes_from": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "End of expanded security support. Does not suppress EOL alerts."
          },
          "eol_cycle": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/EolCycleLink",
                "description": "endoflife.date product slug and cycle name."
              }
            ]
          },
          "eol_from": {
            "type": [
              "string",
              "null"
            ],
            "format": "date",
            "description": "Date standard security support ends."
          },
          "eol_locked": {
            "type": "boolean",
            "description": "When true, catalog sync will not overwrite these EOL fields."
          },
          "is_eol": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Whether the version is EOL (End of Life)"
          },
          "next_version": {
            "type": [
              "string",
              "null"
            ],
            "description": "Next version of the product"
          },
          "previous_version": {
            "type": [
              "string",
              "null"
            ],
            "description": "Previous version of the product"
          },
          "status": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/ProductStatus",
                "description": "Status of the version (affected, unaffected, unknown)"
              }
            ]
          },
          "version_convention": {
            "$ref": "#/components/schemas/VersionConvention",
            "description": "Convention used for the versionning"
          },
          "version_value": {
            "type": "string",
            "description": "Value of the version"
          }
        }
      },
      "VersionConvention": {
        "type": "string",
        "description": "Enumerates different version conventions used for software versioning",
        "enum": [
          "Semver",
          "Date",
          "Numeric",
          "GitCommitHash",
          "Pep440",
          "Maven",
          "RubyGems",
          "DottedNumeric",
          "OracleJava",
          "AlpineApk",
          "Rpm",
          "Debian",
          "Ubuntu",
          "Custom"
        ]
      },
      "VersionRangeResponse": {
        "type": "object",
        "description": "Version range for a product watchlist item.",
        "required": [
          "start_version",
          "end_version"
        ],
        "properties": {
          "end_version": {
            "$ref": "#/components/schemas/Version"
          },
          "start_version": {
            "$ref": "#/components/schemas/Version"
          }
        }
      },
      "VulnerabilityDetailedResponse": {
        "type": "object",
        "required": [
          "vulnerability_id",
          "title",
          "descriptions",
          "modification_date",
          "creation_date",
          "alternative_ids",
          "aliases",
          "refs",
          "tags",
          "product_specifications",
          "estimated"
        ],
        "properties": {
          "aliases": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Aliases of the vulnerability"
          },
          "alternative_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Alternative IDs of the vulnerability"
          },
          "beescore": {
            "type": [
              "number",
              "null"
            ],
            "format": "double",
            "description": "Personalized beescore when requested with `action_plan_id` (max in-scope personalized score)"
          },
          "creation_date": {
            "type": "string",
            "format": "date-time",
            "description": "Creation date of the vulnerability"
          },
          "cvss_score": {
            "type": [
              "number",
              "null"
            ],
            "format": "double",
            "description": "CVSS score from the personalized score (when `action_plan_id` is provided)"
          },
          "cvss_vector": {
            "type": [
              "string",
              "null"
            ],
            "description": "CVSS vector from the personalized score (when `action_plan_id` is provided)"
          },
          "descriptions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MultilingualDescription"
            },
            "description": "Descriptions of the vulnerability (multilingual)"
          },
          "estimated": {
            "type": "boolean",
            "description": "Have score components been estimated?"
          },
          "modification_date": {
            "type": "string",
            "format": "date-time",
            "description": "Modification date of the vulnerability"
          },
          "product_specifications": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ProductSpecificationResponse"
            },
            "description": "Product specifications of the vulnerability"
          },
          "published_date": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Publication date of the vulnerability (if published)"
          },
          "refs": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Reference"
            },
            "description": "References of the vulnerability"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Tags of the vulnerability"
          },
          "timeline_data": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "$ref": "#/components/schemas/VulnerabilityTimelineItem"
            },
            "description": "Timeline of the vulnerability"
          },
          "title": {
            "type": "string",
            "description": "Title of the vulnerability"
          },
          "vulnerability_id": {
            "type": "string",
            "description": "Sentibee vulnerability ID (e.g., \"STB-2025-1234\")"
          }
        }
      },
      "VulnerabilityResponse": {
        "type": "object",
        "description": "Represents a vulnerability in the API response.",
        "required": [
          "vulnerability_id",
          "title",
          "descriptions",
          "modification_date",
          "creation_date",
          "alternative_ids",
          "tags",
          "products",
          "estimated"
        ],
        "properties": {
          "alternative_ids": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Alternative IDs of the vulnerability"
          },
          "beescore": {
            "type": [
              "number",
              "null"
            ],
            "format": "double",
            "description": "Beescore (personalized prioritization score) for this vulnerability in the action plan context"
          },
          "creation_date": {
            "type": "string",
            "format": "date-time",
            "description": "Creation date of the vulnerability"
          },
          "cvss_score": {
            "type": [
              "number",
              "null"
            ],
            "format": "double",
            "description": "CVSS score from the personalized score"
          },
          "cvss_vector": {
            "type": [
              "string",
              "null"
            ],
            "description": "CVSS vector from the personalized score"
          },
          "descriptions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MultilingualDescription"
            },
            "description": "Descriptions of the vulnerability (multilingual)"
          },
          "epss_score": {
            "type": [
              "number",
              "null"
            ],
            "format": "float",
            "description": "EPSS score from the personalized score (when a CVE/EPSS row is available)"
          },
          "estimated": {
            "type": "boolean",
            "description": "Have score components been estimated?"
          },
          "modification_date": {
            "type": "string",
            "format": "date-time",
            "description": "Modification date of the vulnerability"
          },
          "products": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ShortProductResponse"
            },
            "description": "Product specifications of the vulnerability"
          },
          "published_date": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Publication date of the vulnerability (if published)"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Tags of the vulnerability"
          },
          "title": {
            "type": "string",
            "description": "Title of the vulnerability"
          },
          "vulnerability_id": {
            "type": "string",
            "description": "Sentibee vulnerability ID (e.g., \"STB-2025-1234\")"
          }
        }
      },
      "VulnerabilityTimelineItem": {
        "type": "object",
        "description": "Represents a vulnerability in the API response (detailed view).",
        "required": [
          "time",
          "event"
        ],
        "properties": {
          "event": {
            "type": "string"
          },
          "time": {
            "type": "string",
            "format": "date-time"
          }
        }
      },
      "VulnerabilityWatchlistItemResponse": {
        "type": "object",
        "description": "Watchlist item types returned in scope configuration (mirrors domain JSON shape).",
        "required": [
          "vulnerability_id",
          "criticality",
          "creation_date",
          "comment",
          "tags"
        ],
        "properties": {
          "comment": {
            "type": "string"
          },
          "creation_date": {
            "type": "string",
            "format": "date-time"
          },
          "criticality": {
            "$ref": "#/components/schemas/WatchlistItemCriticality"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "vulnerability_id": {
            "type": "string"
          }
        }
      },
      "WatchlistConsentPermission": {
        "type": "string",
        "description": "Permissions a customer can grant for watchlist access.",
        "enum": [
          "read",
          "edit",
          "delete"
        ]
      },
      "WatchlistConsentResponse": {
        "type": "object",
        "description": "A watchlist consent grant returned to the customer organization.",
        "required": [
          "id",
          "watchlist_id",
          "organization_id",
          "permissions",
          "duration_days",
          "expires_at",
          "created_at"
        ],
        "properties": {
          "backoffice_task_id": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int64",
            "description": "Open backoffice assistance task linked to this grant, if any."
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "UTC timestamp when the grant was created."
          },
          "duration_days": {
            "type": "integer",
            "format": "int32",
            "description": "Requested duration in days (7, 14, or 30)."
          },
          "expires_at": {
            "type": "string",
            "format": "date-time",
            "description": "UTC timestamp when the grant expires."
          },
          "id": {
            "type": "integer",
            "format": "int64",
            "description": "Unique identifier of the consent grant."
          },
          "organization_id": {
            "type": "integer",
            "format": "int32",
            "description": "Customer organization that issued the grant."
          },
          "permissions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/WatchlistConsentPermission"
            },
            "description": "Permissions granted to the backoffice team."
          },
          "reason": {
            "type": [
              "string",
              "null"
            ],
            "description": "Optional reason provided by the customer."
          },
          "revoked_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "UTC timestamp when the grant was revoked, if applicable."
          },
          "watchlist_id": {
            "type": "integer",
            "format": "int32",
            "description": "Watchlist the grant applies to."
          }
        }
      },
      "WatchlistDetailResponse": {
        "type": "object",
        "description": "Represents a watchlist with full details including configuration in the API response.",
        "required": [
          "id",
          "organization_id",
          "name",
          "description",
          "configuration",
          "created_at",
          "updated_at",
          "active"
        ],
        "properties": {
          "active": {
            "type": "boolean",
            "description": "Whether the watchlist is active"
          },
          "configuration": {
            "$ref": "#/components/schemas/ScopeConfigurationResponse",
            "description": "Configuration for the watchlist"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "Creation date of the watchlist"
          },
          "description": {
            "type": "string",
            "description": "Description of the watchlist"
          },
          "id": {
            "type": "integer",
            "format": "int32",
            "description": "ID of the watchlist"
          },
          "name": {
            "type": "string",
            "description": "Name of the watchlist"
          },
          "organization_id": {
            "type": "integer",
            "format": "int32",
            "description": "Organization ID of the organization to which the watchlist belongs"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "description": "Last update date of the watchlist"
          }
        }
      },
      "WatchlistImportCommitMode": {
        "type": "string",
        "description": "How committed rows merge into the live watchlist.",
        "enum": [
          "merge",
          "replace"
        ]
      },
      "WatchlistImportDraftRowResponse": {
        "type": "object",
        "description": "Draft row in preview responses.",
        "required": [
          "id",
          "row_index",
          "raw_cells",
          "validation_status",
          "validation_messages",
          "discarded"
        ],
        "properties": {
          "criticality": {
            "type": [
              "string",
              "null"
            ]
          },
          "discarded": {
            "type": "boolean"
          },
          "exposure": {
            "type": [
              "string",
              "null"
            ]
          },
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "product_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "proposed_watchlist_item": {},
          "raw_cells": {},
          "resolved_product_id": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32"
          },
          "resolved_vendor_id": {
            "type": [
              "integer",
              "null"
            ],
            "format": "int32"
          },
          "row_index": {
            "type": "integer",
            "format": "int32"
          },
          "validation_messages": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "validation_status": {
            "$ref": "#/components/schemas/WatchlistImportValidationStatus"
          },
          "vendor_name": {
            "type": [
              "string",
              "null"
            ]
          },
          "version_raw": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      },
      "WatchlistImportField": {
        "type": "string",
        "description": "Target watchlist field for a file column mapping.",
        "enum": [
          "ignore",
          "product_name",
          "vendor_name",
          "version",
          "exposure",
          "criticality",
          "comment",
          "tags"
        ]
      },
      "WatchlistImportFieldOption": {
        "type": "object",
        "description": "Available watchlist fields for column mapping UI.",
        "required": [
          "field",
          "label"
        ],
        "properties": {
          "field": {
            "$ref": "#/components/schemas/WatchlistImportField"
          },
          "label": {
            "type": "string"
          }
        }
      },
      "WatchlistImportIssuesCsvExport": {
        "type": "string",
        "description": "CSV file (UTF-8) with header row_index,product_name,vendor_name,version,validation_status,messages",
        "example": "row_index,product_name,vendor_name,version,validation_status,messages\n1,Apache HTTP Server,Apache Software Foundation,2.4.58,Warning,\"Product not found in catalog\""
      },
      "WatchlistImportJobResponse": {
        "type": "object",
        "description": "Import job summary for list/detail responses.",
        "required": [
          "id",
          "watchlist_id",
          "status",
          "file_name",
          "file_mime",
          "file_size_bytes",
          "progress_percent",
          "commit_mode",
          "total_rows",
          "valid_count",
          "warning_count",
          "error_count",
          "created_at",
          "updated_at",
          "expires_at"
        ],
        "properties": {
          "commit_mode": {
            "$ref": "#/components/schemas/WatchlistImportCommitMode"
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "error_count": {
            "type": "integer",
            "format": "int32"
          },
          "error_message": {
            "type": [
              "string",
              "null"
            ]
          },
          "expires_at": {
            "type": "string",
            "format": "date-time"
          },
          "file_mime": {
            "type": "string"
          },
          "file_name": {
            "type": "string"
          },
          "file_size_bytes": {
            "type": "integer",
            "format": "int64"
          },
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "mappings": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/WatchlistImportMappings"
              }
            ]
          },
          "preview_summary": {
            "oneOf": [
              {
                "type": "null"
              },
              {
                "$ref": "#/components/schemas/WatchlistImportPreviewSummary"
              }
            ]
          },
          "progress_message": {
            "type": [
              "string",
              "null"
            ]
          },
          "progress_percent": {
            "type": "integer",
            "format": "int32"
          },
          "status": {
            "$ref": "#/components/schemas/WatchlistImportJobStatus"
          },
          "total_rows": {
            "type": "integer",
            "format": "int32"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "valid_count": {
            "type": "integer",
            "format": "int32"
          },
          "warning_count": {
            "type": "integer",
            "format": "int32"
          },
          "watchlist_id": {
            "type": "integer",
            "format": "int32"
          }
        }
      },
      "WatchlistImportJobStatus": {
        "type": "string",
        "description": "Lifecycle status of a watchlist import job.\n\nEditable draft operations (`PUT .../mappings`, `PATCH .../rows`, `POST .../preview`,\n`POST .../commit`) require `ready`. Recoverable commit failures (plan limits, no valid\nrows) return the job to `ready` with an `error_message` instead of terminal `failed`.\n`failed` is reserved for unrecoverable parse/format errors (upload a new file).",
        "enum": [
          "draft",
          "queued",
          "parsing",
          "validating",
          "ready",
          "processing",
          "completed",
          "failed",
          "cancelled"
        ]
      },
      "WatchlistImportMappings": {
        "type": "object",
        "description": "Maps file column header names to import fields.",
        "additionalProperties": {
          "$ref": "#/components/schemas/WatchlistImportField"
        },
        "propertyNames": {
          "type": "string"
        }
      },
      "WatchlistImportPreviewQuery": {
        "allOf": [
          {
            "$ref": "#/components/schemas/PaginationQuery"
          },
          {
            "type": "object",
            "properties": {
              "revalidate": {
                "type": "boolean",
                "description": "When true, re-runs catalog resolution even if preview was already computed."
              }
            }
          }
        ]
      },
      "WatchlistImportPreviewResponse": {
        "type": "object",
        "description": "Paginated preview rows.",
        "required": [
          "job",
          "rows",
          "page",
          "page_size",
          "total_rows"
        ],
        "properties": {
          "job": {
            "$ref": "#/components/schemas/WatchlistImportJobResponse"
          },
          "page": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "page_size": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          },
          "rows": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/WatchlistImportDraftRowResponse"
            }
          },
          "total_rows": {
            "type": "integer",
            "format": "int64",
            "minimum": 0
          }
        }
      },
      "WatchlistImportPreviewSummary": {
        "type": "object",
        "description": "Summary counts stored on the job after validation.",
        "required": [
          "total_rows",
          "valid_count",
          "warning_count",
          "error_count",
          "discarded_count"
        ],
        "properties": {
          "discarded_count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0
          },
          "error_count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0
          },
          "total_rows": {
            "type": "integer",
            "format": "int32",
            "minimum": 0
          },
          "valid_count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0
          },
          "warning_count": {
            "type": "integer",
            "format": "int32",
            "minimum": 0
          }
        }
      },
      "WatchlistImportUploadForm": {
        "type": "object",
        "description": "Multipart body for `POST /api/import/watchlist/{watchlist_id}`.\n\nSend a single part named `file` containing a watchlist import file (CSV, Excel, PDF,\nWord, PowerPoint, plain text, or common image formats).\n\nMax upload size depends on format and is enforced in the upload handler.",
        "required": [
          "file"
        ],
        "properties": {
          "file": {
            "type": "string",
            "format": "binary",
            "contentMediaType": "application/octet-stream"
          }
        }
      },
      "WatchlistImportUploadQuery": {
        "type": "object",
        "description": "Query parameters for `POST /api/import/watchlist/{watchlist_id}`.",
        "properties": {
          "mapping_template_id": {
            "type": [
              "string",
              "null"
            ],
            "format": "uuid",
            "description": "Optional saved mapping template; locked columns override auto-suggestions during parse."
          }
        }
      },
      "WatchlistImportValidationStatus": {
        "type": "string",
        "description": "Validation outcome for a draft import row.",
        "enum": [
          "valid",
          "warning",
          "error"
        ]
      },
      "WatchlistItemCriticality": {
        "type": "string",
        "description": "Criticality level for a watchlist item.",
        "enum": [
          "Critical",
          "Medium",
          "Low"
        ]
      },
      "WatchlistItemRequest": {
        "oneOf": [
          {
            "allOf": [
              {
                "$ref": "#/components/schemas/VendorWatchlistItemRequest",
                "description": "Vendor watchlist item"
              },
              {
                "type": "object",
                "required": [
                  "type"
                ],
                "properties": {
                  "type": {
                    "type": "string",
                    "enum": [
                      "Vendor"
                    ]
                  }
                }
              }
            ],
            "description": "Vendor watchlist item"
          },
          {
            "allOf": [
              {
                "$ref": "#/components/schemas/ProductWatchlistItemRequest",
                "description": "Product watchlist item"
              },
              {
                "type": "object",
                "required": [
                  "type"
                ],
                "properties": {
                  "type": {
                    "type": "string",
                    "enum": [
                      "Product"
                    ]
                  }
                }
              }
            ],
            "description": "Product watchlist item"
          },
          {
            "allOf": [
              {
                "$ref": "#/components/schemas/PackageWatchlistItemRequest",
                "description": "Package watchlist item"
              },
              {
                "type": "object",
                "required": [
                  "type"
                ],
                "properties": {
                  "type": {
                    "type": "string",
                    "enum": [
                      "Package"
                    ]
                  }
                }
              }
            ],
            "description": "Package watchlist item"
          }
        ],
        "description": "Represents a watchlist item request (without creation date)."
      },
      "WatchlistItemResponse": {
        "oneOf": [
          {
            "type": "object",
            "required": [
              "vulnerability"
            ],
            "properties": {
              "vulnerability": {
                "$ref": "#/components/schemas/VulnerabilityWatchlistItemResponse"
              }
            }
          },
          {
            "type": "object",
            "required": [
              "vendor"
            ],
            "properties": {
              "vendor": {
                "$ref": "#/components/schemas/VendorWatchlistItemResponse"
              }
            }
          },
          {
            "type": "object",
            "required": [
              "product"
            ],
            "properties": {
              "product": {
                "$ref": "#/components/schemas/ProductWatchlistItemResponse"
              }
            }
          },
          {
            "type": "object",
            "required": [
              "package"
            ],
            "properties": {
              "package": {
                "$ref": "#/components/schemas/PackageWatchlistItemResponse"
              }
            }
          },
          {
            "type": "object",
            "required": [
              "industry"
            ],
            "properties": {
              "industry": {
                "$ref": "#/components/schemas/IndustryWatchlistItemResponse"
              }
            }
          },
          {
            "type": "object",
            "required": [
              "product_type"
            ],
            "properties": {
              "product_type": {
                "$ref": "#/components/schemas/ProductTypeWatchlistItemResponse"
              }
            }
          }
        ]
      },
      "WatchlistMemberResponse": {
        "type": "object",
        "description": "Represents a member of a watchlist in the API response.",
        "required": [
          "user_id",
          "firstname",
          "lastname",
          "role",
          "watchlist_id"
        ],
        "properties": {
          "firstname": {
            "type": "string",
            "description": "First name of the user"
          },
          "lastname": {
            "type": "string",
            "description": "Last name of the user"
          },
          "role": {
            "$ref": "#/components/schemas/UserRoleResponse",
            "description": "Role of the user in the watchlist"
          },
          "user_id": {
            "type": "integer",
            "format": "int32",
            "description": "ID of the user"
          },
          "watchlist_id": {
            "type": "integer",
            "format": "int32",
            "description": "The id of watchlist the user belongs to"
          }
        }
      },
      "WatchlistResponse": {
        "type": "object",
        "description": "Represents a watchlist in the API response.",
        "required": [
          "id",
          "organization_id",
          "name",
          "description",
          "created_at",
          "updated_at",
          "active"
        ],
        "properties": {
          "active": {
            "type": "boolean",
            "description": "Whether the watchlist is active"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "Creation date of the watchlist"
          },
          "description": {
            "type": "string",
            "description": "Description of the watchlist"
          },
          "id": {
            "type": "integer",
            "format": "int32",
            "description": "ID of the watchlist"
          },
          "name": {
            "type": "string",
            "description": "Name of the watchlist"
          },
          "organization_id": {
            "type": "integer",
            "format": "int32",
            "description": "Organization ID of the organization to which the watchlist belongs"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "description": "Last update date of the watchlist"
          }
        }
      },
      "WatchlistVersion": {
        "oneOf": [
          {
            "type": "object",
            "required": [
              "major"
            ],
            "properties": {
              "major": {
                "$ref": "#/components/schemas/Version"
              }
            }
          },
          {
            "type": "object",
            "required": [
              "complete"
            ],
            "properties": {
              "complete": {
                "$ref": "#/components/schemas/Version"
              }
            }
          },
          {
            "type": "object",
            "required": [
              "range"
            ],
            "properties": {
              "range": {
                "$ref": "#/components/schemas/VersionRangeResponse"
              }
            }
          },
          {
            "type": "string",
            "enum": [
              "all"
            ]
          }
        ],
        "description": "Version selection for a product watchlist item."
      }
    },
    "securitySchemes": {
      "http": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "base64(session_uuid).base64(session_key)"
      }
    }
  }
}