1. REST API Reference for Launch Cloud Service
  2. Tasks
  3. Attributes

Create or update an attribute

put

https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogManagement/v1/attribute/{id}

Creates or updates the attribute with the specified ID.

Request

Path Parameters
Supported Media Types
Request Body - application/json ()
Root Schema : AttributeOracle
Type: object
Title: AttributeOracle
The attribute resource.
Show Source
Nested Schema : allowedUnits
Type: array
A list of allowed units associated with the attribute.
Show Source
Nested Schema : attributeRelationship
Type: array
A list of attribute relationships associated with the attribute.
Show Source
Nested Schema : attributeValue
Type: array
A list of attribute values associated with the attribute.
Show Source
  • CharacteristicValueSpecification
    Title: CharacteristicValueSpecification
    Discriminator: { "propertyName":"@type", "mapping":{ "CharacteristicValueSpecification":"#/components/schemas/CharacteristicValueSpecification", "StringCharacteristicValueSpecification":"#/components/schemas/StringCharacteristicValueSpecification", "ObjectCharacteristicValueSpecification":"#/components/schemas/ObjectCharacteristicValueSpecification", "StringArrayCharacteristicValueSpecification":"#/components/schemas/StringArrayCharacteristicValueSpecification", "MapCharacteristicValueSpecification":"#/components/schemas/MapCharacteristicValueSpecification", "NumberCharacteristicValueSpecification":"#/components/schemas/NumberCharacteristicValueSpecification", "MapArrayCharacteristicValueSpecification":"#/components/schemas/MapArrayCharacteristicValueSpecification", "ObjectArrayCharacteristicValueSpecification":"#/components/schemas/ObjectArrayCharacteristicValueSpecification", "NumberArrayCharacteristicValueSpecification":"#/components/schemas/NumberArrayCharacteristicValueSpecification", "IntegerCharacteristicValueSpecification":"#/components/schemas/IntegerCharacteristicValueSpecification", "IntegerArrayCharacteristicValueSpecification":"#/components/schemas/IntegerArrayCharacteristicValueSpecification", "StringCharacteristicValueSpecificationOracle":"#/components/schemas/StringCharacteristicValueSpecificationOracle", "ObjectCharacteristicValueSpecificationOracle":"#/components/schemas/ObjectCharacteristicValueSpecificationOracle", "StringArrayCharacteristicValueSpecificationOracle":"#/components/schemas/StringArrayCharacteristicValueSpecificationOracle", "MapCharacteristicValueSpecificationOracle":"#/components/schemas/MapCharacteristicValueSpecificationOracle", "NumberCharacteristicValueSpecificationOracle":"#/components/schemas/NumberCharacteristicValueSpecificationOracle", "MapArrayCharacteristicValueSpecificationOracle":"#/components/schemas/MapArrayCharacteristicValueSpecificationOracle", "ObjectArrayCharacteristicValueSpecificationOracle":"#/components/schemas/ObjectArrayCharacteristicValueSpecificationOracle", "NumberArrayCharacteristicValueSpecificationOracle":"#/components/schemas/NumberArrayCharacteristicValueSpecificationOracle", "IntegerCharacteristicValueSpecificationOracle":"#/components/schemas/IntegerCharacteristicValueSpecificationOracle", "IntegerArrayCharacteristicValueSpecificationOracle":"#/components/schemas/IntegerArrayCharacteristicValueSpecificationOracle" } }
    A number or text that can be assigned to a ProductSpecCharacteristic.
Nested Schema : ProjectRef
Type: object
Title: ProjectRef
The project reference resource.
Show Source
Nested Schema : TimePeriodOracle
Type: object
Title: TimePeriodOracle
The validity period of the related party.
Show Source
Nested Schema : AttributeRelationshipOracle
Type: object
Title: AttributeRelationshipOracle
An aggregation, migration, substitution, dependency or exclusivity relationship between/among attributes.
Show Source
Nested Schema : CharacteristicValueSpecification
Type: object
Title: CharacteristicValueSpecification
Discriminator: @type

Discriminator Values

A number or text that can be assigned to a ProductSpecCharacteristic.
Show Source
  • The base type of the characteristic value specification.
  • The URI of the schema that defines the characteristic value specification.
  • The class type of the characteristic value specification.
  • Whether the characteristic value specification is default.
  • Allowed Values: [ "OPEN", "CLOSED", "CLOSED_BOTTOM", "CLOSED_TOP" ]
    An indicator that specifies the inclusion or exclusion of the valueFrom and valueTo attributes. If applicable, possible values are "open", "closed", "closedBottom" and "closedTop". Valid values are OPEN, CLOSED, CLOSED_BOTTOM, and CLOSED_TOP.
  • The regular expression to define constraint on the allowed value.
  • Allowed Values: [ "NONE", "SECOND", "MINUTE", "HOUR", "DAY", "MONTH", "BYTE", "KILOBYTE", "MEGABYTE", "GIGABYTE", "PAGES", "MOVIES", "TIME_INTERVAL", "QUANTITY", "MBPS", "GBPS" ]
    The unit can be minutes or GB.
  • TimePeriodOracle
    Title: TimePeriodOracle
    The validity period of the related party.
  • The low range value that a characteristic can take on.
  • The upper range value that a characteristic can take on.
  • Allowed Values: [ "STRING", "NUMBER", "OBJECT", "ARRAY", "DECIMAL", "BOOLEAN", "DATE", "DATETIME", "URL" ]
    The type or classification of the characteristic value specification. Valid values are STRING, NUMBER, OBJECT, ARRAY, DECIMAL, BOOLEAN, DATE, DATETIME, and URL.
