snyk-api — quality + safety report

---
name: snyk-api
description: "Snyk API skill. Use when working with Snyk for custom_base_images, groups, learn. Covers 250 endpoints."
version: 1.0.0
generator: lapsh
---

# Snyk API
API version: REST

## Auth
ApiKey Authorization in header | Bearer bearer

## Base URL
https://api.snyk.io/rest

## Setup
1. Set Authorization header with your Bearer token
2. GET /custom_base_images -- verify access
3. POST /custom_base_images -- create first custom_base_images

## Endpoints

250 endpoints across 7 groups. See references/api-spec.lap for full details.

### custom_base_images
| Method | Path | Description |
|--------|------|-------------|
| GET | /custom_base_images | Get a custom base image collection |
| POST | /custom_base_images | Create a Custom Base Image from an existing container project |
| DELETE | /custom_base_images/{custombaseimage_id} | Delete a custom base image |
| GET | /custom_base_images/{custombaseimage_id} | Get a custom base image |
| PATCH | /custom_base_images/{custombaseimage_id} | Update a custom base image |

### groups
| Method | Path | Description |
|--------|------|-------------|
| GET | /groups | Get all groups (Early Access) |
| GET | /groups/{group_id} | Get Group (Early Access) |
| GET | /groups/{group_id}/apps/installs | Get a list of Snyk Apps installed for a Group |
| POST | /groups/{group_id}/apps/installs | Install a Snyk App for a Group |
| DELETE | /groups/{group_id}/apps/installs/{install_id} | Revoke app authorization for a Snyk group with install ID |
| POST | /groups/{group_id}/apps/installs/{install_id}/secrets | Manage client secret for non-interactive Snyk App installations |
| POST | /groups/{group_id}/assets/search | List Assets with filters (Early Access) |
| GET | /groups/{group_id}/assets/{asset_id} | Get an Asset by its ID (Early Access) |
| PATCH | /groups/{group_id}/assets/{asset_id} | Update asset attributes (Early Access) |
| GET | /groups/{group_id}/assets/{asset_id}/relationships/assets | List related assets with pagination (Early Access) |
| GET | /groups/{group_id}/assets/{asset_id}/relationships/projects | List asset projects with pagination (Early Access) |
| GET | /groups/{group_id}/audit_logs/search | Search Group audit logs. |
| POST | /groups/{group_id}/export | Start an export |
| GET | /groups/{group_id}/export/{export_id} | Get export results |
| GET | /groups/{group_id}/inventory/assets | List or search all assets (synchronous) - Group scope (Early Access) |
| PATCH | /groups/{group_id}/inventory/assets | Bulk update asset attributes - Group scope (Early Access) |
| GET | /groups/{group_id}/inventory/assets/filters | Get available filter fields - Group scope (Early Access) |
| GET | /groups/{group_id}/inventory/assets/filters/{filter_id}/values | Get filter value suggestions (autocomplete) - Group scope (Early Access) |
| GET | /groups/{group_id}/inventory/assets/groups | Get available group fields - Group scope (Early Access) |
| GET | /groups/{group_id}/inventory/assets/groups/{group_field}/values | Get group value aggregation - Group scope (Early Access) |
| POST | /groups/{group_id}/inventory/assets/searches | Create an asset search (asynchronous) - Group scope (Early Access) |
| GET | /groups/{group_id}/inventory/assets/searches/{search_id}/results | Retrieve asset search results (asynchronous) - Group scope (Early Access) |
| GET | /groups/{group_id}/inventory/assets/{asset_id} | Get a single asset by ID - Group scope (Early Access) |
| PATCH | /groups/{group_id}/inventory/assets/{asset_id} | Update asset attributes - Group scope (Early Access) |
| GET | /groups/{group_id}/inventory/assets/{asset_id}/relationships/projects | List projects for an asset (group scope) (Early Access) |
| GET | /groups/{group_id}/inventory/assets/{asset_id}/relationships/targets | List targets for an asset (group scope) (Early Access) |
| GET | /groups/{group_id}/issues | Get issues by group ID |
| GET | /groups/{group_id}/issues/{issue_id} | Get an issue |
| GET | /groups/{group_id}/jobs/export/{export_id} | Get export status |
| GET | /groups/{group_id}/memberships | Get all memberships of the group |
| POST | /groups/{group_id}/memberships | Create a group membership for a user with role |
| DELETE | /groups/{group_id}/memberships/{membership_id} | Delete a membership from a group |
| PATCH | /groups/{group_id}/memberships/{membership_id} | Update a role from a group membership |
| GET | /groups/{group_id}/org_memberships | Get list of org memberships of a group user |
| GET | /groups/{group_id}/orgs | List all organizations in group |
| GET | /groups/{group_id}/policies | Get group level policies (Early Access) |
| POST | /groups/{group_id}/policies | Create a new group level policy (Early Access) |
| DELETE | /groups/{group_id}/policies/{policy_id} | Delete an group-level policy (Early Access) |
| PATCH | /groups/{group_id}/policies/{policy_id} | Update a group-level policy (Early Access) |
| GET | /groups/{group_id}/service_accounts | Get a list of group service accounts. |
| POST | /groups/{group_id}/service_accounts | Create a service account for a group. |
| DELETE | /groups/{group_id}/service_accounts/{serviceaccount_id} | Delete a group service account. |
| GET | /groups/{group_id}/service_accounts/{serviceaccount_id} | Get a group service account. |
| PATCH | /groups/{group_id}/service_accounts/{serviceaccount_id} | Update a group service account. |
| POST | /groups/{group_id}/service_accounts/{serviceaccount_id}/secrets | Manage a group service account's client secret. |
| GET | /groups/{group_id}/settings/iac | Get the Infrastructure as Code Settings for a group |
| PATCH | /groups/{group_id}/settings/iac | Update the Infrastructure as Code Settings for a group |
| DELETE | /groups/{group_id}/settings/pull_request_template | Delete pull request template for group |
| GET | /groups/{group_id}/settings/pull_request_template | Get pull request template for group |
| POST | /groups/{group_id}/settings/pull_request_template | Create or update pull request template for group |
| GET | /groups/{group_id}/sso_connections | Get all SSO connections for a group (Early Access) |
| GET | /groups/{group_id}/sso_connections/{sso_id}/users | Get all users using a given SSO connection (Early Access) |
| DELETE | /groups/{group_id}/sso_connections/{sso_id}/users/{user_id} | Delete a user from a Group SSO connection (Early Access) |
| PATCH | /groups/{group_id}/users/{id} | Update a user's role in a group (Early Access) |

