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

updateAudience

put

/ccadmin/v1/audiences/{id}

Update Audience. This operation is used to update an audience in Oracle Commerce Cloud.

Request

Supported Media Types
  • application/json
Path Parameters
id
Type: string
Required: true
The audience id.
Body Parameter
Root Schema : updateAudience_request
Nested Schema : ruleSet
Type: object
The rule set for the Audience.
Nested Schema : rules
Type: array
The array of rules that make up the rule set.
Nested Schema : items
Type: object

Response

Supported Media Types
  • application/json
200 Response
Following model is returned when operation succeeds.
Body
Root Schema : updateAudience_response
Nested Schema : ruleSet
Type: object
The rule set for the Audience.
Nested Schema : rules
Type: array
An array of rules that make up the rule set.
Nested Schema : items
Type: object
Example application/json

{
    "useInReports":"false",
    "deleted":"false",
    "displayName":"Audience One",
    "ruleSet":{
        "rules":[
            {
                "property":"user.gender",
                "category":"profile",
                "value":"male",
                "operator":"eq"
            }
        ],
        "operator":"all"
    },
    "description":"blah blah blah",
    "id":"audience1",
    "enabled":"true"
}
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| |------------------|------------------| |54020|The value of an enumList rule must be an array.| |54002|A non-empty audience name is required.| |54013|The audience rule set is missing a top level operator.| |54024|The audience ID must be 165 characters or less.| |54012|The JSON description of the rule set {0} is invalid.| |54023|Audience IDs must only contain the characters A-Z, a-z, and 0-9.| |54022|The audience ID already exists. Audience IDs must be unique.| |54021|A non-empty audience ID is required.| |54017|The rule set has valid JSON but a problem was encountered while translating to SGML.| |54016|Audience rule at index {0} is invalid.| |54004|An error occurred accessing audiences.| |54015|The audience rule set rules array is missing or invalid.| |54026|The audience description is too long.| |54003|The audience name already exists. Audience names must be unique.| |54014|The top level operator {0} must be either any or all.| |54025|The audience name is too long.| |54009|The audience repository was not initialized.| |54019|The operator {0} for an internalAudience rule must be either includesAny, notIncludesAny or includesAll.| |54007|An error occurred rolling back an audiences transaction.| |54018|The rule operator {0} is not supported. Rule operators must be one of the following: eq, ne, isOneOf, isNotOneOf, contains, containsIgnoreCase, startsWith, startsWithIgnoreCase, endsWith, endsWithIgnoreCase, includesAny, includesAll, notIncludesAny.| |54051|Rule {0} has invalid values. The first value for the "between" operator must be less than the second value.| |54049|Rule {0} has an invalid double value. Double values must be in the right format and between the max and min double values.| |54047|Rule {0} has an invalid float value. Float values must be in the right format and between the max and min float values.| |54050|Rule {0} has an invalid integer value. Integer values must be whole numbers between the max and min integer values.|
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:

{
  "useInReports": "false",
  "displayName": "Audience One",
  "ruleSet": {
    "rules": [{
      "property": "user.gender",
      "category": "profile",
      "value": "male",
      "operator": "eq"
    }],
    "operator": "all"
  },
  "description": "blah blah blah",
  "enabled": "true"
}

Sample Response Payload returned by endpoint:

{
  "useInReports": "false",
  "deleted": "false",
  "displayName": "Audience One",
  "ruleSet": {
    "rules": [{
      "property": "user.gender",
      "category": "profile",
      "value": "male",
      "operator": "eq"
    }],
    "operator": "all"
  },
  "description": "blah blah blah",
  "id": "audience1",
  "enabled": "true"
}