Back to Top

Response

Supported Media Types

200 Response

The attribute was created or updated successfully.
Body ()
Root Schema : AttributeOracle
Type: object
Title: AttributeOracle
The attribute resource.
Show Source
Nested Schema : allowedUnits
Type: array
A list of allowed units associated with the attribute.
Show Source
Nested Schema : attributeRelationship
Type: array
A list of attribute relationships associated with the attribute.
Show Source
Nested Schema : attributeValue
Type: array
A list of attribute values associated with the attribute.
Show Source
  • CharacteristicValueSpecification
    Title: CharacteristicValueSpecification
    Discriminator: { "propertyName":"@type", "mapping":{ "CharacteristicValueSpecification":"#/components/schemas/CharacteristicValueSpecification", "StringCharacteristicValueSpecification":"#/components/schemas/StringCharacteristicValueSpecification", "ObjectCharacteristicValueSpecification":"#/components/schemas/ObjectCharacteristicValueSpecification", "StringArrayCharacteristicValueSpecification":"#/components/schemas/StringArrayCharacteristicValueSpecification", "MapCharacteristicValueSpecification":"#/components/schemas/MapCharacteristicValueSpecification", "NumberCharacteristicValueSpecification":"#/components/schemas/NumberCharacteristicValueSpecification", "MapArrayCharacteristicValueSpecification":"#/components/schemas/MapArrayCharacteristicValueSpecification", "ObjectArrayCharacteristicValueSpecification":"#/components/schemas/ObjectArrayCharacteristicValueSpecification", "NumberArrayCharacteristicValueSpecification":"#/components/schemas/NumberArrayCharacteristicValueSpecification", "IntegerCharacteristicValueSpecification":"#/components/schemas/IntegerCharacteristicValueSpecification", "IntegerArrayCharacteristicValueSpecification":"#/components/schemas/IntegerArrayCharacteristicValueSpecification", "StringCharacteristicValueSpecificationOracle":"#/components/schemas/StringCharacteristicValueSpecificationOracle", "ObjectCharacteristicValueSpecificationOracle":"#/components/schemas/ObjectCharacteristicValueSpecificationOracle", "StringArrayCharacteristicValueSpecificationOracle":"#/components/schemas/StringArrayCharacteristicValueSpecificationOracle", "MapCharacteristicValueSpecificationOracle":"#/components/schemas/MapCharacteristicValueSpecificationOracle", "NumberCharacteristicValueSpecificationOracle":"#/components/schemas/NumberCharacteristicValueSpecificationOracle", "MapArrayCharacteristicValueSpecificationOracle":"#/components/schemas/MapArrayCharacteristicValueSpecificationOracle", "ObjectArrayCharacteristicValueSpecificationOracle":"#/components/schemas/ObjectArrayCharacteristicValueSpecificationOracle", "NumberArrayCharacteristicValueSpecificationOracle":"#/components/schemas/NumberArrayCharacteristicValueSpecificationOracle", "IntegerCharacteristicValueSpecificationOracle":"#/components/schemas/IntegerCharacteristicValueSpecificationOracle", "IntegerArrayCharacteristicValueSpecificationOracle":"#/components/schemas/IntegerArrayCharacteristicValueSpecificationOracle" } }
    A number or text that can be assigned to a ProductSpecCharacteristic.
Nested Schema : ProjectRef
Type: object
Title: ProjectRef
The project reference resource.
Show Source
Nested Schema : TimePeriodOracle
Type: object
Title: TimePeriodOracle
The validity period of the related party.
Show Source
Nested Schema : AttributeRelationshipOracle
Type: object
Title: AttributeRelationshipOracle
An aggregation, migration, substitution, dependency or exclusivity relationship between/among attributes.
Show Source
Nested Schema : CharacteristicValueSpecification
Type: object
Title: CharacteristicValueSpecification
Discriminator: @type

Discriminator Values

