Update Subscription

The Update Subscription command allows you to change the format of a Subscription.  See REST API Subscriptions Overview for a table of Subscription data available to PuT. 

PUT /subscriptions/[subscriptionId]

https://[siteurl]/rest/subscriptions/[subscriptionId]

Request Body Parameters

The Update Subscription command requires the subscription ID in the URI, and the following in the PUT JSON:

• Format: "formatId": [0,1,2,99], where 0=auto plain text 1=plain text, 2=html, and 99=MIME 

Request Body Example

Using Update Contact with all arguments, line breaks in JSON for readability:

curl --request PUT \ 
--url 'https://mail.mydomain.com/rest/subscriptions\120002' \ 
--header 'authorization: Basic bXlBY2NvdW50Onh5enB3ZDEyMw==' \ 
--header 'content-type: application/json' \ 
--header 'accept: application/vnd.whatcounts-v1+json' \ 
--data '{
"formatId": 1
}' \ 
--include

Response Body

The response returns all available Subscription data.  Based on the example above, the response returns:

HTTP/1.1 200 OK
Server: serverName
Content-Type: application/json
Content-Length: 926
Link: <https://mail.mydomain.com/rest/subscribers>;
Date: Fri, 17 Jun 2016 12:54:44 GMT
{
"subscriptionId": 120002
"subscriberId": 7160984
"listId": 5
"formatId": 1
"createdDate": "Jun 17, 2016 1:12:54 PM"
}

Error Response

Error Response Codes include both Client Errors (4xx) and Server Errors (5xx).  Descriptions of each can be found in Response Codes. 

For example, if a Subscription already exists for the Contact, the error would appear as:

{
"error": "Update failed: Unable to verify subscriber."
"status": "Not Found"
"statusCode": 404
}