Property Value Service

Back

Overview

Property values define the set of allowed values for a property (e.g. for a "Colour" property: Red, Blue, Green).

Related to:

• Properties — parent property definitions
• Product Property Values — values assigned to specific products

All operations are tenant-aware.

Database tables

• catalog.PropertyValue

Endpoints

Back to Catalog

GET

/api/v1/PropertyValues/property/{propertyId}

Returns all allowed values for a given property.

Route parameters:

• propertyId (long, required) - property identifier

Response:

• List<PropertyValueModel>

Authorization:

• [AllowAnonymous] — no token required

GET

/api/v1/PropertyValues/{id}

Returns a single property value by its identifier.

Route parameters:

• id (long, required) - property value identifier

Behavior:

• Returns 404 if not found

Response:

• PropertyValueModel

Authorization:

• [AllowAnonymous] — no token required

POST

/api/v1/PropertyValues

Creates a new allowed value for a property.

Request body (PropertyValueModel):

• PropertyId (long, required) - parent property
• Value (string, required) - the allowed value text
• SortOrder (int?, optional) - display order

Response:

• 201 Created — PropertyValueModel

Authorization:

• Requires Bearer Token
• Permission: FullManage

PUT

/api/v1/PropertyValues/{id}

Updates an existing property value.

Route parameters:

• id (long, required) - property value identifier

Request body (PropertyValueModel):

• All fields updated as provided

Response:

• 200 OK — PropertyValueModel

Authorization:

• Requires Bearer Token
• Permission: FullManage

DELETE

/api/v1/PropertyValues/{id}

Deletes a property value by its identifier.

Route parameters:

• id (long, required) - property value identifier

Response:

• 204 No Content

Authorization:

• Requires Bearer Token
• Permission: FullManage

Notes

• Deleting a value does not remove it from products that already have it assigned
• All state-changing operations are audited
• Internal errors are logged but not exposed to clients