Article

An article is a single entry in a blog.

Article

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 can you do with Article?

The Shopify API lets you do the following with the Article resource. More detailed versions of these general actions may be available:

Article Properties

author
{ "author" : "John" }

The name of the author of this article

blog_id
{ "blog_id" : 241253187 }

A unique numeric identifier for the blog containing the article.

body_html
{ "body_html" : "I have no idea what to write about!" }

The text of the body of the article, complete with HTML markup.

created_at
{ "created_at" : "2008-12-31T19:00:00-05:00" }

The date and time when the article was created. The API returns this value in ISO 8601 format.

id
{ "id" : 989034056 }

A unique numeric identifier for the article.

handle
{ "handle" : "hello-world" }

A human-friendly unique string for an article automatically generated from its title. It is used in the article's URL.

image
{ "image" : {"src"=>"https://cdn.myshopify.io/s/files/1/0000/0001/articles/Red_Cotton.jpg?v=1443721435", "created_at"=>"2008-12-31T19:00:00-05:00"} }

The article image.

metafield
{ "key" : "new" }
{ "value" : "new" }
{ "value_type" : "new" }
{ "namespace" : "new" }

Attaches additional metadata to a store's resources:

  • key (required): Identifier for the metafield (maximum of 30 characters).
  • namespace (required): Container for a set of metadata. Namespaces help distinguish between metadata you created and metadata created by another individual with a similar namespace (maximum of 20 characters).
  • value (required): Information to be stored as metadata.
  • value_type (required): States whether the information in the value is stored as a 'string' or 'integer.'
  • description (optional): Additional information about the metafield.

published
{ "published" : false }

States whether or not the article is visible. Valid values are "true" for published or "false" for hidden.

published_at
{ "published_at" : "2008-07-31T20:00:00-04:00" }

The date and time when the article was published. The API returns this value in ISO 8601 format.

summary_html
{ "summary_html" : null }

The text of the summary of the article, complete with HTML markup.

tags
{ "tags" : "tagsational" }

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
{ "template_suffix" : null }

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
{ "title" : "Some crazy article I'm coming up with" }

The title of the article.

updated_at
{ "updated_at" : "2009-01-31T19:00:00-05:00" }

The date and time when the article was last updated. The API returns this value in ISO 8601 format.

user_id
{ "user_id" : 799407056 }

A unique numeric identifier for the author of the article.

Endpoints

GET/admin/blogs/241253187/articles.json

Get a list of all articles from a certain blog

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
  • published - Show only published articles
  • unpublished - Show only unpublished articles
  • any - Show all articles (default)
fields

comma-separated list of fields to include in the response

Get all the articles after the specified ID

GET /admin/blogs/#{id}/articles.json?since_id=134645308
View Response
HTTP/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": "2016-08-03T16:25:13-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": "2016-08-03T16:25:13-04:00",
      "summary_html": null,
      "template_suffix": null,
      "handle": "welcome-to-the-world-of-tomorrow",
      "tags": ""
    }
  ]
}

Get all the articles

GET /admin/blogs/#{id}/articles.json
View Response
HTTP/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": "2016-08-03T16:25:13-04:00",
        "src": "https:\/\/cdn.shopify.com\/s\/files\/1\/0006\/9093\/3842\/articles\/imac.jpg?v=1470255913"
      }
    },
    {
      "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": "2016-08-03T16:25:13-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": "2016-08-03T16:25:13-04:00",
      "summary_html": null,
      "template_suffix": null,
      "handle": "welcome-to-the-world-of-tomorrow",
      "tags": ""
    }
  ]
}
GET/admin/blogs/241253187/articles/count.json

Get a count of all articles from a certain blog

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
  • published - Count only published articles
  • unpublished - Count only unpublished articles
  • any - Count all articles (default)

Count all a blog’s articles

GET /admin/blogs/#{id}/articles/count.json
View Response
HTTP/1.1 200 OK
{
  "count": 4
}
GET/admin/blogs/241253187/articles/134645308.json

Get a single article by its ID and the ID of the parent blog

fields

comma-separated list of fields to include in the response

Get a single article