### learn
| Method | Path | Description |
|--------|------|-------------|
| GET | /learn/catalog | List Snyk Learn's resources (Early Access) |

### openapi
| Method | Path | Description |
|--------|------|-------------|
| GET | /openapi | List available versions of OpenAPI specification |
| GET | /openapi/{version} | Get OpenAPI specification effective at version. |

### orgs
| Method | Path | Description |
|--------|------|-------------|
| GET | /orgs | List accessible organizations |
| GET | /orgs/{org_id} | Get organization |
| PATCH | /orgs/{org_id} | Update organization |
| GET | /orgs/{org_id}/ai_bom_jobs/{job_id} | Get an AI-BOM job status (Early Access) |
| POST | /orgs/{org_id}/ai_boms | Create a new AI-BOM (Early Access) |
| POST | /orgs/{org_id}/ai_boms/upload | Create and upload an AI-BOM (Early Access) |
| GET | /orgs/{org_id}/ai_boms/{ai_bom_id} | Get an AI-BOM. (Early Access) |
| GET | /orgs/{org_id}/app_bots | Get a list of app bots authorized to an organization. |
| DELETE | /orgs/{org_id}/app_bots/{bot_id} | Revoke app bot authorization |
| GET | /orgs/{org_id}/apps | Get a list of Snyk Apps created by an Organization |
| POST | /orgs/{org_id}/apps | Create a new app for an organization. |
| GET | /orgs/{org_id}/apps/creations | Get a list of Snyk Apps created by an Organization |
| POST | /orgs/{org_id}/apps/creations | Create a new Snyk App for an organization |
| DELETE | /orgs/{org_id}/apps/creations/{app_id} | Delete a Snyk App by app ID |
| GET | /orgs/{org_id}/apps/creations/{app_id} | Get a Snyk App by app ID |
| PATCH | /orgs/{org_id}/apps/creations/{app_id} | Update app creation attributes such as name, redirect URIs, and access token time to live using the App ID |
| POST | /orgs/{org_id}/apps/creations/{app_id}/secrets | Manage client secret for a Snyk App |
| GET | /orgs/{org_id}/apps/installs | Get a list of Snyk Apps installed for an Organization |
| POST | /orgs/{org_id}/apps/installs | Install a Snyk App for an Organization |
| DELETE | /orgs/{org_id}/apps/installs/{install_id} | Revoke app authorization for a Snyk organization with install ID |
| POST | /orgs/{org_id}/apps/installs/{install_id}/secrets | Manage client secret for non-interactive Snyk App installations |
| DELETE | /orgs/{org_id}/apps/{client_id} | Delete an app |
| GET | /orgs/{org_id}/apps/{client_id} | Get an app by client id |
| PATCH | /orgs/{org_id}/apps/{client_id} | Update app attributes that are name, redirect URIs, and access token time to live |
| POST | /orgs/{org_id}/apps/{client_id}/secrets | Manage client secrets for an app. |
| GET | /orgs/{org_id}/audit_logs/search | Search Organization audit logs. |
| GET | /orgs/{org_id}/brokers/connections | List Broker connections for a given organization |
| GET | /orgs/{org_id}/cloud/environments | List Environments (Early Access) |
| POST | /orgs/{org_id}/cloud/environments | Create New Environment (Early Access) |
| DELETE | /orgs/{org_id}/cloud/environments/{environment_id} | Delete Environment (Early Access) |
| PATCH | /orgs/{org_id}/cloud/environments/{environment_id} | Update Environment (Early Access) |
| POST | /orgs/{org_id}/cloud/permissions | Generate Cloud Provider Permissions (Early Access) |
| GET | /orgs/{org_id}/cloud/resources | List Resources (Early Access) |
| GET | /orgs/{org_id}/cloud/scans | List Scans (Early Access) |
| POST | /orgs/{org_id}/cloud/scans | Create Scan (Early Access) |
| GET | /orgs/{org_id}/cloud/scans/{scan_id} | Get scan (Early Access) |
| GET | /orgs/{org_id}/collections | Get collections |
| POST | /orgs/{org_id}/collections | Create a collection |
| DELETE | /orgs/{org_id}/collections/{collection_id} | Delete a collection |
| GET | /orgs/{org_id}/collections/{collection_id} | Get a collection |
| PATCH | /orgs/{org_id}/collections/{collection_id} | Edit a collection |
| DELETE | /orgs/{org_id}/collections/{collection_id}/relationships/projects | Remove projects from a collection |
| GET | /orgs/{org_id}/collections/{collection_id}/relationships/projects | Get projects from the specified collection |
| POST | /orgs/{org_id}/collections/{collection_id}/relationships/projects | Add projects to a collection |
| GET | /orgs/{org_id}/container_images | List instances of container image |
| GET | /orgs/{org_id}/container_images/{image_id} | Get instance of container image |
| GET | /orgs/{org_id}/container_images/{image_id}/relationships/image_target_refs | List instances of image target references for a container image |
| POST | /orgs/{org_id}/container_import/{integration_id}/policy/dry_run | Create a dry run job for a container registry import policy (Early Access) |
| GET | /orgs/{org_id}/container_import/{integration_id}/policy/dry_run/{job_id} | Get a dry run job (Early Access) |
| GET | /orgs/{org_id}/ecosystems/{ecosystem}/packages/{package_name} | Get a package (Early Access) |
| GET | /orgs/{org_id}/ecosystems/{ecosystem}/packages/{package_name}/versions/{package_version} | Get a package version (Early Access) |
| POST | /orgs/{org_id}/export | Start an export |
| GET | /orgs/{org_id}/export/{export_id} | Get export results |
| GET | /orgs/{org_id}/inventory/assets | List or search all assets (synchronous) - Org scope (Early Access) |
| PATCH | /orgs/{org_id}/inventory/assets | Bulk update asset attributes - Org scope (Early Access) |
| GET | /orgs/{org_id}/inventory/assets/filters | Get available filter fields - Org scope (Early Access) |
| GET | /orgs/{org_id}/inventory/assets/filters/{filter_id

… (truncated)