A number or text that can be assigned to a ProductSpecCharacteristic.
Show Source
  • The base type of the characteristic value specification.
  • The URI of the schema that defines the characteristic value specification.
  • The class type of the characteristic value specification.
  • Whether the characteristic value specification is default.
  • Allowed Values: [ "OPEN", "CLOSED", "CLOSED_BOTTOM", "CLOSED_TOP" ]
    An indicator that specifies the inclusion or exclusion of the valueFrom and valueTo attributes. If applicable, possible values are "open", "closed", "closedBottom" and "closedTop". Valid values are OPEN, CLOSED, CLOSED_BOTTOM, and CLOSED_TOP.
  • The regular expression to define constraint on the allowed value.
  • Allowed Values: [ "NONE", "SECOND", "MINUTE", "HOUR", "DAY", "MONTH", "BYTE", "KILOBYTE", "MEGABYTE", "GIGABYTE", "PAGES", "MOVIES", "TIME_INTERVAL", "QUANTITY", "MBPS", "GBPS" ]
    The unit can be minutes or GB.
  • TimePeriodOracle
    Title: TimePeriodOracle
    The validity period of the related party.
  • The low range value that a characteristic can take on.
  • The upper range value that a characteristic can take on.
  • Allowed Values: [ "STRING", "NUMBER", "OBJECT", "ARRAY", "DECIMAL", "BOOLEAN", "DATE", "DATETIME", "URL" ]
    The type or classification of the characteristic value specification. Valid values are STRING, NUMBER, OBJECT, ARRAY, DECIMAL, BOOLEAN, DATE, DATETIME, and URL.

400 Response

Your request couldn't be processed because it contains missing or invalid information, such as a validation error on an input field, a missing required value, and so forth.
Body ()
Root Schema : Error
Type: object
Title: Error
The error resource.
Show Source

401 Response

Your request isn't authorized. The authentication credentials included with this request are missing or invalid.
Body ()
Root Schema : Error
Type: object
Title: Error
The error resource.
Show Source

404 Response

The resource with the specified URI couldn't be found.
Body ()
Root Schema : Error
Type: object
Title: Error
The error resource.
Show Source

405 Response

HTTP action specified in the request (DELETE, GET, POST, PUT) isn't supported for this request URI.
Body ()
Root Schema : Error
Type: object
Title: Error
The error resource.
Show Source

500 Response

The server encountered something unexpected that prevented it from completing the request.
Body ()
Root Schema : Error
Type: object
Title: Error
The error resource.
Show Source
Back to Top

Examples

The following example shows how to create or update an attribute by submitting a put request on the REST resource using cURL.

curl  -H 'Authorization: Bearer <accessToken> -H PUT https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogManagement/v1/attribute/{id}

Example of Request Header

The following shows an example of the request header in JSON format.

{
    "id": "ATT-2358059661-1738156830369",
    "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogManagement/v1/attribute/ATT-2358059661-1738156830369",
    "name": "test-min-max-attr",
    "version": "1.0",
    "lifecycleStatus": "In design",
    "valueType": "NUMBER",
    "@type": "AttributeOracle",
    "configurable": true,
    "minCardinality": 0,
    "maxCardinality": 1,
    "validFor": {
        "startDateTime": "2025-01-29T00:00:00.000Z"
    },
    "attributeValue": [
        {
            "value": 0,
            "rangeInterval": "OPEN",
            "valueTo": "48",
            "valueFrom": "0",
            "valueType": "NUMBER",
            "isDefault": true,
            "validFor": {
                "startDateTime": "2025-01-29T00:00:00.000Z"
            },
            "@type": "NumberCharacteristicValueSpecification"
        }
    ],
    "project": {
        "id": "P-1662601049-1738156812821",
        "name": "test-fresh-pub",
        "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogManagement/v1/project/P-1662601049-1738156812821",
        "version": "1.0",
        "@referredType": "ProjectOracle"
    }
}

Example of Response Body

The following example shows the contents of the response body in JSON format:

{
    "id": "ATT-2358059661-1738156830369",
    "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogManagement/v1/attribute/ATT-2358059661-1738156830369",
    "name": "test-min-max-attr",
    "version": "1.0",
    "lifecycleStatus": "In design",
    "valueType": "NUMBER",
    "@type": "AttributeOracle",
    "configurable": true,
    "minCardinality": 0,
    "maxCardinality": 1,
    "validFor": {
        "startDateTime": "2025-01-29T00:00:00.000Z"
    },
    "attributeValue": [
        {
            "value": 0,
            "rangeInterval": "OPEN",
            "valueTo": "48",
            "valueFrom": "0",
            "valueType": "NUMBER",
            "isDefault": true,
            "validFor": {
                "startDateTime": "2025-01-29T00:00:00.000Z"
            },
            "@type": "NumberCharacteristicValueSpecification"
        }
    ],
    "lastUpdate": "2025-10-24T07:47:28.005Z",
    "lastUpdatedBy": "booth",
    "created": "2025-01-29T13:21:00.000Z",
    "createdBy": "booth",
    "project": {
        "id": "P-1662601049-1738156812821",
        "name": "test-fresh-pub",
        "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogManagement/v1/project/P-1662601049-1738156812821",
        "version": "1.0",
        "@referredType": "ProjectOracle"
    }
}
Back to Top