GET /admin/blogs/#{id}/articles/#{id}.json
View 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": "2008-07-31T20:00:00-04:00",
    "summary_html": null,
    "template_suffix": null,
    "handle": "get-on-the-train-now",
    "tags": "Announcing",
    "image": {
      "created_at": "2016-08-03T16:25:13-04:00",
      "src": "https:\/\/cdn.shopify.com\/s\/files\/1\/0006\/9093\/3842\/articles\/imac.jpg?v=1470255913"
    }
  }
}
POST/admin/blogs/241253187/articles.json

Create a new article for a blog

Create a new article with a base64 encoded image

POST /admin/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"
    }
  }
}
View Response
HTTP/1.1 201 Created
{
  "article": {
    "id": 1051293781,
    "title": "My new Article title",
    "created_at": "2016-08-03T16:25:25-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": "2016-08-03T16:25:25-04:00",
    "summary_html": null,
    "template_suffix": null,
    "handle": "my-new-article-title",
    "tags": "Has Been Tagged, This Post",
    "image": {
      "created_at": "2016-08-03T16:25:25-04:00",
      "src": "https:\/\/cdn.shopify.com\/s\/files\/1\/0006\/9093\/3842\/articles\/df3e567d6f16d040326c7a0ea29a4f41.gif?v=1470255925"
    }
  }
}

Create a new article with html markup and upload it to a blog.

POST /admin/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"
  }
}
View Response
HTTP/1.1 201 Created
{
  "article": {
    "id": 1051293782,
    "title": "My new Article title",
    "created_at": "2016-08-03T16:25:26-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": "2016-08-03T16:25:26-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 /admin/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"
      }
    ]
  }
}
View Response
HTTP/1.1 201 Created
{
  "article": {
    "id": 1051293783,
    "title": "My new Article title",
    "created_at": "2016-08-03T16:25:27-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": "2016-08-03T16:25:27-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

POST /admin/blogs/#{id}/articles.json
{
  "article": {
    "body": "something"
  }
}
View Response
HTTP/1.1 422 Unprocessable Entity
{
  "errors": {
    "title": [
      "can't be blank"
    ]
  }
}

Create a new, but unpublished article for a blog

POST /admin/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
  }
}
View Response
HTTP/1.1 201 Created
{
  "article": {
    "id": 1051293785,
    "title": "My new Article title",
    "created_at": "2016-08-03T16:25: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": null,
    "updated_at": "2016-08-03T16:25:29-04:00",
    "summary_html": null,
    "template_suffix": null,
    "handle": "my-new-article-title",
    "tags": "Has Been Tagged, This Post"
  }
}

Create a new article with an image which will be downloaded by Shopify

POST /admin/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"
    }
  }
}
View Response
HTTP/1.1 201 Created
{
  "article": {
    "id": 1051293787,
    "title": "My new Article title",
    "created_at": "2016-08-03T16:25: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": "2011-03-24T11:45:47-04:00",
    "updated_at": "2016-08-03T16:25:32-04:00",
    "summary_html": null,
    "template_suffix": null,
    "handle": "my-new-article-title",
    "tags": "Has Been Tagged, This Post",
    "image": {
      "created_at": "2016-08-03T16:25:32-04:00",
      "src": "https:\/\/cdn.shopify.com\/s\/files\/1\/0006\/9093\/3842\/articles\/rails_logo.gif?v=1470255932"
    }
  }
}
PUT/admin/blogs/241253187/articles/134645308.json

Update an article

Update an article, setting a new image

PUT /admin/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"
    }
  }
}
View 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": "2016-08-03T16:25:25-04:00",
    "summary_html": null,
    "template_suffix": null,
    "handle": "get-on-the-train-now",
    "tags": "Tags, Updated, Will Be",
    "image": {
      "created_at": "2016-08-03T16:25:25-04:00",
      "src": "https:\/\/cdn.shopify.com\/s\/files\/1\/0006\/9093\/3842\/articles\/fd43f2c8883f6e9b680e3295fd990d2c.gif?v=1470255925"
    }
  }
}

Update a article, clearing the article image

