Skip to main content
POST
Add Alternative

Path Parameters

workspaceId
string
required
projectId
string
required
id
string
required

Body

application/json
mode
enum<string>
required

pick = link to existing catalog entry; create = new family + item

Available options:
pick,
create
catalogFamilyId
string

(mode=pick) BigInt ID of the catalog family to link

catalogItemId
string

(mode=pick) BigInt ID of the catalog item to link

sourceSelection
object
name
string

(mode=create) Name for the new catalog family / project item

Maximum string length: 200
categoryId
string

(mode=create) BigInt ID of the category for the new family

Response

409 - application/json
statusCode
number
required
Example:

409

message
string
required
Example:

"Conflict"

code
string

UPPER_SNAKE_CASE domain error code. Present on validation / business-rule errors; absent on generic HTTP errors.

Example:

"VARIANT_COMBO_TAKEN"

entity
string

Entity type that caused the conflict (e.g. "ProjectItem"). Present when the error is entity-specific.