1. REST API for Oracle Commerce Cloud 21C
  2. Tasks
  3. Admin
  4. Sites

updateSite

put

/ccadmin/v1/sites/{id}

Update Site. Update a site based on ID and request parameters. Note that only a subset of properties can vary by site. **Requires the x-ccasset-language header so translated content can be set for a specific language.**

Request

Supported Media Types
Path Parameters
Header Parameters
Body ()
Root Schema : updateSite_request
Type: object
Show Source
Example:
{
    "properties":{
        "priceListGroupList":[
            {
                "id":"EURO"
            },
            {
                "id":"defaultPriceGroup"
            }
        ],
        "inventoryLocationId":"SiteUS-GlenAllen187",
        "name":"CloudLake US Site test",
        "siteTypes":[
            "b2bCommerce"
        ]
    }
}
Nested Schema : properties
Type: object
Object with updatable properties.
Show Source
Nested Schema : additionalLocaleIds
Type: array
Additional locale IDs.
Show Source
Nested Schema : additionalProductionURLs
Type: array
The additional production URLs.
Show Source
Nested Schema : defaultCatalog
Type: object
The default catalog.
Show Source
Nested Schema : defaultPriceListGroup
Type: object
Default priceListGroup to be associated with site.
Show Source
Nested Schema : loyaltyPrograms
Type: array
List of loyalty programs associated with site.
Show Source
Nested Schema : priceListGroupList
Type: array
List of priceListGroups to be associated with site.
Show Source
Nested Schema : shipFromAddress
Type: object
The ship from address used for tax calculations.
Show Source
Nested Schema : siteTypes
Type: array
List of site types supported by this site
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
Back to Top

Response

Supported Media Types

200 Response

Following model is returned when operation succeeds.
Body ()
Root Schema : updateSite_response
Type: object
Show Source
Nested Schema : additionalLocaleIds
Type: array
Additional Country ids.
Show Source
Nested Schema : additionalProductionURLs
Type: array
A list of additional production URLs (without schema). Currently, only plain hostnames are supported.
Show Source
Nested Schema : allowedOriginMethods
Type: object
Additional Properties Allowed
Show Source
Map of hostname (key) and the allowed http methods (values) for that host.
Nested Schema : defaultCatalog
Type: object
The default catalog id.
Show Source
Nested Schema : defaultPriceListGroup
Type: object
The default PLG for the site.
Show Source
Nested Schema : loyaltyPrograms
Type: array
List of loyalty programs associated with site.
Show Source
Nested Schema : priceListGroupList
Type: array
List of Price List Groups associated with the site including default Price List Group
Show Source
Nested Schema : shipFromAddress
Type: object
The ship from address used for tax calculations.
Show Source
Nested Schema : siteTypes
Type: array
List of site types supported by this site
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
Example Response (application/json)
{
    "priceListGroupList":[
        {
            "repositoryId":"defaultPriceGroup",
            "id":"defaultPriceGroup"
        },
        {
            "repositoryId":"EURO",
            "id":"EURO"
        }
    ],
    "inventoryLocationId":"SiteUS-GlenAllen187",
    "useDefaultSiteLocale":false,
    "timezone":"europe_london",
    "secondaryCurrency":"USD",
    "requireGDPRP13nConsent":false,
    "type":"siteConfiguration",
    "defaultBillingCountryId":"US",
    "defaultShippingCountryId":"US",
    "enabled":true,
    "payTaxInSecondaryCurrency":true,
    "requireGDPRCookieConsent":false,
    "timeToLive":5000,
    "defaultLocaleId":"1",
    "loyaltyPrograms":[
        {
            "programName":"Movie rewards",
            "repositoryId":"siteUS_LP0001",
            "associationDate":"2017-07-05T14:15:37.000Z",
            "programId":"LP0001"
        }
    ],
    "id":"siteUS",
    "additionalLocaleIds":[
        "1"
    ],
    "favicon":null,
    "allowAlternateCurrency":true,
    "noimage":null,
    "payShippingInSecondaryCurrency":true,
    "siteTypes":[
        "b2bCommerce"
    ],
    "shipFromAddress":{
        "country":"US",
        "city":"Cambridge",
        "postalCode":"02142",
        "addressLine1":"1 Main Street",
        "addressLine2":"Foo",
        "addressLine3":"Bar",
        "region":"MA"
    },
    "name":"CloudLake US Site",
    "repositoryId":"siteUS"
}

Default Response

The error response. The following are the internal error codes thrown by this API when the request processing fails in Oracle Commerce Cloud: |Error Code|Description| |------------------|------------------| |100092|{0} is an invalid value for {1}.| |30001|A site id is required to update a site| |30004|Given Site id does not exist| |30015|Invalid Site Base URL ''{0}'' specified.| |30003|Update site failed| |30014|Could not update site. Allowed site types are {0}| |25015|set Property RepositoryItem Internal Error| |25014|convert Input Property Type Internal Error| |100092|The value ''{0}'' for parameter ''{1}'' is not among the {2,number,integer} valid options. Showing the first {3,number,integer} valid options: {4}
Body ()
Root Schema : errorModel
Type: object
Show Source
Nested Schema : errors
Type: array
An optional list of errors if multiple errors were encountered
Show Source
Nested Schema : items
Type: object
Show Source
Back to Top