PUT /admin/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": "2016-08-03T16:25:27-04:00",
    "summary_html": null,
    "template_suffix": null,
    "handle": "get-on-the-train-now"
  }
}
View 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": "2016-08-03T16:25:27-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 /admin/blogs/#{id}/articles/#{id}.json
{
  "article": {
    "id": 134645308,
    "published": false
  }
}
View 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": "2016-08-03T16:25:28-04:00",
    "summary_html": null,
    "template_suffix": null,
    "handle": "get-on-the-train-now",
    "tags": "Announcing",
    "image": {
      "created_at": "2016-08-03T16:25:13-04:00",
      "src": "https:\/\/cdn.shopify.com\/s\/files\/1\/0006\/9093\/3842\/articles\/imac.jpg?v=1470255913"
    }
  }
}

Update an existing article of a blog

PUT /admin/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"
  }
}
View 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": "2016-08-03T16:25:29-04:00",
    "summary_html": null,
    "template_suffix": null,
    "handle": "get-on-the-train-now",
    "tags": "Tags, Updated, Will Be",
    "image": {
      "created_at": "2016-08-03T16:25:13-04:00",
      "src": "https:\/\/cdn.shopify.com\/s\/files\/1\/0006\/9093\/3842\/articles\/imac.jpg?v=1470255913"
    }
  }
}

Add a metafield to an existing article

PUT /admin/blogs/#{id}/articles/#{id}.json
{
  "article": {
    "id": 134645308,
    "metafields": [
      {
        "key": "new",
        "value": "newvalue",
        "value_type": "string",
        "namespace": "global"
      }
    ]
  }
}
View 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": "2016-08-03T16:25:30-04:00",
    "summary_html": null,
    "template_suffix": null,
    "handle": "get-on-the-train-now",
    "tags": "Announcing",
    "image": {
      "created_at": "2016-08-03T16:25:13-04:00",
      "src": "https:\/\/cdn.shopify.com\/s\/files\/1\/0006\/9093\/3842\/articles\/imac.jpg?v=1470255913"
    }
  }
}

Show a hidden article by changing the published attribute to true

PUT /admin/blogs/#{id}/articles/#{id}.json
{
  "article": {
    "id": 134645308,
    "published": true
  }
}
View 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": "2016-08-03T16:25:32-04:00",
    "updated_at": "2016-08-03T16:25:32-04:00",
    "summary_html": null,
    "template_suffix": null,
    "handle": "get-on-the-train-now",
    "tags": "Announcing",
    "image": {
      "created_at": "2016-08-03T16:25:13-04:00",
      "src": "https:\/\/cdn.shopify.com\/s\/files\/1\/0006\/9093\/3842\/articles\/imac.jpg?v=1470255913"
    }
  }
}
GET/admin/articles/authors.json

Get a list of all the authors of articles

Get a list of all authors of articles

GET /admin/articles/authors.json
View Response
HTTP/1.1 200 OK
{
  "authors": [
    "dennis",
    "John",
    "Rob",
    "Dennis"
  ]
}
GET/admin/blogs/241253187/articles/tags.json

Get a list of all the tags of articles

popular

A flag to indicate only to a certain number of the most popular tags

limit

The number of tags to return

Get a list of the most popular tags from a specific blog

GET /admin/blogs/#{id}/articles/tags.json?limit=1&popular=1
View Response
HTTP/1.1 200 OK
{
  "tags": [
    "Announcing"
  ]
}

Get a list of all tags from a specific blog

GET /admin/blogs/#{id}/articles/tags.json
View Response
HTTP/1.1 200 OK
{
  "tags": [
    "Announcing",
    "Mystery"
  ]
}

Get a list of the most popular tags

GET /admin/articles/tags.json?limit=1&popular=1
View Response
HTTP/1.1 200 OK
{
  "tags": [
    "Announcing"
  ]
}

Get a list of all tags of articles

GET /admin/articles/tags.json
View Response
HTTP/1.1 200 OK
{
  "tags": [
    "Announcing",
    "Mystery"
  ]
}
DELETE/admin/blogs/241253187/articles/134645308.json

Delete an article of a blog

Remove an existing article from a blog

DELETE /admin/blogs/#{id}/articles/#{id}.json
View Response
HTTP/1.1 200 OK
{}