Snyk/cloud
Snyk Cloud — cloud environments, scans, and resource posture management
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.
Global Arguments
| Argument | Type | Description |
|---|---|---|
| apiToken | string | Snyk API token. Store it in a vault and wire it with ${{ vault.get("snyk", "API_TOKEN") }}; never pass the literal token. |
| orgId | string | Snyk organization ID |
| version? | string | Snyk API version date |
| Argument | Type | Description |
|---|---|---|
| created_after? | string | Return environments created after this date |
| created_before? | string | Return environments created before this date |
| updated_after? | string | Return environments updated after this date |
| updated_before? | string | Return environments updated before this date |
| name? | string | Filter environments by name (multi-value, comma-separated) |
| kind? | string | Filter environments by kind (multi-value, comma-separated): aws |
| status? | enum | Filter environments by latest scan status (multi-value, comma-separated) |
| id? | string | Filter environments by environment ID (multi-value, comma-separated) |
| project_id? | string | Filter environments by project ID |
| Argument | Type | Description |
|---|---|---|
| data | object |
| Argument | Type | Description |
|---|---|---|
| environment_id | string | Unique identifier for an environment |
| data | object |
| Argument | Type | Description |
|---|---|---|
| environment_id | string | Unique identifier for an environment |
| Argument | Type | Description |
|---|---|---|
| data | object |
| Argument | Type | Description |
|---|---|---|
| environment_id? | string | Filter resources by environment ID (multi-value, comma-separated) |
| resource_type? | string | Filter resources by resource type (multi-value, comma-separated) |
| resource_id? | string | Filter resources by resource ID (multi-value, comma-separated) |
| native_id? | string | Filter resources by native ID (multi-value, comma-separated) (AWS ARN) |
| id? | string | Filter resources by resource UUID (multi-value, comma-separated) |
| platform? | string | Filter resources by platform (multi-value, comma-separated): aws |
| name? | string | Filter resources by name (multi-value, comma-separated) |
| kind? | string | Filter resources by kind (multi-value, comma-separated): cloud |
| location? | string | Filter resources by location (multi-value, comma-separated) (AWS region) |
| removed? | boolean | Filter resources by whether they have been removed or not. |
| Argument | Type | Description |
|---|---|---|
| data | object |
| Argument | Type | Description |
|---|---|---|
| scan_id | string | Scan ID |
Resources
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. A POST method named with a different
verb wrote its result under a resource name the model never declared:
get_permissions now writes the declared permissions resource.
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. The scan resource is written by both a list
and a get or create method. Its schema now accepts what each writes, where the
list wrapper schema rejected the flat data.
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
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. A POST method named with a different
verb wrote its result under a resource name the model never declared:
get_permissions now writes the declared permissions resource.
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. The scan resource is written by both a list
and a get or create method. Its schema now accepts what each writes, where the
list wrapper schema rejected the flat data.
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
Added: Initial code-generated release of @webframp/snyk/cloud with 9 methods covering the Snyk cloud API surface.
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
Changed: Bump zod 4.4.3 → 4.6.5
2026.09.08.1
Added: Initial code-generated release of @webframp/snyk/cloud with 9 methods covering the Snyk cloud API surface.
2026.09.08.1
Added: Initial code-generated release of @webframp/snyk/cloud with 9 methods covering the Snyk cloud API surface.
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.
updated labels
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
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.25.1
Changed: Updated labels for improved extension discoverability. Added cross-cutting category labels (security, observability, finops, infrastructure, networking, compliance, devops, ai, incident-response) where applicable.
updated labels
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.2
Changed: Snyk API request failures now name the HTTP method and path that
was attempted (e.g. Snyk API GET /orgs/{orgId}/cloud/scans failed with HTTP 403: ...) instead of surfacing only the raw status and body. Network-level
failures (DNS, timeout, connection reset) are also caught and re-raised with
the same method/path context and the original error preserved as cause,
rather than propagating an unlabeled fetch error.
Upgrade note: No changes to stored resource schemas. Existing instances need no migration.
2026.08.21.1
Changed: Schema tightening sweep — no behavioral changes.
- Added
.min(1)toapiTokenandorgIdin the global arguments schema. - Added
.describe(...)to previously undocumented fields:deleted_at(environments, resources, and scans),options/propertieson the environment schemas, andtype/dataon the permissions schema.
2026.07.19.1
Added: Initial code-generated release of @webframp/snyk/cloud with 9 methods covering the Snyk cloud API surface.
- 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