Update a treatment definition group

put/definitionGroups/{groupId}

Internal-Use Only

Updates the specified treatment definition group based on the representation in the request body.

Request Samples

application/vnd.sas.treatment.definition.group+json
1

Response Samples

200
application/vnd.sas.treatment.definition.group+json
default
1{
2  "name": "My Treatment Definition Group",
3  "checkout": false,
4  "locked": false,
5  "sourceRevisionUri": "/treatmentDefinitions/definitionGroups/6b53e248-1afb-4147-b17a-13e75b8c759b/revisions/0340f630-3ee6-4058-ad36-744619c141d5",
6  "copyTimeStamp": "2020-06-17T13:37:01.750Z",
7  "members": [
8    {
9      "definitionId": "60095dcd-b2ca-4705-8cf6-aa693fce1692"
10    },
11    {
12      "definitionId": "60095dcd-b2ca-4705-8cf6-aa693fce1692",
13      "definitionRevisionId": "f813702e-dff8-443e-a7af-727ab027fb7e",
14      "attributeValueMappings": [
15        {
16          "attributeId": "fdb1e22e-5358-4311-a914-eec901c2da5f",
17          "mappingType": "variable",
18          "value": "Discount"
19        },
20        {
21          "attributeId": "7c17cbaf-dd3d-4288-b6a9-54ae7c7c91c6",
22          "mappingType": "constant",
23          "value": "Samsung"
24        },
25        {
26          "attributeId": "a0a3b4d4-fc28-4194-84dd-fe2dc3286009",
27          "mappingType": "variable",
28          "value": "Clicked"
29        }
30      ],
31      "attributeNameAliases": [
32        {
33          "attributeId": "fdb1e22e-5358-4311-a914-eec901c2da5f",
34          "aliasName": "Discount ID"
35        }
36      ]
37    }
38  ]
39}

Path Parameters

Name	Type	Required	Description
groupId	string	true	The unique identifier for the treatment definition group. Examples: "da85cd3c-7c7a-437c-acac-eca2819c9a6d"

Header Parameters

Name	Type	Required	Description
If-Match	string	true	Etag of content payload that was updated. Examples: "\"kknyjgku\""

Request Body

The representation of a treatment definition group.

Example:

{"name":"My Treatment Definition Group","checkout":false,"locked":false,"sourceRevisionUri":"/treatmentDefinitions/definitionGroups/6b53e248-1afb-4147-b17a-13e75b8c759b/revisions/0340f630-3ee6-4058-ad36-744619c141d5","copyTimeStamp":"2020-06-17T13:37:01.750Z","members":[{"definitionId":"60095dcd-b2ca-4705-8cf6-aa693fce1692"},{"definitionId":"60095dcd-b2ca-4705-8cf6-aa693fce1692","definitionRevisionId":"f813702e-dff8-443e-a7af-727ab027fb7e","attributeValueMappings":[{"attributeId":"fdb1e22e-5358-4311-a914-eec901c2da5f","mappingType":"variable","value":"Discount"},{"attributeId":"7c17cbaf-dd3d-4288-b6a9-54ae7c7c91c6","mappingType":"constant","value":"Samsung"},{"attributeId":"a0a3b4d4-fc28-4194-84dd-fe2dc3286009","mappingType":"variable","value":"Clicked"}],"attributeNameAliases":[{"attributeId":"fdb1e22e-5358-4311-a914-eec901c2da5f","aliasName":"Discount ID"}]}]}

Name	Type	Required	Description
name	string	true	The treatment definition group name.
description	string	false	The treatment definition group description.
locked	boolean	false	Flag which indicates if the content of the revision being viewed is locked or editable.
activationStatus	string<enumeration>	false	Status of the activation. Allowed values: activeinactivependingrunningcancelledtimedOutfailed
activationError	Error	false	The representation of an error.
activatedTimeStamp	string<date-time>	false	The date and time that the treatment definition group revision was activated.
status	string<enumeration>	false	Status of the treatment definition. Allowed values: validerror
members	array [Treatment Definition Group Member]	false	The group of treatment definition members.
folderType	string	false	Indicates the kind of folder where the treatment definition group is housed.
links	array [Link]	false	Zero or more links to related resources or operations.
version	integer	false	This media type's schema version number. This representation is version 4.

Responses

Status	Meaning	Description
200	OK	The request succeeded.	Headers	Schema
400	Bad Request	The request was invalid.	Headers	Schema
404	Not Found	No treatment definition group exists at the requested path.	Headers	Schema
412	Precondition Failed	The `If-Match` request header did not match the resource's entity tag.	Headers	Schema
428	Precondition Required	The request headers did not include a `If-Match` precondition.	Headers	Schema