# Archetypes

Archetypes represents master 'types' that would be used across the system.

## View All Archetypes

 - [GET /sbom/v1/orgs/{orgId}/archetypes](https://sbominsightsapi.redocly.app/openapi3/archetypes/archetypes_indexarchetypes.md): Retrieve all the archetypes.

Archetypes can be filtered using any 'one' of the following parameters. 
|parameter | description|
|--- | ---|
| ids | comma separated list of archetype ids |
| categories | comma separated list of categories. For e.g : part_types, bucket_types, origin_types, link_types, file_types etc|
| trailId | provide job id to list all the records that was created/updated during the job run  |

## Create Archetype

 - [POST /sbom/v1/orgs/{orgId}/archetypes](https://sbominsightsapi.redocly.app/openapi3/archetypes/archetypes_createarchetype.md): Create an archetype.

## Delete Archetype

 - [DELETE /sbom/v1/orgs/{orgId}/archetypes/{archetypeId}](https://sbominsightsapi.redocly.app/openapi3/archetypes/archetypes_deletearchetype.md): Delete an existing archetype

## View Information for an Archetype

 - [GET /sbom/v1/orgs/{orgId}/archetypes/{archetypeId}](https://sbominsightsapi.redocly.app/openapi3/archetypes/archetypes_showarchetype.md): Retrieve an archetype

## Update Archetype

 - [PUT /sbom/v1/orgs/{orgId}/archetypes/{archetypeId}](https://sbominsightsapi.redocly.app/openapi3/archetypes/archetypes_updatearchetype.md): Update an existing archetype