# Buckets

Buckets are used to store a set of SBOM parts. They can represent an organization's entities such as business units and product families, as well as top-level applications and their elements such as modules and containers. Buckets can be nested under other buckets to form a hierarchy.

## View All Buckets

 - [GET /sbom/v1/orgs/{orgId}/buckets](https://sbominsightsapi.redocly.app/openapi3/buckets/buckets_indexbuckets.md): Retrieves all the buckets for the given orgId.

Buckets can be filtered using any 'one' of the following parameters. 
|parameter | description|
|--- | ---|
| ids | comma separated list of bucket ids |
| name | bucket name |
| trailId | provide job id to list all the records that was created/updated during the job run  |

## Create Bucket

 - [POST /sbom/v1/orgs/{orgId}/buckets](https://sbominsightsapi.redocly.app/openapi3/buckets/buckets_createbucket.md): Create a bucket.

## Delete Bucket

 - [DELETE /sbom/v1/orgs/{orgId}/buckets/{bucketId}](https://sbominsightsapi.redocly.app/openapi3/buckets/buckets_deletebucket.md): Delete a bucket

## View Information for a Bucket

 - [GET /sbom/v1/orgs/{orgId}/buckets/{bucketId}](https://sbominsightsapi.redocly.app/openapi3/buckets/buckets_showbucket.md): Retrieve detailed information for the requested bucket

## Update Bucket

 - [PUT /sbom/v1/orgs/{orgId}/buckets/{bucketId}](https://sbominsightsapi.redocly.app/openapi3/buckets/buckets_updatebucket.md): Update bucket information for the given bucket id