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

Create or update a price tag

put

https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/priceTag/{id}

Creates or updates the price tag with the specified ID.

Request

Path Parameters
Supported Media Types
Request Body - application/json ()
Root Schema : PriceTagOracle
Type: object
Title: PriceTagOracle
The price tag resource.
Show Source
Nested Schema : priceTagRules
Type: array
A list of price tag rules associated with the price tag.
Show Source
Nested Schema : ProjectRef
Type: object
Title: ProjectRef
The project reference resource.
Show Source
Nested Schema : TimePeriod
Type: object
Title: TimePeriod
The period for which the productOffering is valid.
Show Source
Nested Schema : PriceTagRuleOracle
Type: object
Title: PriceTagRuleOracle
The price tag rule resource.
Show Source
Nested Schema : BalanceElementRef
Type: object
Title: BalanceElementRef
The balance element ref in price.
Show Source
Nested Schema : serviceSpecification
Type: array
A list of service specifications associated with the price tag rule.
Show Source
Nested Schema : ServiceSpecificationRefOracle
Title: ServiceSpecificationRefOracle
Match All
Show Source
  • ServiceSpecificationRef
    Title: ServiceSpecificationRef
    Discriminator: { "propertyName":"@type", "mapping":{ "ServiceSpecificationRef":"#/components/schemas/ServiceSpecificationRef", "ServiceSpecificationRefOracle":"#/components/schemas/ServiceSpecificationRefOracle" } }
    The service specification reference: ServiceSpecification(s) required to realize a ProductSpecification.
  • ServiceSpecificationRefOracle-allOf[1]
Nested Schema : ServiceSpecificationRef
Type: object
Title: ServiceSpecificationRef
Discriminator: @type

Discriminator Values

The service specification reference: ServiceSpecification(s) required to realize a ProductSpecification.
Show Source
Nested Schema : ServiceSpecificationRefOracle-allOf[1]
Type: object
Show Source
Back to Top

Response

Supported Media Types

200 Response

The price tag was created or updated successfully.
Body ()
Root Schema : PriceTagOracle
Type: object
Title: PriceTagOracle
The price tag resource.
Show Source
Nested Schema : priceTagRules
Type: array
A list of price tag rules associated with the price tag.
Show Source
Nested Schema : ProjectRef
Type: object
Title: ProjectRef
The project reference resource.
Show Source
Nested Schema : TimePeriod
Type: object
Title: TimePeriod
The period for which the productOffering is valid.
Show Source
Nested Schema : PriceTagRuleOracle
Type: object
Title: PriceTagRuleOracle
The price tag rule resource.
Show Source
Nested Schema : BalanceElementRef
Type: object
Title: BalanceElementRef
The balance element ref in price.
Show Source
Nested Schema : serviceSpecification
Type: array
A list of service specifications associated with the price tag rule.
Show Source
Nested Schema : ServiceSpecificationRefOracle
Title: ServiceSpecificationRefOracle
Match All
Show Source
  • ServiceSpecificationRef
    Title: ServiceSpecificationRef
    Discriminator: { "propertyName":"@type", "mapping":{ "ServiceSpecificationRef":"#/components/schemas/ServiceSpecificationRef", "ServiceSpecificationRefOracle":"#/components/schemas/ServiceSpecificationRefOracle" } }
    The service specification reference: ServiceSpecification(s) required to realize a ProductSpecification.
  • ServiceSpecificationRefOracle-allOf[1]
Nested Schema : ServiceSpecificationRef
Type: object
Title: ServiceSpecificationRef
Discriminator: @type

Discriminator Values

The service specification reference: ServiceSpecification(s) required to realize a ProductSpecification.
Show Source
Nested Schema : ServiceSpecificationRefOracle-allOf[1]
Type: object
Show Source

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 a price tag by submitting a PUT request on the REST resource using cURL.

cURL Command

curl -u username:password -X PUT https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/priceTag/{id}

Example of Request Body

The following shows the contents of the request body in JSON format.

{
    "id": "PDC-PRICETAG",
    "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/priceTag/PDC-PRICETAG",
    "name": "PDC-PRICETAG",
    "lifecycleStatus": "In design",
    "version": "1.0",
    "@type": "PriceTagOracle",
    "project": {
        "id": "P-3454289648-1759125844206",
        "name": "PDC-INITIATIVE",
        "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogManagement/v1/project/P-3454289648-1759125844206",
        "version": "1.0",
        "@referredType": "ProjectOracle"
    },
    "priceTagRules": [
        {
            "id": "PT-RULE-01",
            "unitOfMeasure": "MINUTE",
            "productType": "SERVICE",
            "serviceSpecification": [
                {
                    "id": "SS-1193122351-1759125892052",
                    "name": "PDC-SERVICE-SPEC",
                    "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/tmf-api/serviceCatalogManagement/v3/serviceSpecification/SS-1193122351-1759125892052",
                    "version": "1.0",
                    "@referredType": "ServiceSpecificationOracle",
                    "@type": "ServiceSpecificationRef"
                }
            ],
            "valueType": "LIST",
            "balanceElementCode": "USD",
            "value": "10;20",
            "balanceElement": {
                "id": "USDCurrency",
                "name": "USD Currency",
                "@referredType": "BalanceElementOracle",
                "@type": "BalanceElementRef",
                "version": "1.0"
            }
        },
        {
            "id": "PT-RULE-02",
            "unitOfMeasure": "ALL",
            "productType": "ALL",
            "valueType": "LIST",
            "balanceElementCode": "ALL"
        }
    ]
}

Example of Response Body

The following shows the contents of the response body in JSON format.

{
    "id": "PDC-PRICETAG",
    "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogReferenceManagement/v1/priceTag/PDC-PRICETAG",
    "name": "PDC-PRICETAG",
    "lastUpdate": "2025-10-24T08:01:10.009Z",
    "lifecycleStatus": "In design",
    "version": "1.0",
    "@type": "PriceTagOracle",
    "project": {
        "id": "P-3454289648-1759125844206",
        "name": "PDC-INITIATIVE",
        "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/productCatalogManagement/v1/project/P-3454289648-1759125844206",
        "version": "1.0",
        "@referredType": "ProjectOracle"
    },
    "priceTagRules": [
        {
            "id": "PT-RULE-01",
            "unitOfMeasure": "MINUTE",
            "productType": "SERVICE",
            "serviceSpecification": [
                {
                    "id": "SS-1193122351-1759125892052",
                    "name": "PDC-SERVICE-SPEC",
                    "href": "https://{FusionAppsHost}/crmRestApi/atcProductCatalog/11.13.18.05/tmf-api/serviceCatalogManagement/v3/serviceSpecification/SS-1193122351-1759125892052",
                    "version": "1.0",
                    "@referredType": "ServiceSpecificationOracle",
                    "@type": "ServiceSpecificationRef"
                }
            ],
            "valueType": "LIST",
            "balanceElementCode": "USD",
            "value": "10;20"
        },
        {
            "id": "PT-RULE-02",
            "unitOfMeasure": "ALL",
            "productType": "ALL",
            "valueType": "LIST",
            "balanceElementCode": "ALL"
        }
    ],
    "lastUpdatedBy": "booth",
    "created": "2025-10-09T08:22:39.000Z",
    "createdBy": "booth"
}
Back to Top