1. REST API for Oracle Commerce Cloud December 2017
  2. Tasks
  3. Admin
  4. Profiles

updateProfile

put

/ccadmin/v1/profiles/{id}

Update Profile. This operation is used to update customer name, email address, phone number, shipping address and email marketing flag status of a customer profile. Optionally takes the x-ccasset-language header to get translated content in another language.

Request

Supported Media Types
  • application/json
Path Parameters
id
Type: string
Required: true
The ID of the shopper profile to be updated.
Header Parameters
X-CCAsset-Language
Type: string
The asset language of the request
Body Parameter
Root Schema : updateProfile_request
Nested Schema : shippingAddress
Type: object
Default shipping address of the profile (Deprecated, please use 'shippingAddresses' instead).
Nested Schema : shippingAddresses
Type: array
List of shipping addresses associated with profile.
Nested Schema : items
Type: object

Response

Supported Media Types
  • application/json
200 Response
Following model is returned when operation succeeds.
Body
Root Schema : updateProfile_response
Nested Schema : dynamicProperties
Type: array
Read-only list of dynamic properties associated with profile along with meta-data.
Nested Schema : roles
Type: array
List of role assigned to the profile.
Nested Schema : shippingAddress
Type: object
Default shipping address of the profile (Deprecated, please use 'shippingAddresses' instead).
Nested Schema : shippingAddresses
Type: array
List of shipping addresses associated with profile.
Nested Schema : items
Type: object
Nested Schema : items
Type: object
Nested Schema : items
Type: object
Example application/json

{
    "derivedPriceListGroup":null,
    "lastName":"Anderson",
    "gender":"female",
    "catalog":null,
    "roles":[
        {
            "function":"buyer",
            "relativeTo":{
                "id":"900004"
            },
            "repositoryId":"100006"
        }
    ],
    "locale":"en",
    "parentOrganization":{
        "name":"Oracle",
        "repositoryId":"100001",
        "description":"Oracle Org",
        "active":true,
        "shippingAddress":{
        },
        "secondaryAddresses":[
            {
                "firstName":"Harry",
                "lastName":"Potter",
                "country":"United States",
                "phoneNumber":"9088988999",
                "city":"Arcadia",
                "address2":"Suite 400",
                "address1":"Grundy Lane",
                "postalCode":"91006",
                "repositoryId":"110033",
                "state":"CA"
            }
        ],
        "id":"900004",
        "billingAddress":{
        }
    },
    "shippingSurchargePriceList":null,
    "profileType":"b2b_user",
    "translations":{
    },
    "loyaltyPrograms":[
        {
            "programName":"XTRAREWARDS",
            "repositoryId":100001,
            "membershipId":"abc123",
            "programId":"prog1",
            "status":"Enrolled"
        },
        {
            "programName":"XTRAMILES",
            "repositoryId":100002,
            "membershipId":"xyz123",
            "programId":"prog2",
            "status":"RequestForEnrollment"
        }
    ],
    "id":"se-570031",
    "email":"kim@example.com",
    "daytimeTelephoneNumber":"212-555-1977",
    "derivedSalePriceList":null,
    "taxExempt":false,
    "receiveEmail":"yes",
    "active":"true",
    "priceListGroup":null,
    "dateOfBirth":null,
    "firstName":"Kim",
    "repositoryId":"se-570031",
    "shippingAddress":{
    },
    "billingAddress":{
    },
    "userType":null,
    "derivedShippingSurchargePriceList":null,
    "secondaryOrganizations":[
    ],
    "shippingAddresses":[
    ]
}
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| |------------------|------------------| |100088|You cannot remove the Approver role from this contact. The account has no other active Approvers. Approvals are still enabled and/or there are orders pending approval.| |22000|If the profile id passes is null or empty| |100089|You cannot deactivate this contact. The account has no other active Approvers. Approvals are still enabled and/or there are orders pending approval| |22001|If there was any internal error while getting the profile| |22002|If there was no profile found with the given id| |89003|If user is removing admin role for himself| |22007|If invalid input is provided| |89001|If invalid roles are provided| |22024|{0}({1}) must be a String| |22025|Format for loyaltyPrograms is incorrect. Please refer to API doc for more information| |22026|{0} is either missing or incorrect.| |22027|Invalid state is provided.
Body
Root Schema : errorModel
Type: object
Nested Schema : errors
Type: array
An optional list of errors if multiple errors were encountered
Nested Schema : items
Type: object

Examples

Sample Request:

{
  "firstName": "kim",
  "lastName": "Anderson",
  "profileType": "b2b_user",
  "gender": "female",
  "loyaltyPrograms": [
    {
      "programName": "XTRAREWARDS",
      "membershipId": "abc123",
      "programId": "prog1",
      "status": "Enrolled"
    },
    {
      "programName": "XTRAMILES",
      "membershipId": "xyz123",
      "programId": "prog2",
      "status": "Enrolled"
    }
  ],
  "roles": [{
    "funtion": "buyer",
    "relativeTo": {"id": "900004"}
  }],
  "receiveEmail": "yes",
  "active": true,
  "dateOfBirth": null,
  "parentOrganization": "900004",
  "email": "kim@example.com",
  "daytimeTelephoneNumber": "212-555-1977"
}

Sample Response Payload returned by endpoint:

{
  "derivedPriceListGroup": null,
  "lastName": "Anderson",
  "gender": "female",
  "catalog": null,
  "roles": [{
    "function": "buyer",
    "relativeTo": {"id": "900004"},
    "repositoryId": "100006"
  }],
  "locale": "en",
  "parentOrganization": {
    "name": "Oracle",
    "repositoryId": "100001",
    "description": "Oracle Org",
    "active": true,
    "shippingAddress": {},
    "secondaryAddresses": [{
      "firstName": "Harry",
      "lastName": "Potter",
      "country": "United States",
      "phoneNumber": "9088988999",
      "city": "Arcadia",
      "address2": "Suite 400",
      "address1": "Grundy Lane",
      "postalCode": "91006",
      "repositoryId": "110033",
      "state": "CA"
    }],
    "id": "900004",
    "billingAddress": {}
  },
  "shippingSurchargePriceList": null,
  "profileType": "b2b_user",
  "translations": {},
  "loyaltyPrograms": [
    {
      "programName": "XTRAREWARDS",
      "repositoryId": 100001,
      "membershipId": "abc123",
      "programId": "prog1",
      "status": "Enrolled"
    },
    {
      "programName": "XTRAMILES",
      "repositoryId": 100002,
      "membershipId": "xyz123",
      "programId": "prog2",
      "status": "RequestForEnrollment"
    }
  ],
  "id": "se-570031",
  "email": "kim@example.com",
  "daytimeTelephoneNumber": "212-555-1977",
  "derivedSalePriceList": null,
  "taxExempt": false,
  "receiveEmail": "yes",
  "active": "true",
  "priceListGroup": null,
  "dateOfBirth": null,
  "firstName": "Kim",
  "repositoryId": "se-570031",
  "shippingAddress": {},
  "billingAddress": {},
  "userType": null,
  "derivedShippingSurchargePriceList": null,
  "secondaryOrganizations": [],
  "shippingAddresses": []
}