Generate fix

Trigger Generate fix in bulk for one or more packages.

Description: Triggers Seal's Generate fix flow for one or more packages in a single call. The flow queues a build pipeline on Seal's side; the sealed iteration appears on the Protection page when the build completes.

Path: https://external.sealsecurity.io/authenticated/api/v1/generate-fix

Method: POST

Authentication: Bearer token. See Authentication.

Request body

{
  "packages": [
    {
      "library_name": "string",
      "library_version": "string",
      "ecosystem": "string"
    }
  ]
}

Field	Type	Required	Description
packages	array of package identifier objects	yes	The packages to trigger Generate fix for. 1 to 50 entries.

Each package identifier object:

Field	Type	Required	Description
library_name	string	yes	The package name as the package manager identifies it.
library_version	string	yes	The vulnerable version to seal.
ecosystem	string	yes	The package manager (for example, NPM, PyPI, Maven, RPM, DEB, APK). Must be a value accepted by the platform.

Response

{
  "results": [
    {
      "library_name": "string",
      "library_version": "string",
      "ecosystem": "string",
      "status": "string",
      "message": "string"
    }
  ]
}

Response Fields:

Field	Type	Description
results	array of result objects	One result per input package, in the same order as the request's packages array.

Each result object:

Field	Type	Description
library_name	string	The package name from the request.
library_version	string	The vulnerable version from the request.
ecosystem	string	The ecosystem from the request.
status	string	The trigger result. One of: triggered, not_found, unfixable, error.
message	string or null	Human-readable detail. null when not applicable.

Status values:

Value	Meaning
triggered	Generate fix was queued for this package.
not_found	The package and version are not known to Seal.
unfixable	Seal cannot generate a sealed version for this package (for example, the patch would inherently introduce breaking changes).
error	An unexpected error occurred while triggering Generate fix. The message field carries the detail.

Example

Request (cURL):

curl -X POST \
  'https://external.sealsecurity.io/authenticated/api/v1/generate-fix' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "packages": [
      { "library_name": "ejs",     "library_version": "2.7.4",  "ecosystem": "NPM"   },
      { "library_name": "requests","library_version": "2.31.0", "ecosystem": "PyPI" },
      { "library_name": "no-such-pkg","library_version": "1.0.0","ecosystem": "NPM" }
    ]
  }'

Example Response:

{
  "results": [
    {
      "library_name": "ejs",
      "library_version": "2.7.4",
      "ecosystem": "NPM",
      "status": "triggered",
      "message": null
    },
    {
      "library_name": "requests",
      "library_version": "2.31.0",
      "ecosystem": "PyPI",
      "status": "triggered",
      "message": null
    },
    {
      "library_name": "no-such-pkg",
      "library_version": "1.0.0",
      "ecosystem": "NPM",
      "status": "not_found",
      "message": "Package not found in Seal's database"
    }
  ]
}