How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Snyk Inventory Assets API

The Inventory Assets API from Snyk — 30 operation(s) for inventory assets.

Snyk Inventory Assets API is one of 51 APIs that Snyk publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Inventory Assets. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 36 operations across 30 paths, and defines 53 schemas. It is described by OpenAPI 3.2.0, at version REST.

Requests are made against a single base URL, https://api.snyk.io/rest.

36 operations 30 paths 53 schemas 27 GET6 PATCH3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
REST
Base URL
https://api.snyk.io/rest
Authentication
API Key, HTTP Bearer
Resource Areas
1

Authentication & Security 2

Snyk Inventory Assets API declares 2 security schemes for authenticating requests. An API key is passed in the header as Authorization (APIToken). It accepts HTTP bearer tokens (BearerAuth). By default, every request must be authenticated.

  • APIToken — API key value must be prefixed with \"Token \".

Paths & Operations 36

Across 30 paths, the API surfaces 36 operations — 27 GET, 6 PATCH, 3 POST. Each is listed below with its method, path, parameters, and response codes.

Inventory Assets 36
GET
/groups/{group_id}/inventory/assets
List or search all assets (synchronous) - Group scope (Early Access)
listAssetsGroup 9 params → 200400401403500
PATCH
/groups/{group_id}/inventory/assets
Bulk update asset attributes - Group scope (Early Access)
updateAssetsBulkGroup 2 params body → 204400401403404500
GET
/groups/{group_id}/inventory/assets/filters
Get available filter fields - Group scope (Early Access)
getFilterFieldsGroup 6 params → 200400401403500
GET
/groups/{group_id}/inventory/assets/filters/{filter_id}/values
Get filter value suggestions (autocomplete) - Group scope (Early Access)
getFilterValuesGroup 9 params → 200400401403404500
GET
/groups/{group_id}/inventory/assets/groups
Get available group fields - Group scope (Early Access)
getGroupFieldsGroup 6 params → 200400401403500
GET
/groups/{group_id}/inventory/assets/groups/{group_field_id}/values
Get group value aggregation - Group scope (Early Access)
getGroupValuesGroup 11 params → 200400401403404500
POST
/groups/{group_id}/inventory/assets/searches
Create an asset search (asynchronous) - Group scope (Early Access)
createAssetSearchGroup 2 params body → 302400500
GET
/groups/{group_id}/inventory/assets/searches/{search_id}/results
Retrieve asset search results (asynchronous) - Group scope (Early Access)
getAssetSearchResultsGroup 8 params → 200404500
GET
/groups/{group_id}/inventory/assets/{asset_id}
Get a single asset by ID - Group scope (Early Access)
getAssetGroup 4 params → 200400401403404500
PATCH
/groups/{group_id}/inventory/assets/{asset_id}
Update asset attributes - Group scope (Early Access)
updateAssetGroup 3 params body → 200400401403404500
GET
/groups/{group_id}/inventory/assets/{asset_id}/relationships/projects
List projects for an asset (group scope) (Early Access)
listAssetProjectsGroup 9 params → 200400401403404500
GET
/groups/{group_id}/inventory/assets/{asset_id}/relationships/targets
List targets for an asset (group scope) (Early Access)
listAssetTargetsGroup 6 params → 200400401403404500
GET
/orgs/{org_id}/inventory/assets
List or search all assets (synchronous) - Org scope (Early Access)
listAssetsOrg 9 params → 200400401403500
PATCH
/orgs/{org_id}/inventory/assets
Bulk update asset attributes - Org scope (Early Access)
updateAssetsBulkOrg 2 params body → 204400401403404500
GET
/orgs/{org_id}/inventory/assets/filters
Get available filter fields - Org scope (Early Access)
getFilterFieldsOrg 6 params → 200400401403500
GET
/orgs/{org_id}/inventory/assets/filters/{filter_id}/values
Get filter value suggestions (autocomplete) - Org scope (Early Access)
getFilterValuesOrg 9 params → 200400401403404500
GET
/orgs/{org_id}/inventory/assets/groups
Get available group fields - Org scope (Early Access)
getGroupFieldsOrg 6 params → 200400401403500
GET
/orgs/{org_id}/inventory/assets/groups/{group_field_id}/values
Get group value aggregation - Org scope (Early Access)
getGroupValuesOrg 11 params → 200400401403404500
POST
/orgs/{org_id}/inventory/assets/searches
Create an asset search (asynchronous) - Org scope (Early Access)
createAssetSearchOrg 2 params body → 302400500
GET
/orgs/{org_id}/inventory/assets/searches/{search_id}/results
Retrieve asset search results (asynchronous) - Org scope (Early Access)
getAssetSearchResultsOrg 8 params → 200404500
GET
/orgs/{org_id}/inventory/assets/{asset_id}
Get a single asset by ID - Org scope (Early Access)
getAssetOrg 4 params → 200400401403404500
PATCH
/orgs/{org_id}/inventory/assets/{asset_id}
Update asset attributes - Org scope (Early Access)
updateAssetOrg 3 params body → 200400401403404500
GET
/orgs/{org_id}/inventory/assets/{asset_id}/relationships/projects
List projects for an asset (org scope) (Early Access)
listAssetProjectsOrg 9 params → 200400401403404500
GET
/orgs/{org_id}/inventory/assets/{asset_id}/relationships/targets
List targets for an asset (org scope) (Early Access)
listAssetTargetsOrg 6 params → 200400401403404500
GET
/tenants/{tenant_id}/inventory/assets
List or search all assets (synchronous) (Early Access)
listAssetsTenant 9 params → 200400401403500
PATCH
/tenants/{tenant_id}/inventory/assets
Bulk update asset attributes (Early Access)
updateAssetsBulkTenant 2 params body → 204400401403404500
GET
/tenants/{tenant_id}/inventory/assets/filters
Get available filter fields (Early Access)
getFilterFieldsTenant 6 params → 200400401403500
GET
/tenants/{tenant_id}/inventory/assets/filters/{filter_id}/values
Get filter value suggestions (autocomplete) (Early Access)
getFilterValuesTenant 9 params → 200400401403404500
GET
/tenants/{tenant_id}/inventory/assets/groups
Get available group fields (Early Access)
getGroupFieldsTenant 6 params → 200400401403500
GET
/tenants/{tenant_id}/inventory/assets/groups/{group_field_id}/values
Get group value aggregation (Early Access)
getGroupValuesTenant 11 params → 200400401403404500
POST
/tenants/{tenant_id}/inventory/assets/searches
Create an asset search (asynchronous) (Early Access)
createAssetSearchTenant 2 params body → 302400500
GET
/tenants/{tenant_id}/inventory/assets/searches/{search_id}/results
Retrieve asset search results (asynchronous) (Early Access)
getAssetSearchResultsTenant 8 params → 200404500
GET
/tenants/{tenant_id}/inventory/assets/{asset_id}
Get a single asset by ID (Early Access)
getAssetTenant 4 params → 200400401403404500
PATCH
/tenants/{tenant_id}/inventory/assets/{asset_id}
Update asset attributes (Early Access)
updateAssetTenant 3 params body → 200400401403404500
GET
/tenants/{tenant_id}/inventory/assets/{asset_id}/relationships/projects
List projects for an asset (Early Access)
listAssetProjectsTenant 9 params → 200400401403404500
GET
/tenants/{tenant_id}/inventory/assets/{asset_id}/relationships/targets
List targets for an asset (Early Access)
listAssetTargetsTenant 6 params → 200400401403404500

