Skip to main content

Snyk/projects

@webframp/snyk/projectsv2026.10.21.1· Apache-2.0· 5d agoBEHAVIORS
01README

Snyk Projects — project listing, attributes, relationships, and target management

02Release Notes

2026.10.21.1

Changed: The README now shows the Snyk API token stored in a swamp vault (swamp vault put snyk API_TOKEN) and wired with --global-arg 'apiToken=${{ vault.get("snyk", "API_TOKEN") }}', replacing the literal-token example. The apiToken argument description says the same.

Documentation only: nothing behavioral changed. This API returns no secrets.

03Behaviors1
@webframp/snyk/projectsv2026.10.21.1snyk/projects.ts

Global Arguments

ArgumentTypeDescription
apiTokenstringSnyk API token. Store it in a vault and wire it with ${{ vault.get("snyk", "API_TOKEN") }}; never pass the literal token.
orgIdstringSnyk organization ID
version?stringSnyk API version date
fn list_org_projects(target_id?: union, target_reference?: string, target_file?: string, target_runtime?: string, meta_count?: enum, ids?: union, names?: union, names_start_with?: union, origins?: union, types?: union, expand?: union, meta_latest_issue_counts?: boolean, meta_latest_dependency_total?: boolean, cli_monitored_before?: string, cli_monitored_after?: string, importing_user_public_id?: union, tags?: union, business_criticality?: union, environment?: union, lifecycle?: union)
List all Projects for an Org with the given Org ID.
ArgumentTypeDescription
target_id?unionReturn projects that belong to the provided targets
target_reference?stringReturn projects that match the provided target reference
target_file?stringReturn projects that match the provided target file
target_runtime?stringReturn projects that match the provided target runtime
meta_count?enumThe collection count.
ids?unionReturn projects that match the provided IDs.
names?unionReturn projects that match the provided names.
names_start_with?unionReturn projects with names starting with the specified prefix.
origins?unionReturn projects that match the provided origins.
types?unionReturn projects that match the provided types.
expand?unionExpand relationships.
meta_latest_issue_counts?booleanInclude a summary count for the issues found in the most recent scan of this...
meta_latest_dependency_total?booleanInclude the total number of dependencies found in the most recent scan of...
cli_monitored_before?stringFilter projects uploaded and monitored before this date (encoded value)
cli_monitored_after?stringFilter projects uploaded and monitored after this date (encoded value)
importing_user_public_id?unionReturn projects that match the provided importing user public ids.
tags?unionReturn projects that match all the provided tags
business_criticality?unionReturn projects that match all the provided business_criticality value
environment?unionReturn projects that match all the provided environment values
lifecycle?unionReturn projects that match all the provided lifecycle values
fn delete_org_projects(data: array, meta?: object)
Delete several projects in one request.
ArgumentTypeDescription
dataarrayThe projects to delete, at most 100 per request.
meta?objectOptions that apply to this request.
fn get_org_project(project_id: string, expand?: union, meta_latest_issue_counts?: boolean, meta_latest_dependency_total?: boolean)
Get project by project ID.
ArgumentTypeDescription
project_idstringThe ID of the project.
expand?unionExpand relationships.
meta_latest_issue_counts?booleanInclude a summary count for the issues found in the most recent scan of this...
meta_latest_dependency_total?booleanInclude the total number of dependencies found in the most recent scan of...
fn update_org_project(project_id: string, expand?: union, data: object)
Updates project by project ID.
ArgumentTypeDescription
project_idstringThe ID of the project to patch.
expand?unionExpand relationships.
dataobject
fn delete_org_project(project_id: string)
Delete project by project ID.
ArgumentTypeDescription
project_idstringThe ID of the project.
fn get_sbom(project_id: string, format?: enum, exclude?: union, go_module_level?: boolean)
Get a project’s SBOM document
ArgumentTypeDescription
project_idstringUnique identifier for a project
format?enumThe desired SBOM format of the response.
exclude?unionAn array of features to be excluded from the generated SBOM.
go_module_level?booleanWhen true, consolidate Go package-level dependencies into module-level...

Resources

org_projects(infinite)— List all Projects for an Org with the given Org ID.
delete_org_projects(infinite)— Delete several projects in one request.
org_project(infinite)— Get project by project ID.
sbom(infinite)— Get a project’s SBOM document
04Previous Versions12
2026.10.14.1Apache-2.0(was none)

2026.10.14.1

Added: The manifest now declares license: Apache-2.0 (SPDX). The registry quality rubric scores a declared license separately from the bundled LICENSE.md.

Upgrade note: Metadata only. No code, schema, or behavioral changes.

2026.10.07.1

Fixed: A request that never answers no longer hangs the method. Each attempt now has a 30-second deadline, and a timeout names the method and path. Rate limiting (HTTP 429) retries up to three times, waits at most 30 seconds between tries, and then reports the rate limit instead of failing with a consumed-body TypeError. An empty 2xx body (202, 204, or an empty 200) no longer fails JSON parsing. A malformed JSON body now reports the HTTP status and the request instead of a bare SyntaxError, and HTTP errors name the request too. Pagination follows a relative next link with or without the /rest prefix, and refuses a next link that leaves the Snyk API origin or the /rest path instead of sending the API token to it. list_org_projects and get_org_project sent meta.latest_issue_counts and meta.latest_dependency_total as meta_latest_issue_counts and meta_latest_dependency_total. They now send the API's names. update_org_project now sends its declared query parameters instead of dropping them.

