Update User Email Preferences
OVERVIEW
Overview
Update a user's Email Preferences in Publisher
This API call is used to update a user's Email Preferences in the system, by replacing the Email Preferences with the provided Email Preferences object.
Since v4.6
HTTP Request
PUT /api/2/users/<ID>/emailpreferences
OR
PUT /api/2/users/<EMAIL>/emailpreferences
URL Parameters
Parameter | Description |
---|---|
ID | The ID of the user |
The email address of the user |
HTTP Request Object
Email Preferences object, either in JSON or XML format.
HTTP Headers
HTTP Request Header | Description | Example |
---|---|---|
Authorization | The API Authorisation token. | "Bearer XXXXXXXXXXXXX" |
Accept |
The format of the expected response.
If no parameter is set, JSON is the default response given. |
"application/xml" |
Content-Type |
The format of the provided content.
If no parameter is set, JSON is the expected content by default. |
"application/json" |
HTTP Response
Success
HTTP response 200 with Email Preferences summary object
(Example below)
Error
Example HTTP Request & Response
PUT
http://example.com/context/api/2/users/3/emailpreferenc
es
JSON Request
{
"emailpreferences": {
"frequency": "Daily",
"metadatanodes": [
{
"node": "Countries",
"metadata": [
"Algeria",
"Angola",
"Benin"
]
},
{
"node": "American States",
"metadata": [
"Alabama",
"Alaska",
"Arizona"
]
}
],
"modules": [
{
"name": "Publications",
"preference": "Include"
},
{
"name": "Events",
"preference": "Off"
},
{
"name": "News",
"preference": "Custom",
"frequency": "Weekly",
"metadatanodes": [
{
"node": "Countries",
"metadata": [
"Algeria",
"Angola",
"Benin"
]
},
{
"node": "American States",
"metadata": [
"Alabama",
"Alaska",
"Arizona"
]
}
]
}
],
"alertservices": [
{
"name": "Email alert ABC",
"preference": "On"
},
{
"name": "Email alert XYZ",
"preference": "Off"
}
]
}
}
JSON Response
{
"emailpreferences": {
"userid": 3,
"link": "http://example.com/context/api/2/users/3/emailpreferences"
}
}
Comments
0 Comments