Article
An article is a single entry in a blog.
Articles appear in reverse chronological order, with the most recent entry at the top of the blog's page. A blog can contain any number of articles.
What you can do with Article
The Haravan API lets you do the following with the Article resource. More detailed versions of these general actions may be available:
- GET /web/blogs/#{id}/articles.json?since_id=134645308Receive a list of all Articles
- GET /web/blogs/#{id}/articles/count.jsonReceive a count of all Articles
- GET /web/blogs/#{id}/articles/#{id}.jsonReceive a single Article
- POST /web/blogs/#{id}/articles.jsonCreate a new Article
- PUT /web/blogs/#{id}/articles/#{id}.jsonModify an existing Article
- GET /web/articles/authors.jsonGet a list of all the authors
- GET /web/blogs/#{id}/articles/tags.json?limit=1&popular=1Get a list of all the tags
- DELETE /web/blogs/#{id}/articles/#{id}.jsonRemove a Article from the database
Article properties
author |
The name of the author of this article |
blog_id |
A unique numeric identifier for the blog containing the article. |
body_html |
The text of the body of the article, complete with HTML markup. |
created_at |
The date and time when the article was created. The API returns this value in ISO 8601 format. |
id |
A unique numeric identifier for the article. |
handle |
A human-friendly unique string for an article automatically generated from its title. It is used in the article's URL. |
image |
The article image. |
metafields |
Attaches additional metadata to a store's resources:
|
published |
States whether or not the article is visible. Valid values are "true" for published or "false" for hidden. |
published_at |
The date and time when the article was published. The API returns this value in ISO 8601 format. |
summary_html |
The text of the summary of the article, complete with HTML markup. |
tags |
Tags are additional short descriptors formatted as a string of comma-separated values. For example, if an article has three tags: tag1, tag2, tag3. |
template_suffix |
States the name of the template an article is using if it is using an alternate template. If an article is using the default article.liquid template, the value returned is "null". |
title |
The title of the article. |
updated_at |
The date and time when the article was last updated. The API returns this value in ISO 8601 format. |
user_id |
A unique numeric identifier for the author of the article. |
Endpoints
limit | Amount of results (default: 50) (maximum: 250) |
page | Page to show (default: 1) |
since_id | Restrict results to after the specified ID |
created_at_min | Show articles created after date (format: 2014-04-25T16:15:47-04:00) |
created_at_max | Show articles created before date (format: 2014-04-25T16:15:47-04:00) |
updated_at_min | Show articles last updated after date (format: 2014-04-25T16:15:47-04:00) |
updated_at_max | Show articles last updated before date (format: 2014-04-25T16:15:47-04:00) |
published_at_min | Show articles published after date (format: 2014-04-25T16:15:47-04:00) |
published_at_max | Show articles published before date (format: 2014-04-25T16:15:47-04:00) |
published_status |
|
handle | Filter by article handle |
tag | Filter by artcle tag |
author | Filter by article author |
fields | comma-separated list of fields to include in the response |
Get all the articles after the specified ID
GET /web/blogs/#{id}/articles.json?since_id=134645308
Hide ResponseHTTP/1.1 200 OK { "articles": [ { "id": 294160202, "title": "Just us bots here", "created_at": "2013-11-06T19:00:00-05:00", "body_html": "beep boop", "blog_id": 241253187, "author": "dennis", "user_id": null, "published_at": null, "updated_at": "2017-07-24T19:09:43-04:00", "summary_html": null, "template_suffix": null, "handle": "just-us-bots-here", "tags": "" }, { "id": 989034056, "title": "Some crazy article I'm coming up with", "created_at": "2008-12-31T19:00:00-05:00", "body_html": "I have no idea what to write about, but it's going to rock!", "blog_id": 241253187, "author": "John", "user_id": null, "published_at": null, "updated_at": "2009-01-31T19:00:00-05:00", "summary_html": null, "template_suffix": null, "handle": "some-crazy-article-im-coming-up-with", "tags": "Mystery" }, { "id": 1051293780, "title": "Welcome to the world of tomorrow!", "created_at": "2013-11-06T19:00:00-05:00", "body_html": "Good news, everybody!", "blog_id": 241253187, "author": "dennis", "user_id": null, "published_at": null, "updated_at": "2017-07-24T19:09:43-04:00", "summary_html": null, "template_suffix": null, "handle": "welcome-to-the-world-of-tomorrow", "tags": "" } ] }
Get all the articles
GET /web/blogs/#{id}/articles.json
Hide ResponseHTTP/1.1 200 OK { "articles": [ { "id": 134645308, "title": "get on the train now", "created_at": "2008-07-31T20:00:00-04:00", "body_html": "<p>Do <em>you<\/em> have an <strong>IPod<\/strong> yet?<\/p>", "blog_id": 241253187, "author": "Dennis", "user_id": 799407056, "published_at": "2008-07-31T20:00:00-04:00", "updated_at": "2008-07-31T20:00:00-04:00", "summary_html": null, "template_suffix": null, "handle": "get-on-the-train-now", "tags": "Announcing", "image": { "created_at": "2017-07-24T19:09:43-04:00", "width": null, "height": null, "src": "https:\/\/file.hstatic.net\/s\/files\/1\/0006\/9093\/3842\/articles\/imac.jpg?v=1500937783" } }, { "id": 294160202, "title": "Just us bots here", "created_at": "2013-11-06T19:00:00-05:00", "body_html": "beep boop", "blog_id": 241253187, "author": "dennis", "user_id": null, "published_at": null, "updated_at": "2017-07-24T19:09:43-04:00", "summary_html": null, "template_suffix": null, "handle": "just-us-bots-here", "tags": "" }, { "id": 989034056, "title": "Some crazy article I'm coming up with", "created_at": "2008-12-31T19:00:00-05:00", "body_html": "I have no idea what to write about, but it's going to rock!", "blog_id": 241253187, "author": "John", "user_id": null, "published_at": null, "updated_at": "2009-01-31T19:00:00-05:00", "summary_html": null, "template_suffix": null, "handle": "some-crazy-article-im-coming-up-with", "tags": "Mystery" }, { "id": 1051293780, "title": "Welcome to the world of tomorrow!", "created_at": "2013-11-06T19:00:00-05:00", "body_html": "Good news, everybody!", "blog_id": 241253187, "author": "dennis", "user_id": null, "published_at": null, "updated_at": "2017-07-24T19:09:43-04:00", "summary_html": null, "template_suffix": null, "handle": "welcome-to-the-world-of-tomorrow", "tags": "" } ] }
created_at_min | Count articles created after date (format: 2014-04-25T16:15:47-04:00) |
created_at_max | Count articles created before date (format: 2014-04-25T16:15:47-04:00) |
updated_at_min | Count articles last updated after date (format: 2014-04-25T16:15:47-04:00) |
updated_at_max | Count articles last updated before date (format: 2014-04-25T16:15:47-04:00) |
published_at_min | Count articles published after date (format: 2014-04-25T16:15:47-04:00) |
published_at_max | Count articles published before date (format: 2014-04-25T16:15:47-04:00) |
published_status |
|
Count all a blog’s articles
GET /web/blogs/#{id}/articles/count.json
Hide ResponseHTTP/1.1 200 OK { "count": 4 }
fields | comma-separated list of fields to include in the response |
Get a single article
GET /web/blogs/#{id}/articles/#{id}.json
Hide ResponseHTTP/1.1 200 OK { "article": { "id": 134645308, "title": "get on the train now", "created_at": "2008-07-31T20:00:00-04:00", "body_html": "<p>Do <em>you<\/em> have an <strong>IPod<\/strong> yet?<\/p>", "blog_id": 241253187, "author": "Dennis", "user_id": 799407056, "published_at": "2008-07-31T20:00:00-04:00", "updated_at": "2008-07-31T20:00:00-04:00", "summary_html": null, "template_suffix": null, "handle": "get-on-the-train-now", "tags": "Announcing", "image": { "created_at": "2017-07-24T19:09:43-04:00", "width": null, "height": null, "src": "https:\/\/file.hstatic.net\/s\/files\/1\/0006\/9093\/3842\/articles\/imac.jpg?v=1500937783" } } }
Create a new article with an image which will be downloaded by Haravan
POST /web/blogs/#{id}/articles.json
{ "article": { "title": "My new Article title", "author": "John Smith", "tags": "This Post, Has Been Tagged", "body_html": "<h1>I like articles<\/h1>\n<p><strong>Yea<\/strong>, I like posting them through <span class=\"caps\">REST<\/span>.<\/p>", "published_at": "Thu Mar 24 15:45:47 UTC 2011", "image": { "src": "http:\/\/example.com\/rails_logo.gif" } } }Hide Response
HTTP/1.1 201 Created { "article": { "id": 1051293783, "title": "My new Article title", "created_at": "2017-07-24T19:16:23-04:00", "body_html": "<h1>I like articles<\/h1>\n<p><strong>Yea<\/strong>, I like posting them through <span class=\"caps\">REST<\/span>.<\/p>", "blog_id": 241253187, "author": "John Smith", "user_id": null, "published_at": "2011-03-24T11:45:47-04:00", "updated_at": "2017-07-24T19:16:23-04:00", "summary_html": null, "template_suffix": null, "handle": "my-new-article-title", "tags": "Has Been Tagged, This Post", "image": { "created_at": "2017-07-24T19:16:23-04:00", "width": 110, "height": 140, "src": "https:\/\/file.hstatic.net\/s\/files\/1\/0006\/9093\/3842\/articles\/rails_logo.gif?v=1500938183" } } }
Create a new article with html markup and upload it to a blog.
POST /web/blogs/#{id}/articles.json
{ "article": { "title": "My new Article title", "author": "John Smith", "tags": "This Post, Has Been Tagged", "body_html": "<h1>I like articles<\/h1>\n<p><strong>Yea<\/strong>, I like posting them through <span class=\"caps\">REST<\/span>.<\/p>", "published_at": "Thu Mar 24 15:45:47 UTC 2011" } }Hide Response
HTTP/1.1 201 Created { "article": { "id": 1051293785, "title": "My new Article title", "created_at": "2017-07-24T19:16:28-04:00", "body_html": "<h1>I like articles<\/h1>\n<p><strong>Yea<\/strong>, I like posting them through <span class=\"caps\">REST<\/span>.<\/p>", "blog_id": 241253187, "author": "John Smith", "user_id": null, "published_at": "2011-03-24T11:45:47-04:00", "updated_at": "2017-07-24T19:16:28-04:00", "summary_html": null, "template_suffix": null, "handle": "my-new-article-title", "tags": "Has Been Tagged, This Post" } }
Create an article with a metafield
POST /web/blogs/#{id}/articles.json
{ "article": { "title": "My new Article title", "author": "John Smith", "tags": "This Post, Has Been Tagged", "body_html": "<h1>I like articles<\/h1>\n<p><strong>Yea<\/strong>, I like posting them through <span class=\"caps\">REST<\/span>.<\/p>", "published_at": "Thu Mar 24 15:45:47 UTC 2011", "metafields": [ { "key": "new", "value": "newvalue", "value_type": "string", "namespace": "global" } ] } }Hide Response
HTTP/1.1 201 Created { "article": { "id": 1051293786, "title": "My new Article title", "created_at": "2017-07-24T19:16:29-04:00", "body_html": "<h1>I like articles<\/h1>\n<p><strong>Yea<\/strong>, I like posting them through <span class=\"caps\">REST<\/span>.<\/p>", "blog_id": 241253187, "author": "John Smith", "user_id": null, "published_at": "2011-03-24T11:45:47-04:00", "updated_at": "2017-07-24T19:16:29-04:00", "summary_html": null, "template_suffix": null, "handle": "my-new-article-title", "tags": "Has Been Tagged, This Post" } }
Create a new, but unpublished article for a blog
POST /web/blogs/#{id}/articles.json
{ "article": { "title": "My new Article title", "author": "John Smith", "tags": "This Post, Has Been Tagged", "body_html": "<h1>I like articles<\/h1>\n<p><strong>Yea<\/strong>, I like posting them through <span class=\"caps\">REST<\/span>.<\/p>", "published": false } }Hide Response
HTTP/1.1 201 Created { "article": { "id": 1051293788, "title": "My new Article title", "created_at": "2017-07-24T19:16:32-04:00", "body_html": "<h1>I like articles<\/h1>\n<p><strong>Yea<\/strong>, I like posting them through <span class=\"caps\">REST<\/span>.<\/p>", "blog_id": 241253187, "author": "John Smith", "user_id": null, "published_at": null, "updated_at": "2017-07-24T19:16:32-04:00", "summary_html": null, "template_suffix": null, "handle": "my-new-article-title", "tags": "Has Been Tagged, This Post" } }
Trying to create an article without a title will return an error
HTTP/1.1 422 Unprocessable Entity { "errors": { "title": [ "can't be blank" ] } }
Create a new article with a base64 encoded image
POST /web/blogs/#{id}/articles.json
{ "article": { "title": "My new Article title", "author": "John Smith", "tags": "This Post, Has Been Tagged", "body_html": "<h1>I like articles<\/h1>\n<p><strong>Yea<\/strong>, I like posting them through <span class=\"caps\">REST<\/span>.<\/p>", "published_at": "Thu Mar 24 15:45:47 UTC 2011", "image": { "attachment": "R0lGODlhAQABAIAAAAAAAAAAACH5BAEAAAAALAAAAAABAAEAAAICRAEAOw==\n" } } }Hide Response
HTTP/1.1 201 Created { "article": { "id": 1051293789, "title": "My new Article title", "created_at": "2017-07-24T19:16:33-04:00", "body_html": "<h1>I like articles<\/h1>\n<p><strong>Yea<\/strong>, I like posting them through <span class=\"caps\">REST<\/span>.<\/p>", "blog_id": 241253187, "author": "John Smith", "user_id": null, "published_at": "2011-03-24T11:45:47-04:00", "updated_at": "2017-07-24T19:16:33-04:00", "summary_html": null, "template_suffix": null, "handle": "my-new-article-title", "tags": "Has Been Tagged, This Post", "image": { "created_at": "2017-07-24T19:16:33-04:00", "width": 1, "height": 1, "src": "https:\/\/file.hstatic.net\/s\/files\/1\/0006\/9093\/3842\/articles\/df3e567d6f16d040326c7a0ea29a4f41.gif?v=1500938193" } } }
Update an existing article of a blog
PUT /web/blogs/#{id}/articles/#{id}.json
{ "article": { "id": 134645308, "title": "My new Title", "author": "Your name", "tags": "Tags, Will Be, Updated", "body_html": "<p>Look, I can even update through a web service.<\/p>", "published_at": "Thu Mar 24 15:45:47 UTC 2011" } }Hide Response
HTTP/1.1 200 OK { "article": { "id": 134645308, "title": "My new Title", "created_at": "2008-07-31T20:00:00-04:00", "body_html": "<p>Look, I can even update through a web service.<\/p>", "blog_id": 241253187, "author": "Your name", "user_id": null, "published_at": "2011-03-24T11:45:47-04:00", "updated_at": "2017-07-24T19:16:22-04:00", "summary_html": null, "template_suffix": null, "handle": "get-on-the-train-now", "tags": "Tags, Updated, Will Be", "image": { "created_at": "2017-07-24T19:09:43-04:00", "width": null, "height": null, "src": "https:\/\/file.hstatic.net\/s\/files\/1\/0006\/9093\/3842\/articles\/imac.jpg?v=1500937783" } } }
Add a metafield to an existing article
PUT /web/blogs/#{id}/articles/#{id}.json
{ "article": { "id": 134645308, "metafields": [ { "key": "new", "value": "newvalue", "value_type": "string", "namespace": "global" } ] } }Hide Response
HTTP/1.1 200 OK { "article": { "id": 134645308, "title": "get on the train now", "created_at": "2008-07-31T20:00:00-04:00", "body_html": "<p>Do <em>you<\/em> have an <strong>IPod<\/strong> yet?<\/p>", "blog_id": 241253187, "author": "Dennis", "user_id": 799407056, "published_at": "2008-07-31T20:00:00-04:00", "updated_at": "2017-07-24T19:16:24-04:00", "summary_html": null, "template_suffix": null, "handle": "get-on-the-train-now", "tags": "Announcing", "image": { "created_at": "2017-07-24T19:09:43-04:00", "width": null, "height": null, "src": "https:\/\/file.hstatic.net\/s\/files\/1\/0006\/9093\/3842\/articles\/imac.jpg?v=1500937783" } } }
Show a hidden article by changing the published attribute to true
PUT /web/blogs/#{id}/articles/#{id}.json
{ "article": { "id": 134645308, "published": true } }Hide Response
HTTP/1.1 200 OK { "article": { "id": 134645308, "title": "get on the train now", "created_at": "2008-07-31T20:00:00-04:00", "body_html": "<p>Do <em>you<\/em> have an <strong>IPod<\/strong> yet?<\/p>", "blog_id": 241253187, "author": "Dennis", "user_id": 799407056, "published_at": "2017-07-24T19:16:25-04:00", "updated_at": "2017-07-24T19:16:25-04:00", "summary_html": null, "template_suffix": null, "handle": "get-on-the-train-now", "tags": "Announcing", "image": { "created_at": "2017-07-24T19:09:43-04:00", "width": null, "height": null, "src": "https:\/\/file.hstatic.net\/s\/files\/1\/0006\/9093\/3842\/articles\/imac.jpg?v=1500937783" } } }
Update an article, setting a new image
PUT /web/blogs/#{id}/articles/#{id}.json
{ "article": { "id": 134645308, "title": "My new Title", "author": "Your name", "tags": "Tags, Will Be, Updated", "body_html": "<p>Look, I can even update through a web service.<\/p>", "published_at": "Thu Mar 24 15:45:47 UTC 2011", "image": { "attachment": "R0lGODlhbgCMAPf\/APbr48VySrxTO7IgKt2qmKQdJeK8lsFjROG5p\/nz7Zg3\nMNmnd7Q1MLNVS9GId71hSJMZIuzTu4UtKbeEeakhKMl8U8WYjfr18YQaIbAf\nKKwhKdKzqpQtLebFortOOejKrOjZ1Mt7aMNpVbAqLLV7bsNqR+3WwMqEWenN\nsZYxL\/Ddy\/Pm2e7ZxLlUQrIjNPXp3bU5MbhENbEtLtqhj5ZQTfHh0bMxL7Ip\nNsNyUYkZIrZJPcqGdYIUHb5aPKkeJnoUHd2yiJkiLKYiKLRFOsyJXKVDO8up\nosFaS+TBnK4kKti5sNaYg\/z49aqYl5kqLrljUtORfMOlo\/36+H4ZH8yDYq0f\nKKFYTaU9MrY8MrZBNXwXHpgaIdGVYu\/byLZNP9SaZLIyOuXCtHkpJst+Wpcm\nLMyCa8BfP9GMb9KQdPDd1PPk1sd5VP79\/L5dQZ0bI9+ymqssK9WcfIoXHdzG\nxdWWfteib79lSr1YP86MYurQxKdcUKdMQr5ZSfPs6YEZH8uhl4oWIenMuurQ\nttmejaqoqsqBVaAcJLlJN5kvMLlZRMNsSL5fRak0LbdQQMVvSPjw6cJnRpkf\nKtmjhvfu5cJtT7IuOMVvWLY\/M\/37+o0YH9ibhtSYdObErc6HarM9NnYSGNGR\navLi09unje3WyeO8rsVrT7tdRtK3uffu6NWeaL9pTJIjJrM4NPbx8cdyX7M7\nPYYVHu7j4KgoNJAYIKtkV5o9MsOcldicis+RYNutfrhFOZ0hJbqinZ8bI8h5\nUObFuOfItJsfJrJfUOfIqc+PXqQtK8RnSbA4Mcd3Tm0SGbpXQ8aqp7RLNs+s\novHfzpVhV9iggMd1TLtbRKUdKXEQFsd4XrZRPLIgMZUeJ+jKvrAlK6AhJ65A\nMpMpKuC3j5obIsRwS7hAN8l\/YtvDvnYXHbAoLI47SIUsOMenorF4gO\/m4+fH\npo4vLZ8oKMukqp0cJbhVSMV2UuPR0bAfMLIrLrg\/OcJwT8h+Vt+wn8eurLlh\nQrIfKHQOHHQOHf\/\/\/\/\/\/\/yH5BAEAAP8ALAAAAABuAIwAAAj\/AP8JHDhQXjpz\n\/PopXNiPn0OHDRMmbKhQIsOJFS1SxAhxI8SHFzVeDBnx48iNBAeeOkcxokeX\nFRdOnAlSokaaLXNujJkxo8iYHRkKtWkzZSsaOXkAWsoUECynsHgoqEW1qtVa\nU7Mq2Mq1K9cUW8GKTUG2rNkUHNByWMuWLdWva7t1W7UKG4S7eO\/ycEhQHgaK\nsL4VGGyocGE3br5929KuxQFFkEtIlgypsuUDmDMfWGRmUZvPoEHfGU36jgDT\nLQSoVt3IQ2sPsL0IUNZGlZ0H0lo00jEkCytWMspdGzBgn\/F9EBIWnKIQlqHB\nhA0bQpx48Z7UAkoEcMTdUeTJJSxf\/4akOTNnzqHb3GkjrUdp0gKwq77jWdod\nO7dNKWvhRUcWT6zYQI82xB03AAQNCdTKX\/xAAB10hfVCnRtbVIhIAy14oJoZ\nAXS4XXfdQaYIeOGJRx555Z1nRnrqqUeaMtIYY8dmn7Vg2yK57TYEgAzIQGBx\nxyXHj0A0OOTggxFKSN1iWwTTAIYanpYdMtFE4+GVIHrn3XeUmVhZeWiIMoOY\nnVQDGiTgKALJjIssIsADt0mjjI6+AXcDgQYi2M8\/7ijEwzRIFmBIL9NVV+EW\nVzyZ4Wqj9RBABchQWeWkV3aY5ZYjjgieeKL446mnjxwAiZVpliAjZqblt19\/\n\/7HCwIAFGv+X3J4s9fMckoYhphiTQTwJ5Wqn9dDDAWuMUUEFviTrS6STVlmp\npVmKqCkOn34aB6TIBAAOJeHZAYl6ptixSCL8edGbq8HFeqBDcygEyIOCGqYk\nkxUW4euiq7knbA\/gUDHGv\/\/ec2wFayQbaQWinOCslVhmSUq1\/gCDLJXacgtJ\nCYu4J66cjbAKoA3CxapnOgm9g+ughdK7xYX3Rinlvj2YYcYanVBBhTg2Axzw\nG4\/4k4bBzDZbKRUQP1LIsRSX6sgBZtwhzQP68ccbj7AWty4\/5igEoaC9dK3r\noVtgs4evvzKqb8wyQ0JFJzXXbDMVcQBQLTDGVmCssstKGs09oPT\/jQcRoBw9\nMamKgEOeeg\/gqBtvdVZSDnHFIQgRD4RxXWhiYEOQKNn4zncHzDIzHc0ZpHdy\nRicIQOypKDf7q3Pd96ABzSab+E1EIYIvS2o0ijA92gPZiCB1qwL+iJxL78Z7\n2NeHQrAK2YrCZva+bcgcujFUQIEG6WigonoCdLT9tr9UbIIAMMCEkkYacvvT\nxSgsBPKGJKBEAw4yjhx+hyn+PAJFfztyVdWOt5B3RehyimneFuwFvQxFyTSf\n25f1zCAqSFACDXTQ3gwSoDoElI5tZyBAINqnuhJ+Kg9vOIOaVnSHT5ECHucK\n0OMiBxJAPCdXmGseBLoBvei5rFEStB5m\/yBhjFJUIw50oIMoLvCpFRAADduj\nwxvUYMIqmvARCBiDeiwRBk+lQQTEq5qQ3CWdJSkGAlu4y9h66EBgAbF6QhSV\nMUpQilKcQRNLwIenfpFEJebBioC0ohrQQJ8QhMIfSwhgj2YouYTYUEmGqhBe\nFNBDH5otgmgLnRyLWMdq0GEGCMCHJjSBjzQE8pSChMLTCJBI4pXDBeuiiA1T\nprK7PK+SUPphsIQ1wSEag5OUKIUlyiAmAowClci0YizKILUAFi+WDQEEJOmF\nxlnMYnOVbOP0gkjBTdZRmDiwhCuywcRkmtOEpHjC1DzBABto4xqN5AcgdEXN\nNO4Ql0+CB2xctv9LM2SSgpXhZB0t0QlT+iMUkzinQquFihD452P0gGdGAPGN\nHKYxjbOAwBpxqU9+ApGXQgyoQDWRgASwoAMGMMAHDrnQhc5AkQPSU0NgYVF7\nQmAWKcBnPvc5HwGcbUVxJCInEfACQXQACUhFQkqRwAIOttScv9ABO21wA8k1\np5Z3mYXYdNqAjvLzbHDUpFCNIQoUdGAdHUhrUg2gVAOg4AXmvEAaOPEGaCCA\nAASQxBtIYYIq5kEHAaKHVfsRGB3eNBPYxKdXGVWGUnAzdOSxgyg+MIxhoDWt\nal3rUlXABEBeYBQIiMMm0AAKPBBAE1A4nTjWEIAzvGEFqsvDEHqEjZj\/wMKw\n1rwlVxerGkv4AxVoAOkEmXGMOKDgA8i1LFrRioSjKrWtKRVEQlXHBBSKQhLQ\nEG3tCHCLJaSWClD0zgHO8LBqDeIYNsDGTG4ryZtak4G7lZ6G2sBSfyCAaTK7\nAzfgQIEzoOC\/yKVsZS+bWeim1BsdqEG10oCANxDgDZwIRHa3O4hbaA91nlKB\nKA7QBhHo0VPwCFBtAdNea86CZVztKk8FUN5PjQIHxKWABihQBkHY+L\/HTa5l\nMetcAxvAG94wQAQAkA1SIIAUBvUHdkVLgBkMwrvkPSEkVtSCJ\/yCAJ5gZ20l\nwgObziITGk3xTqUHhWoxYQVdAIYINMBmO0TA\/8aCwHGOBbwOAvc4pXj2RieY\nIY69ttgfpJBEHOLQ5ArTAQ2SaPAb4lAC33XsoaxYhUx4kFVrZoKSYlYxbOzg\nPX8kAM1d6AILOuEDDQzBBCaIwJvhjOMAU7bOmE0qdMUhhFozQhVxiMWnuiAJ\nQTfZyahFQydWGwA1cbiZAJL0Qiht6UzoVsxetUQaJhEKZzhDBdh+A5s9AQxU\nq3rVN241ne0sa1rXWgjbqLUd3uqPUYhCFNDAxwzm3d3vjgF\/vTvAHegUaYbw\nwMSZyAR8oX0I2BwiC2eoQQ2srYJA6IDNb2ABqr39bVYDWMfkRgIVzs1xdEOD\nCjhQ4nXlPe9BaOLQNf+rRjQc0eg2DM8TyvZTs3mY6Xwy4xI2YLMGdIAAhTvD\nFWzuhKhZIHGKq9riF381rDtQho53\/Bjpboc1OiEJktMbtaplrbHboCOYT9rS\nOdhopocwgiRowOw6L0MNCKCBKjwA26IW9cRTXfE4i1vAlpUEHJze8XTXehvc\n2AQ05k3vDHaiDGNYeaPNoAzGxbwf\/86EHDCd4kbsyBMySII2NH92nevg4TbI\nA7ZVEGqiF93ocLb7nIdhgGMIoROW4Dvft2GHOqQiDoM3+YWJnT8O7yYL3fgI\nDwK+CrFX0lwBctUxtLH55qNd5xkYxMKvDffSn\/7b4L47JYQgjnW0XvZOv0L\/\nKmz\/BS5sIg5QvtkavDPlO\/Am+FzOBCBqgU8veEJA9LCBDRjQznIw3\/lJEIBs\n5gqhUIALN3rWR3QTh31IFwcUkAiV1QEOCH4ddw8LkAqpUH5cgAtnIGzikHgs\nxzSW1w3+Jgc0Bz32Rw8DoA3lQA8yIAP6xwoj4H\/\/B4BJYAOjoAZqYIDWRn0J\nuIB1Z3fHQAGdgHeJQIEcxwwLQH5csIHEQARE4C9aRx49oAPw5ydyIHaANUPE\nwXwtmH\/6Vw5iKIb\/F4DaoAGisAIroIM7WG0MR3pDd3qoJwjVQAEUAAdvEGAG\nsHcUgITFgAtLmIFNiAtQeAInMAa+UGwiyAEW8QMc\/\/AkgKUNx7EPkLOCLOiC\nNiADIzCDY0iDm2cHLxCKbNiGPueDcVh02McJ\/GWHjfABxyUJdigEfUiB+pAL\ndVAHX1B+uPCERHAChSAw8QAOHMaIE6EF3MAKkjiJxlGJljgC+UcPm7iJnch8\nDJAHoRiKaqiDBRgK01d9LDB0QFiHdmiH1YACSDCE4ziLsscIdRCIGriLhfiL\naxAPOKAKtbARPFAFQKKMywg5XuiC9ACN0TiNOwAAAHCNL5CN2siN3QiHcYhq\nwCAD6WiHomAJEzmO4LcGueCOG4gLf2OIAjOPOHCPEEFT\/KiMzKgNLigDABmN\nnKgL02aQB3mNCkmKB+iNCv+IBjI2Y+O4ihcZi063DcywkReYi04Yj\/ewBmuA\nAyRYEbAAAVVwkv3oj9rwgizJks4okCMwCI+ACqgwCQaJkGq4hm3IjW8YakPn\nCWxmhzz5kxfJd3iwkUx4lL0ojw\/QlAnxlG4glQYCOStplS8YkJuoCwnwCIY5\nCYgZljRJlqTYg9WnbTq3lm3plrGojrVWixuJgRpIDB95AgLTCCRYkjeVAXw5\nlfqXiVa5ks64QSVlmF8JljO5mAtplj4IdJE5YzpHmenYcXCwAHKJi7rIi74Y\nD7oQms1xU71QmpQ4AOVwmvoHmAH5ABcwna3pmompmAnJmDzIcGp5m2upmxMp\ni+f\/Zg9AIJeCeJSG+ACHAH8OwWyzoJyUCIOnCYOAKQP4wATTeQElVZio8AiI\nCZtiSZbbuHAIUAXemZu5CZ4YyQ250KAXeJ6c2YsCYIUYwWyZUADK6QoEwAfO\nOZ8yoANSwAT4SZ37eZjXGZtjOZshoAFQ8HAHOo6TCZ5CgAfluYS4OIhPGA8C\n4AXBtxBP+WXvWZrZ4ClhYAkdmokzgAkhKqIjqp+GaaIyGaAL+XDOEAEueqC4\nGaNuKQTWAAQ1OpceCQktcAgcYFuHJQc+wJfhADFpsAPhcJpewAZKKgVL2qTV\n2ZUnKptqMApJ8ADVZqVYKpkKaodwEAflaYvAuYFE4HIe\/8CIEWGhchCkJ7kE\nJQQAHGoDZcYGckqnTGqnhWmiALqYS5AEdGCAVmqgBvqiMqagquANX3qe8cCo\njpqX1iQHsAALaWogx5FkEBMO7URCmjqnTJqfJQql2LkClpAEwNCGahABapmq\nqqqgjAAE3uCgTFgC6tEIZVoRzCYHckBpJ+kBJoQA+xcCqrOpdeqpT\/qf2JkF\nSQAPOdiGLoqq0QqeVOCqDUp+RMBh+7atDgELX+atPJCPKOkAJmQJ7fRH54oJ\nc7qk+amfn+qfsAkAKqB5SeAFo7CGwBCo3smWlMkMQPaqyAAJi2AaKTBpECB5\nUdFlKJk6qoMK\/McHVsSwdFqnxP9aUv3JrgRghhcbCCswqp0XmdAamTtJmXHg\nqjWaCmqCIwJwsg\/RrSvLA6R5HDIAAyJAAJ3mKQQAAwxwC4Akp8Iqog9bna+5\nA2V4g+kUgM\/HZlUwtB2rparwYzWKB\/nzAG3QtBVaq1HxA5+wl8cBA1iABTCg\nCyGgsK7Af1lrReiariTKn6ggAmTIfDfIAJuntt7pth2bjnAABHKbC74ADi13\nByfLrQG7sp\/AA8dBD4EruIILAy0ABboAA66ATMHKqcMKsZ\/aCNMouWrbu2vb\nthw7kdUgt3VgP41WsinwEPzwb7NgqzzwA3xrCMYBuKu7ujBwvTBAAOYEtrbr\nqQkwg5z\/GLmVa7GWy7EJmo7ccGB4gAxp8i3SMLoNEXnOywOf8AmwsA\/aUL3V\ni726QELJtLi3W1ICWQ7SGLm+67tCi6UeSwGb8GOFkC1L+74uAbAq+7z1Sw0F\nwACXcAmBy8H6O7sLxb22O52k4IwD2Yk0SL69a763KWOJgAQLACnFBgl267Qy\nV8H0+wnUgAEb3MMbrL\/a+1SaWrNMSgpYqZUEPIY1qMICyMJtCQSB4wv2czjw\nC3mla8E6nAzcEA4+jAU\/HLiJG8IAbMRW6ZLgq8S8e8BOPGM4cDtSDLqboQD4\neMV8m8VXkAV47MMeDMJP9SmLiw82oAOpicThm8IHXL6BSgEn\/4AHhbAsaRLH\nMSG\/e3vBjojHWRADeowFg9DHEMO9DmADDjAK1ZCaLknAhZzGaoyl3IALXHAC\nMry0cjwR8juwz0sN1OBs3HDJlpwFl8DLvMrJnqKpUADKIUoKD1DGpVzAZ3vI\nWKoIxNDKr0yysRy\/dKzDP3BTChADunzJlxAOygDMJkQANlAGmMCk+CDI0KiV\nBYzGh9zEOmcDRPCEjEwlI3IACtARkmzB1JBRs9AN3KDN2mzJZQDOJRQGNmAH\nDSuiyhCYL2jGKIzKCMxmdwCFRMDIb9xo07y8V1y\/14wXVxADIA3QWRDEBF0t\nBi0CAOwKgDkCmmjGpzy+anwPvbjIJ\/\/gyBitvLNswRmVVewQ0iL9yyVt0PVA\nAIsLBfVJytK4zuXQzknADIZoiIVABNEsx8vWvN\/6vJRmU6vw0T4tsyWtOvxn\nA+EABQCgpID8gqh5lQ6dxGR4yIrgi78o01MdyVY9sJ+QCd+ARlmVzT490F8N\nMTEQ1gwQDiGwPh260i2dzJ3Yu8eAO\/fw2BVwD408w7UAEv9mqyubQBe1Q\/98\nCCA9A38NMSLAf4JtAyFw2Gnd0Il9wmKotm0Q10o5j41svFQtc\/M7CwmU1\/ZU\nC559CLrwC6FdLSFA2sR9pB5anw4dvlUZDyE5j\/SINKBb2RRx2ZldHUxyFxwQ\nA70d3NUCBa7\/QtyljdrIvdZj6AFKGQ\/oTY84YA8PnCb3ON11PQv0dN0QgA1X\noAuH4Fvc7SkIwABcC97hfdiIvdrgSwnOrd72QAkGDsHSnRDD57wS0g4NcAVb\ncN1bkAKHcAh+vd95cL3+DeABPp+pjcybeAnojQMobg8JTgmqQAlSrAjSHb8q\nOwvT0QDocOMTQAJ6UARk4M+HANr77SnY6+Egrn\/tdKTjHY2LkOIqruCq8OR2\n8MYk6ScqSyiGQAI3fuNRsOVRMAEKcAjAHeT+cARD\/t8g3k5HLuJHLQMMYA\/r\nreAsbhv48QCUYD8NDnmSR+MF0At\/YARGoOXoEAW8QAscMARhHNwh\/1DmHm7m\nxZ3mxw2Y1rDicY4ft\/EAlp4tlS3LkndD3ODnfp7lW14EW7AHYu4pg9C6Zc5\/\njE7a+4fkad3iTy7nlW4KtC4N9hAAU47nR1IAwtAMno4Of77labQHrVDqYWC9\nis61qx7i83kIsU7plk7rppAI1G4K0UCSDp4JbgAdJNAMvv7pOL4YViAPpe4P\n+pvsy87qrT6ftQHtiUPr1K4M+9EC9nDnlOYDg+EDf+Dt3\/7n6EALi0EL+VDu\nD4DsqI69ql7kjo4F7r4IpiAN8T7vjdAIdmDv74DvPsAN\/O7tv14EiUECUQAC\npV4G+ovsqf7hAH6a1jDr8E7tLaAbE+8FMv\/\/3n6S79MwBDuw7xzv6e2gGBMQ\nBadQ6gSABQ5AAA4gAodg8kOe8GduCu8O8S7\/8jHfH5\/HDiWRDH6QA9hwK4PB\nDfbyBLRAAtPxDbaw5X0g5mlwCXzsMwgABUdw8Aif7ocg7fEu9VP\/eUPwCmDw\nAzPxA+TgBxgQ+BBgMpUjKNQR6FEwB6WuDJdw6AAQuMnO9KQNI3UP8x0DQHoP\nBmBABnuxEH4f+KAP+LitPNNRDFq+DCN\/CSQt3Psb+fyXBZU\/8ZevA5mv+Zqf\nAz\/AED+gBeQA+r4f+DkAAShTBKAu8kFOAOFQDQV97oqu6o0g8TFP+7Vv+5Ug\nC9+q+1PQ+7\/\/+1n\/DwFF4O\/osAFiDgB4DNT+UPDWC\/lljgV23zF5b\/vwXwny\njw3f+hE\/kP1TsP36\/wxNABBNeEVBp87fQYQJFS5k2NBOjGoEwvxKSOASFowZ\nscDgyHFIo0ZehrwCU9JkyUopK8nKlIkHP379+P2YMoUcBpw5deZ8RohQE6Cn\nGg4lOnRGDKRZsoS7pMPSA6YXNWLsKJLkSZOVwKhMGSTTrJf9ZNKcomXKTrQY\nevr02cSIvKJxi6aJkaVuXaZMs1ziO5UqPawnuXK9AWEW2Jhja9pMuzMd27YW\nLNga10fuZYUPkdZdqpTv575YbJQbkCHw1sEpb9wQMstwWLFkbfppjJPc\/wTI\nhHhJ5r0BBGbMRzfb7ez5MwwbpTMsx5pa9eob2CBM5yETpmzGtTE8hrybN29b\nc1oBn6trc9K7nhmUy6BcOUrn0KHLcr0FQvWYMxdnb3w7t\/fvwFMiFvKG0uw8\n4kRLYjkGG0RtMPlWc+GGdyCwbwtYrOsHu7K0a+K\/AEO04K0CF8InBvPOg2GE\nKpZTrsHSUotwwgnnmW4LHGGBKbb9bMqhsSly082CW0QMkDLLSvQHFQFiOESX\nLGzQpkUY22swA8Lko9EFLqfBEcdvMhRrwx610OLHtJ5Rc01ahHnCzTeFkXNO\nOfWQkwQ6NNFzTz2X0GQJQAMVdJEYsBhBAyrbK\/9tgBcbrCTCG7bkkstvvvwm\nzPzI7JEcNLXDCYICQhXVkAIMMdWQd0x1Y9VdiuHGA1hjhfWQQzyg9dZDYmBg\nyioSVfRKFwfYZ8ZIJ3XhGhe83OLSSwEZU78ea+pUO2wK8MFaUUMl9dReDOll\n1VXbuYIZWWOl1dZDLpGhV3YZXLTR9vZhUMJijUX2mmveYRZcQDLlsCZOp21s\nCx+uLTjbbE\/11ttv3diFkSHKRReGcthtN1hgrdxH2Awk5fJefK+ZZ9lvVvXW\n2cT+ZSwHgdHCpmCYDb4WYVNL7baXbsN9FdYYbKDA4otddBdYeffZx9iPjw35\nmmlKNtnUfmXSNNqAW9b\/6eWYY8YWYW0V7tYQhxWAwwege61y6OXkbdDoSUFe\nWuR3wP3akKhjUtlHlqklG+YqsjaY620VNgQDMcQQouwrX3zR6KKFZfttyKtw\n+utQnRUL2mjLYjnvtLDpu9e9\/ZYZ8FK3maLwwn8OmlF3lWNc7df3gfzteaZZ\n+NTKx5y6RxJ69\/333mvBwHOLQ\/fhiR2SV34HS47hmnAafJ9gh3AaDMcB7LE\/\nIoPY441dhOzDz94VN3DPNmoeM5drAyfK7lWH34baYetVCidBIT6C5UMhB4r2\nn3FheSANRVGCwhBmObtlbgqXyYYNyuYFAMQFCtPwQf3spxAraGBRR+Af91wX\n\/zsPoCIuCCAV13yAMsWo7zIOaJHFSHEZHZABdWK4X0JoIAENLIeDCXFA2rgX\nuwG8MC6kKGGoZuaDTEhtd\/vBTBoyYLYqeAEzFpihGCagEBqIQQJVGMAOEdLD\n2L0uHJdBAMIOhsTELHExwLnS\/i6zAQlIQItWxKIccejGL\/4wjPvw4kHSQApA\nBhKQUDCiEWE2C93dTSEW2EMjaWABhbgnA3g8SAj4cElK+kMJWoyjBK6YECtw\nUgKZ7N8ejdZHfzjgGgNY5SpnZsisJXFHikwICTLBskzUECFtxJ\/FFKKETmrx\nkwixQiclYAX+mfKUCpnBEZzpzHpkS2Yxm0ViMNcjhf+QABs5uKUuD9KoTOaP\nQb80picxaExk8lCZfIxLNuBhrWnurZpjoiVCbAkBbnrTH2pbTjgZVAVyGnOY\nBylmJ9P5xXWOUS6WEB3ZqgmTazLxMk40WntQub3lbIOc7OjkQP1RUI4e9CCl\nfJ3jjCbEogDAE6KrAiKlVs+4gJF7GUDlDLLnUWCyg6Ps8GgxdyrSVK5zH\/WI\noARjZjFEQhSmRCEFg9SGSqIoQadT7alOJcAOoJJUmeFA6VBIETqk+ssPKizK\nDorxwx9CdShSvapOqzpVoO7ApMocgAdcIb74HeSroEOqEn8w1mgVRR0KyEEw\nKqoctTZEquzggFsVooepskP\/DwqZAAfmakpGvc4HXSXF54CWVLthALASRYhB\nFpmDd4QxsQxRQmNd61HITnWyCVHC9MTnCsY9U7dH4AM8spGQvVrsiRB4Fg\/8\ncFxsJmQDHvUHLQyhWsy01rXs2MFj2ZGC6862KKRgHGY6K9zlEPdyP8AJcteo\n3ClsQCHq0AF0QdkN+HbjlxygL31hO13tMrW7lwkB0BiUoR3x4EfmrYlCNjAF\nCRAoIWmwQexQqQcyxHe+9eXAfVOQAg7k16v7jQsAHGi2Bv0gUzyQQ05Ga+Cy\n0MBEDsZgN8gQ4QnXt7oJ0QOGOZACDTeEu0aTCwC80EKhDcAHMDGHWATMsuMC\nFsVl\/9GnP0Jg0kw24MUv\/qUTOGDlCj8WETfGsVx2vI+UzsATIFZUaTIRk3QY\n+ZYlFq0Ce5QJHBXgdU+MRCSwEYlVBCHPQZhyn7vhhD9fWdAc2DKhKXxhRCc6\n0Yi4LOPcl6hGVUFqc4gJLGaxufKO1s2VkrOj63znOkciCKMedZ+n7ARUp1rQ\niLAyIlyNYURcONaInrWs9ci4JyJOaFYawDzP8Q+ZwAICLckbgd08i290eh9V\nCIadQw3qO5Oa1H1GNRlSjeorO2HLruZ2rLudAm+Dm9Gxcx\/GXmSIMbnjH5W2\nzy2RbOzM+cENBRAWs0N9b3zXWdp8pra1r61tbXdb4N\/2Nv8i5gzeIJd5Gjui\nwT+AzQ9YVGrYnNO0Agm27GBkvNnNzje+921qf\/+b1QEfuMDFPe5lk\/lspUG3\nWKbQCofLBBBuwNEs3C3aikcrB2TTeM81HgmOd3zf\/PZ3yFPNaqSXfODF0EDK\nE9e6liZmCvJwOLD7AQhU2efSbG6zm7VgiG1ofBc+\/\/nGgZ7vbYw67aVux4v\/\nfXSSK53by\/HVrzIwDZTBBANUrzpMeAAIWASeB4P\/AQ9+cHjEJx7xWgDE5nLQ\neMdHXvKbg\/zkMZ23H\/1oFRjYPOc9v3nQ58Aw0xn9LACvO7HQAOZVf\/jl0ii1\nHcXe9bPX3euftaPL5R71tIf97nsy7\/o0WlP2r4\/JOU7B+r5nqva7jz1EdZ97\n4qNe+bonfvCfVXvly1762beOOdLBd+Q7PCAAOw==\n" } } }Hide Response
HTTP/1.1 200 OK { "article": { "id": 134645308, "title": "My new Title", "created_at": "2008-07-31T20:00:00-04:00", "body_html": "<p>Look, I can even update through a web service.<\/p>", "blog_id": 241253187, "author": "Your name", "user_id": null, "published_at": "2011-03-24T11:45:47-04:00", "updated_at": "2017-07-24T19:16:27-04:00", "summary_html": null, "template_suffix": null, "handle": "get-on-the-train-now", "tags": "Tags, Updated, Will Be", "image": { "created_at": "2017-07-24T19:16:27-04:00", "width": 110, "height": 140, "src": "https:\/\/file.hstatic.net\/s\/files\/1\/0006\/9093\/3842\/articles\/fd43f2c8883f6e9b680e3295fd990d2c.gif?v=1500938187" } } }
Update a article, clearing the article image
PUT /web/blogs/#{id}/articles/#{id}.json
{ "article": { "id": 134645308, "title": "My new Title", "author": "Your name", "tags": "Tags, Updated, Will Be", "body_html": "<p>Look, I can even update through a web service.<\/p>", "published_at": "2011-03-24T11:45:47-04:00", "image": "", "created_at": "2008-07-31T20:00:00-04:00", "user_id": null, "updated_at": "2017-07-24T19:16:31-04:00", "summary_html": null, "template_suffix": null, "handle": "get-on-the-train-now" } }Hide Response
HTTP/1.1 200 OK { "article": { "id": 134645308, "title": "My new Title", "created_at": "2008-07-31T20:00:00-04:00", "body_html": "<p>Look, I can even update through a web service.<\/p>", "blog_id": 241253187, "author": "Your name", "user_id": null, "published_at": "2011-03-24T11:45:47-04:00", "updated_at": "2017-07-24T19:16:32-04:00", "summary_html": null, "template_suffix": null, "handle": "get-on-the-train-now", "tags": "Tags, Updated, Will Be" } }
Hide a published article by changing the published attribute to false
PUT /web/blogs/#{id}/articles/#{id}.json
{ "article": { "id": 134645308, "published": false } }Hide Response
HTTP/1.1 200 OK { "article": { "id": 134645308, "title": "get on the train now", "created_at": "2008-07-31T20:00:00-04:00", "body_html": "<p>Do <em>you<\/em> have an <strong>IPod<\/strong> yet?<\/p>", "blog_id": 241253187, "author": "Dennis", "user_id": 799407056, "published_at": null, "updated_at": "2017-07-24T19:16:32-04:00", "summary_html": null, "template_suffix": null, "handle": "get-on-the-train-now", "tags": "Announcing", "image": { "created_at": "2017-07-24T19:09:43-04:00", "width": null, "height": null, "src": "https:\/\/file.hstatic.net\/s\/files\/1\/0006\/9093\/3842\/articles\/imac.jpg?v=1500937783" } } }
Remove an existing article from a blog
DELETE /web/blogs/#{id}/articles/#{id}.json
Hide ResponseHTTP/1.1 200 OK {}