Changed: Response schemas now accept what the API returns. Enumerated response fields accept any value of their type, value constraints (min, max, pattern) are dropped, response properties may be missing or null, and nested objects keep fields the spec does not list, so one unexpected value no longer fails a whole page. Methods that read or create a single resource now fail when the API answers with an empty body where the spec promises content, instead of storing an empty resource. Operations the spec documents as returning no content (204) still succeed. Argument and field descriptions now end at a word boundary. Request arguments are unchanged, except the array-valued query parameters (target_id, ids, names, names_start_with, origins, types, expand, importing_user_public_id, tags, business_criticality, environment, lifecycle, exclude), which now accept a string or a list of strings. A list joins with commas or repeats the key, as the API specifies for that parameter, and a plain string is sent unchanged.

Upgrade note: The loosened response schemas change validation behavior. Stored resources remain valid, and no data migration is needed. Anything that relied on a resource schema to reject an out-of-enum value or a missing field must now check the data itself.

2026.10.07.1

2026.10.07.1

Fixed: A request that never answers no longer hangs the method. Each attempt now has a 30-second deadline, and a timeout names the method and path. Rate limiting (HTTP 429) retries up to three times, waits at most 30 seconds between tries, and then reports the rate limit instead of failing with a consumed-body TypeError. An empty 2xx body (202, 204, or an empty 200) no longer fails JSON parsing. A malformed JSON body now reports the HTTP status and the request instead of a bare SyntaxError, and HTTP errors name the request too. Pagination follows a relative next link with or without the /rest prefix, and refuses a next link that leaves the Snyk API origin or the /rest path instead of sending the API token to it. list_org_projects and get_org_project sent meta.latest_issue_counts and meta.latest_dependency_total as meta_latest_issue_counts and meta_latest_dependency_total. They now send the API's names. update_org_project now sends its declared query parameters instead of dropping them.

Changed: Response schemas now accept what the API returns. Enumerated response fields accept any value of their type, value constraints (min, max, pattern) are dropped, response properties may be missing or null, and nested objects keep fields the spec does not list, so one unexpected value no longer fails a whole page. Methods that read or create a single resource now fail when the API answers with an empty body where the spec promises content, instead of storing an empty resource. Operations the spec documents as returning no content (204) still succeed. Argument and field descriptions now end at a word boundary. Request arguments are unchanged, except the array-valued query parameters (target_id, ids, names, names_start_with, origins, types, expand, importing_user_public_id, tags, business_criticality, environment, lifecycle, exclude), which now accept a string or a list of strings. A list joins with commas or repeats the key, as the API specifies for that parameter, and a plain string is sent unchanged.

Upgrade note: The loosened response schemas change validation behavior. Stored resources remain valid, and no data migration is needed. Anything that relied on a resource schema to reject an out-of-enum value or a missing field must now check the data itself.

2026.09.27.1

2026.09.27.1

Added: Initial code-generated release of @webframp/snyk/projects with 6 methods covering the Snyk projects API surface.

2026.09.18.1

2026.09.18.1

Upgrade note: Normalized npm:zod dependency version to 4.6.5 across the repo. No behavioral changes in this extension.

2026.09.15.1

2026.09.15.1

Changed: Bump zod 4.4.3 → 4.6.5

2026.09.08.1

Added: Initial code-generated release of @webframp/snyk/projects with 6 methods covering the Snyk projects API surface.

2026.09.08.1

2026.09.08.1

Added: Initial code-generated release of @webframp/snyk/projects with 6 methods covering the Snyk projects API surface.

2026.08.28.2

2026.08.28.2

Hardened codegen: instance names sanitized against path traversal; 429 rate-limit retry with Retry-After; string schema patterns emit regex validation; output schemas passthrough unknown fields.

Modified 1 behaviors

2026.08.28.1

2026.08.28.1

Changed: Normalized the extension license to Apache-2.0 and corrected the copyright holder to "Sean Escriva". Extensions that previously shipped an MIT LICENSE.md are now Apache-2.0, consistent with the repository root and every other extension. No code or behavioral changes.

Upgrade note: License text only. No API, schema, or runtime behavior changed.

2026.08.26.2

Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry quality scorer can resolve dependencies and score the extension. An earlier release used a bare "zod" import-map specifier, which published but scored as unscored.

Changed: Retained explicit compilerOptions.strict in deno.json. No behavioral or schema changes.

2026.08.26.2

2026.08.26.2

Fixed: Restored inline npm:zod@4.4.3 import specifiers so the registry quality scorer can resolve dependencies and score the extension. An earlier release used a bare "zod" import-map specifier, which published but scored as unscored.

Changed: Retained explicit compilerOptions.strict in deno.json. No behavioral or schema changes.

2026.08.24.1

2026.08.24.1

Added: Output metadata attributes for observability.

  • durationMs: Method execution duration in milliseconds.
  • collectedBy: Extension name that produced the data.
  • fetchedAt: ISO 8601 timestamp when data was fetched (added to resources that previously lacked it).
2026.08.21.1

2026.08.21.1

Changed: project_id now must be a non-empty string — previously an empty value passed schema validation and only failed deep inside the Snyk API call with a generic 404. Errors from the Snyk API now name the HTTP method and path that was attempted instead of just the bare status and body. Network-level failures (DNS, connection refused, TLS errors) reaching the Snyk API are now also caught and reported with the operation and path that was being attempted, rather than surfacing as an unhandled fetch exception.

2026.07.19.1

2026.07.19.1

Added: Initial code-generated release of @webframp/snyk/projects with 5 methods covering the Snyk projects API surface.

05Stats
A
100 / 100
Downloads
33
Archive size
18.7 KB
  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types (deprecated)1/1earned
  • Dependencies pass trust audit2/2earned
  • Has description1/1earned
  • Platform support declared (or universal)2/2earned
  • License2/2earned
  • Verified public repository2/2earned
06Platforms
07Labels