# Product and vendor profiles API The **Product and Vendor Profiles API** allows you to manage vendor and product profiles within the SoftwareOne Marketplace platform. It allows you to programmatically: * Create and manage vendor profiles. * Create and manage product profiles. * Publish and unpublish catalog entries. * Manage categories, industries, and segments used to organize the catalog. Access to this API is role-based. Clients can view published items only, vendors can manage their own vendor and product profiles, and SoftwareOne Operations have full access to all entities and states. ## Core Concepts The Program API is built around the following core resources: * **Vendor profile** - Represents a `vendor` in the public catalog. * **Product profile** - Represents a `product` in the public catalog. * **Category** - Represents a software category or sub-category, used to classify software in the public catalog. * **Industry** - Represents specific business sectors or markets that products are designed to serve. * **Segment** - Categorizes `products` based on the size and type of organizations for which they are most suitable. ## Collections The API is organized into collections, each containing a set of operations. Access to these operations varies by role, depending on whether you are a `client`, `vendor`, or `operations` user. Refer to the following capability matrix to see which roles are authorized to perform specific operations within each collection: ### Vendor Profile

Capability	Public	Client	Vendor	Operations
List vendor profiles	✅	✅	✅	✅
Get vendor profile details	✅	✅	✅	✅
Create vendor profile	❌	❌	❌	✅
Publish vendor profile	❌	❌	✅	✅
Modify vendor profile	❌	❌	✅	✅
Delete vendor profile	❌	❌	❌	✅

### Product Profile

Capability	Public	Client	Vendor	Operations
List product profiles	✅	✅	✅	✅
Get product profile details	✅	✅	✅	✅
Create product profile	❌	❌	❌	✅
Publish product profile	❌	❌	✅	✅
Unpublish product profile	❌	❌	✅	✅
Modify product profile	❌	❌	✅	✅
Delete product profile	❌	❌	❌	✅

### Categories

Capability	Public	Client	Vendor	Operations
List categories	✅	✅	✅	✅
Get a specific category	✅	✅	✅	✅
Create category	❌	❌	❌	✅
Publish category	❌	❌	❌	✅
Unpublish category	❌	❌	❌	✅
Modify category	❌	❌	❌	✅
Delete category	❌	❌	❌	✅

### Industries

Capability	Public	Client	Vendor	Operations
List industries	✅	✅	✅	✅
Get a specific industry	✅	✅	✅	✅
Create industry	❌	❌	❌	✅
Publish industry	❌	❌	❌	✅
Unpublish industry	❌	❌	❌	✅
Modify industry	❌	❌	❌	✅
Delete industry	❌	❌	❌	✅

### Segments

Capability	Public	Client	Vendor	Operations
List segments	✅	✅	✅	✅
Get a specific segment	✅	✅	✅	✅
Create segment	❌	❌	❌	✅
Publish segment	❌	❌	❌	✅
Unpublish segment	❌	❌	❌	✅
Modify segment	❌	❌	❌	✅
Delete segment	❌	❌	❌	✅

--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.platform.softwareone.com/developer-resources/rest-api/product-and-vendor-profiles-api.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.