Schemas 53

The contract defines 53 schemas that model the data the API accepts and returns. The most detailed are ProjectRelationshipAttributes (14 properties), AssetBaseAttributes (12 properties), ImageConfig (10 properties), GroupValueMeta (8 properties). Each schema is shown below with its type and property counts.

LabelsReplace
array
Full replacement of all labels on the asset. All existing labels will be removed and replaced with the provided labels.
QueryVersion
string
Requested API version
GroupValueMeta
object
Computed aggregations across all assets within this group value. Fields are only present when explicitly requested via the metafields query parameter. If metaf…
8 properties
CreateSearchRequestBody
object
1 property
GroupValuesResponse
object
2 properties 2 required
ScanEngine
object
Scan engine information associated with an asset
5 properties 4 required
ImageConfig
object
Runtime configuration for the container (OCI image config). Contains entrypoint, environment, exposed ports, volumes, labels, etc.
10 properties
TargetRelationshipData
object
Full target resource with attributes
3 properties 2 required
ClassResponse
object
Asset classification in response
3 properties 2 required
Architecture
string
CPU architecture for container images (Go GOARCH conventions)
ProjectRelationshipData
object
Full project resource with attributes
3 properties 2 required
IssueCounts
object
Issue counts by severity
4 properties 4 required
ProjectRelationshipAttributes
object
Attributes of the project resource
14 properties
GroupValueData
object
4 properties 3 required
BaseImageRemediation
object
Base image upgrade recommendation data from container scanning
6 properties 2 required
RsqlFilterString
string
RSQL filter expression for filtering results. Supported operators: - == (equal), != (not equal) - or =gt= (greater than) - = or =ge= (greater than or equal) -…
ErrorDocument
object
2 properties 2 required
FilterValueAttributes
object
2 properties
GroupFieldData
object
4 properties 2 required
TargetRelationshipAttributes
object
Attributes of the target resource
5 properties
ContainerImageAttributesResponse
GroupValueIssuesAggregation
object
Aggregated issue counts from discovery sources across all assets in this group. Counts are summed from all project-type discovery sources.
5 properties
History
object
A single entry in the container image build history
5 properties
ProjectRelationshipListResponse
object
Response containing linked projects with full attributes
3 properties 3 required
GroupValueAttributes
object
1 property 1 required
FilterFieldAttributes
object
3 properties 3 required
RelationshipLinks
Links for relationship endpoint responses (combines relationship + pagination links)
AssetBaseAttributes
object
Asset-level fields shared across all asset types.
12 properties
ActualVersion
string
Resolved API version
OperatingSystem
string
Operating system for container images (Go GOOS conventions)
ImageInfo
object
Container image with vulnerability summary
5 properties 4 required
TargetRelationshipListResponse
object
Response containing linked targets with full attributes
3 properties 3 required
PolymorphicAssetData
object
JSON:API data for any asset type (polymorphic)
5 properties 2 required
TagsUpdate
object
Updates the asset's tags by adding or removing key-value pairs. Both add and remove can be specified in the same request. If a tag key appears in both add and…
2 properties
GroupFieldAttributes
object
2 properties 2 required
FilterValuesResponse
object
2 properties 2 required
JsonApiLinks
object
Links for relationship objects within a resource
2 properties
FilterFieldsResponse
object
2 properties 2 required
AssetBulkPatchRequestBody
object
1 property 1 required
AssetPatchAttributes
object
Attributes that can be updated via PATCH. At least one attribute must be provided. Labels and tags support add/remove operations for atomic modifications.
3 properties
AssetPatchData
object
3 properties 3 required
ProposedBaseImages
object
Categorized base image upgrade recommendations
3 properties
AssetPatchRequestBody
object
1 property 1 required
AssetListResponse
object
3 properties
FilterValueData
object
3 properties 2 required
PaginationLinks
object
Cursor-based pagination links
4 properties
JsonApiVersion
object
1 property 1 required
FilterFieldData
object
4 properties 2 required
RootFs
object
Root filesystem information with ordered layer diff IDs. Each diffid is a SHA256 digest of the uncompressed layer content.
2 properties 2 required
DistributionDigest
object
Distribution digest information for a container image
2 properties
TagsReplace
object
Full replacement of all tags on the asset. All existing tags will be removed and replaced with the provided tags.
GroupFieldsResponse
object
2 properties 2 required
LabelsUpdate
object
Updates the asset's labels by adding or removing label values. At least one of 'add' or 'remove' must be provided.
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

snyk-inventory-assets-api-openapi.yml Raw ↑

Other APIs Snyk publishes across the network.

Snyk REST API - Apps (OAuth)
Snyk V1 API (Legacy)
Snyk OAuth2 API - Authorize
Snyk OAuth2 API - Token
Snyk MCP Server (Snyk Studio)
Snyk AccessRequests API
Snyk AiBom API
Snyk Apps API
Snyk Asset API
Snyk Audit Logs API
Snyk BrokerConnections API
Snyk BrokerContexts API
Where this information came from

This is an independent, third-party profile of Snyk Inventory Assets API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.