Welcome to my new blog!
", "created_at": "2008-12-31T19:00:00-05:00", "id": 989034056, "handle": "hello-world", "image": { "src": "https://cdn.shopify.com/s/files/1/0000/0001/articles/Red_Cotton.jpg?v=1443721435", "created_at": "2008-12-31T19:00:00-05:00" }, "metafields": { "key": "new", "value": "new value", "type": "single_line_text_field", "namespace": "global" }, "published": false, "published_at": "2008-07-31T20:00:00-04:00", "summary_html": "My first blog post!
", "tags": "tagsational", "template_suffix": null, "title": "Hello world!", "updated_at": "2009-01-31T19:00:00-05:00", "user_id": 799407056 } ``` *** ## postCreates an article for a blog [articleCreate](https://shopify.dev/docs/api/admin-graphql/latest/mutations/articleCreate?example=creates-an-article-for-a-blog) ### Parameters *** api\_version **string** **required** *** blog\_id **string** **required** *** ### Examples ### Create an article with HTML markup for a blog ### Path parameters blog\_id=241253187 **string** **required** ### Request body article **Article resource** article.title:"My new Article title" ->[title](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleCreateInput#fields-title) The title of the article. article.author:"John Smith" ->[author](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleCreateInput#fields-author) The name of the author of the article. article.tags:"This Post,Has Been Tagged" ->[tags](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleCreateInput#fields-tags) A comma-separated list of tags. Tags are additional short descriptors formatted as a string of comma-separated values. article.body\_html:"\\Yea\,I like posting them through \REST\.\
" ->[body](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleCreateInput#fields-body) The text of the body of the article, complete with HTML markup. article.published\_at:"Thu Mar 24 15:45:47 UTC 2011" ->[publishDate](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleCreateInput#fields-publishDate) The date and time ([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format) when the article was published. ### Create an article with a base64 encoded image ### Path parameters blog\_id=241253187 **string** **required** ### Request body article **Article resource** article.title:"My new Article title" ->[title](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleCreateInput#fields-title) The title of the article. article.author:"John Smith" ->[author](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleCreateInput#fields-author) The name of the author of the article. article.tags:"This Post,Has Been Tagged" ->[tags](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleCreateInput#fields-tags) A comma-separated list of tags. Tags are additional short descriptors formatted as a string of comma-separated values. article.body\_html:"\\Yea\,I like posting them through \REST\.\
" ->[body](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleCreateInput#fields-body) The text of the body of the article, complete with HTML markup. article.published\_at:"Thu Mar 24 15:45:47 UTC 2011" ->[publishDate](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleCreateInput#fields-publishDate) The date and time ([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format) when the article was published. article.image:{"attachment":"R0lGODlhAQABAIAAAAAAAAAAACH5BAEAAAAALAAAAAABAAEAAAICRAEAOw==\n"} ->[image](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleCreateInput#fields-image) An image associated with the article. It can have the following properties: * **attachment**: An image attached to article returned as Base64-encoded binary data. * **src**: A source URL that specifies the location of the image. * **alt**: Alternative text that describes the image. ### Create an article with a metafield ### Path parameters blog\_id=241253187 **string** **required** ### Request body article **Article resource** article.title:"My new Article title" ->[title](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleCreateInput#fields-title) The title of the article. article.author:"John Smith" ->[author](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleCreateInput#fields-author) The name of the author of the article. article.tags:"This Post,Has Been Tagged" ->[tags](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleCreateInput#fields-tags) A comma-separated list of tags. Tags are additional short descriptors formatted as a string of comma-separated values. article.body\_html:"\\Yea\,I like posting them through \REST\.\
" ->[body](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleCreateInput#fields-body) The text of the body of the article, complete with HTML markup. article.published\_at:"Thu Mar 24 15:45:47 UTC 2011" ->[publishDate](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleCreateInput#fields-publishDate) The date and time ([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format) when the article was published. article.metafields:\[{"key":"new","value":"newvalue","type":"single\_line\_text\_field","namespace":"global"}] **array** ->[metafields](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleCreateInput#fields-metafields) The additional information attached to an Article object. It has the following properties: * **key**: An identifier for the metafield. (maximum: 30 characters) * **namespace**: A container for a set of metadata. Namespaces help distinguish between metadata created by different apps. (maximum: 20 characters) * **value**: The information to be stored as metadata. * **type**: The metafield's information type. Refer to the [full list of types](https://shopify.dev/apps/metafields/types). * **description (optional)**: Additional information about the metafield. For more information on attaching metadata to Shopify resources, see the [Metafield](https://shopify.dev/api/admin-rest/latest/resources/metafield) resource. ### Create an article with an image, which will be downloaded by Shopify ### Path parameters blog\_id=241253187 **string** **required** ### Request body article **Article resource** article.title:"My new Article title" ->[title](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleCreateInput#fields-title) The title of the article. article.author:"John Smith" ->[author](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleCreateInput#fields-author) The name of the author of the article. article.tags:"This Post,Has Been Tagged" ->[tags](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleCreateInput#fields-tags) A comma-separated list of tags. Tags are additional short descriptors formatted as a string of comma-separated values. article.body\_html:"\\Yea\,I like posting them through \REST\.\
" ->[body](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleCreateInput#fields-body) The text of the body of the article, complete with HTML markup. article.published\_at:"Thu Mar 24 15:45:47 UTC 2011" ->[publishDate](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleCreateInput#fields-publishDate) The date and time ([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format) when the article was published. article.image:{"src":"http://example.com/rails\_logo.gif","alt":"Rails logo"} ->[image](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleCreateInput#fields-image) An image associated with the article. It can have the following properties: * **attachment**: An image attached to article returned as Base64-encoded binary data. * **src**: A source URL that specifies the location of the image. * **alt**: Alternative text that describes the image. ### Create an unpublished article for a blog ### Path parameters blog\_id=241253187 **string** **required** ### Request body article **Article resource** article.title:"My new Article title" ->[title](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleCreateInput#fields-title) The title of the article. article.author:"John Smith" ->[author](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleCreateInput#fields-author) The name of the author of the article. article.tags:"This Post,Has Been Tagged" ->[tags](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleCreateInput#fields-tags) A comma-separated list of tags. Tags are additional short descriptors formatted as a string of comma-separated values. article.body\_html:"\\Yea\,I like posting them through \REST\.\
" ->[body](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleCreateInput#fields-body) The text of the body of the article, complete with HTML markup. article.published:false ->[is\_published](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleCreateInput) Whether the article is visible. ### Creating an article without a title fails and returns an error ### Path parameters blog\_id=241253187 **string** **required** post ## /admin/api/2026-07/blogs/241253187/articles.json ```bash curl -d '{"article":{"title":"My new Article title","author":"John Smith","tags":"This Post, Has Been Tagged","body_html":"Yea, I like posting them through REST.
","published_at":"Thu Mar 24 15:45:47 UTC 2011"}}' \ -X POST "https://your-development-store.myshopify.com/admin/api/2026-07/blogs/241253187/articles.json" \ -H "X-Shopify-Access-Token: {access_token}" \ -H "Content-Type: application/json" ``` {} ## Response JSON ```json HTTP/1.1 201 Created { "article": { "id": 1051293791, "title": "My new Article title", "created_at": "2026-07-02T10:41:03-04:00", "body_html": "Yea, I like posting them through REST.
", "blog_id": 241253187, "author": "John Smith", "user_id": 548380009, "published_at": "2011-03-24T11:45:47-04:00", "updated_at": "2026-07-02T10:41:03-04:00", "summary_html": null, "template_suffix": null, "handle": "my-new-article-title", "tags": "Has Been Tagged, This Post", "admin_graphql_api_id": "gid://shopify/Article/1051293791" } } ``` ### examples * #### Create an article with HTML markup for a blog ##### ```curl curl -d '{"article":{"title":"My new Article title","author":"John Smith","tags":"This Post, Has Been Tagged","body_html":"Yea, I like posting them through REST.
","published_at":"Thu Mar 24 15:45:47 UTC 2011"}}' \ -X POST "https://your-development-store.myshopify.com/admin/api/2026-07/blogs/241253187/articles.json" \ -H "X-Shopify-Access-Token: {access_token}" \ -H "Content-Type: application/json" ``` #### response ```json HTTP/1.1 201 Created{"article":{"id":1051293791,"title":"My new Article title","created_at":"2026-07-02T10:41:03-04:00","body_html":"Yea, I like posting them through REST.
","blog_id":241253187,"author":"John Smith","user_id":548380009,"published_at":"2011-03-24T11:45:47-04:00","updated_at":"2026-07-02T10:41:03-04:00","summary_html":null,"template_suffix":null,"handle":"my-new-article-title","tags":"Has Been Tagged, This Post","admin_graphql_api_id":"gid://shopify/Article/1051293791"}} ``` * #### Create an article with a base64 encoded image ##### ```curl curl -d '{"article":{"title":"My new Article title","author":"John Smith","tags":"This Post, Has Been Tagged","body_html":"Yea, I like posting them through REST.
","published_at":"Thu Mar 24 15:45:47 UTC 2011","image":{"attachment":"R0lGODlhAQABAIAAAAAAAAAAACH5BAEAAAAALAAAAAABAAEAAAICRAEAOw==\n"}}}' \ -X POST "https://your-development-store.myshopify.com/admin/api/2026-07/blogs/241253187/articles.json" \ -H "X-Shopify-Access-Token: {access_token}" \ -H "Content-Type: application/json" ``` * #### Create an article with a metafield ##### ```curl curl -d '{"article":{"title":"My new Article title","author":"John Smith","tags":"This Post, Has Been Tagged","body_html":"Yea, I like posting them through REST.
","published_at":"Thu Mar 24 15:45:47 UTC 2011","metafields":[{"key":"new","value":"newvalue","type":"single_line_text_field","namespace":"global"}]}}' \ -X POST "https://your-development-store.myshopify.com/admin/api/2026-07/blogs/241253187/articles.json" \ -H "X-Shopify-Access-Token: {access_token}" \ -H "Content-Type: application/json" ``` * #### Create an article with an image, which will be downloaded by Shopify ##### ```curl curl -d '{"article":{"title":"My new Article title","author":"John Smith","tags":"This Post, Has Been Tagged","body_html":"Yea, I like posting them through REST.
","published_at":"Thu Mar 24 15:45:47 UTC 2011","image":{"src":"http://example.com/rails_logo.gif","alt":"Rails logo"}}}' \ -X POST "https://your-development-store.myshopify.com/admin/api/2026-07/blogs/241253187/articles.json" \ -H "X-Shopify-Access-Token: {access_token}" \ -H "Content-Type: application/json" ``` * #### Create an unpublished article for a blog ##### ```curl curl -d '{"article":{"title":"My new Article title","author":"John Smith","tags":"This Post, Has Been Tagged","body_html":"Yea, I like posting them through REST.
","published":false}}' \ -X POST "https://your-development-store.myshopify.com/admin/api/2026-07/blogs/241253187/articles.json" \ -H "X-Shopify-Access-Token: {access_token}" \ -H "Content-Type: application/json" ``` * #### Creating an article without a title fails and returns an error ##### ```curl curl -d '{"article":{"body":"something"}}' \ -X POST "https://your-development-store.myshopify.com/admin/api/2026-07/blogs/241253187/articles.json" \ -H "X-Shopify-Access-Token: {access_token}" \ -H "Content-Type: application/json" ``` #### response ```json HTTP/1.1 422 Unprocessable Entity{"errors":{"title":["can't be blank"]}} ``` *** ## getRetrieves a list of all article authors**deprecated** ### Parameters *** api\_version **string** **required** *** ### Examples ### Retrieve a list of all article authors get ## /admin/api/2026-07/articles/authors.json ```bash curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/articles/authors.json" \ -H "X-Shopify-Access-Token: {access_token}" ``` {} ## Response JSON ```json HTTP/1.1 200 OK { "authors": [ "dennis", "John", "Rob", "Dennis" ] } ``` ### examples * #### Retrieve a list of all article authors ##### ```curl curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/articles/authors.json" \ -H "X-Shopify-Access-Token: {access_token}" ``` #### response ```json HTTP/1.1 200 OK{"authors":["dennis","John","Rob","Dennis"]} ``` *** ## getRetrieves a list of all article tags [articleTags](https://shopify.dev/docs/api/admin-graphql/latest/queries/articleTags?example=retrieves-a-list-of-all-article-tags) ### Parameters *** api\_version **string** **required** *** limit The maximum number of tags to retrieve. *** popular A flag for ordering retrieved tags. If present in the request, then the results will be ordered by popularity, starting with the most popular tag. *** ### Examples ### Retrieve a list of all tags for all articles ### Retrieve a list of the most popular tags ### Query parameters limit=1 The maximum number of tags to retrieve. popular=1 A flag for ordering retrieved tags. If present in the request, then the results will be ordered by popularity, starting with the most popular tag. get ## /admin/api/2026-07/articles/tags.json ```bash curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/articles/tags.json" \ -H "X-Shopify-Access-Token: {access_token}" ``` {} ## Response JSON ```json HTTP/1.1 200 OK { "tags": [ "Announcing", "Mystery" ] } ``` ### examples * #### Retrieve a list of all tags for all articles ##### ```curl curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/articles/tags.json" \ -H "X-Shopify-Access-Token: {access_token}" ``` #### response ```json HTTP/1.1 200 OK{"tags":["Announcing","Mystery"]} ``` * #### Retrieve a list of the most popular tags ##### ```curl curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/articles/tags.json?limit=1&popular=1" \ -H "X-Shopify-Access-Token: {access_token}" ``` *** ## getRetrieves a list of all articles from a blog [blog](https://shopify.dev/docs/api/admin-graphql/latest/queries/blog?example=retrieves-a-list-of-all-articles-from-a-blog) Retrieves a list of all articles from a blog. **Note:** This endpoint implements pagination by using links that are provided in the response header. To learn more, refer to [Make paginated requests to the REST Admin API](https://shopify.dev/api/usage/pagination-rest). ### Parameters *** api\_version **string** **required** *** blog\_id **string** **required** *** author Filter articles by article author. *** created\_at\_max Show articles created before date (format: 2014-04-25T16:15:47-04:00). *** created\_at\_min Show articles created after date (format: 2014-04-25T16:15:47-04:00). *** fields Show only certain fields, specified by a comma-separated list of field names. *** handle Retrieve an article with a specific handle. *** limit **≤ 250** **default 50** The maximum number of results to retrieve. *** published\_at\_max Show articles published 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\_status **default any** Retrieve results based on their published status. * **published**: Show only published articles. * **unpublished**: Show only unpublished articles. * **any**: Show articles of any published status. *** since\_id Restrict results to after the specified ID. *** ### Examples ### Retrieve a list of articles from a blog ### Path parameters blog\_id=241253187 **string** **required** ### Retrieve all articles from a blog after a specified ID ### Path parameters blog\_id=241253187 **string** **required** ### Query parameters since\_id=134645308 Restrict results to after the specified ID. get ## /admin/api/2026-07/blogs/241253187/articles.json ```bash curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/blogs/241253187/articles.json" \ -H "X-Shopify-Access-Token: {access_token}" ``` {} ## Response JSON ```json HTTP/1.1 200 OK { "articles": [ { "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": "2026-07-02T10:36:00-04:00", "summary_html": null, "template_suffix": null, "handle": "welcome-to-the-world-of-tomorrow", "tags": "", "admin_graphql_api_id": "gid://shopify/Article/1051293780" }, { "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", "admin_graphql_api_id": "gid://shopify/Article/989034056" }, { "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": "2026-07-02T10:36:00-04:00", "summary_html": null, "template_suffix": null, "handle": "just-us-bots-here", "tags": "", "admin_graphql_api_id": "gid://shopify/Article/294160202" }, { "id": 134645308, "title": "get on the train now", "created_at": "2008-07-31T20:00:00-04:00", "body_html": "Do you have an IPod yet?
", "blog_id": 241253187, "author": "Dennis", "user_id": 548380009, "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", "admin_graphql_api_id": "gid://shopify/Article/134645308", "image": { "created_at": "2026-07-02T10:36:00-04:00", "alt": "iMac", "width": 123, "height": 456, "src": "https://cdn.shopify.com/s/files/1/0005/4838/0009/articles/imac.jpg?v=1783002960" } } ] } ``` ### examples * #### Retrieve a list of articles from a blog ##### ```curl curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/blogs/241253187/articles.json" \ -H "X-Shopify-Access-Token: {access_token}" ``` #### response ```json HTTP/1.1 200 OK{"articles":[{"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":"2026-07-02T10:36:00-04:00","summary_html":null,"template_suffix":null,"handle":"welcome-to-the-world-of-tomorrow","tags":"","admin_graphql_api_id":"gid://shopify/Article/1051293780"},{"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","admin_graphql_api_id":"gid://shopify/Article/989034056"},{"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":"2026-07-02T10:36:00-04:00","summary_html":null,"template_suffix":null,"handle":"just-us-bots-here","tags":"","admin_graphql_api_id":"gid://shopify/Article/294160202"},{"id":134645308,"title":"get on the train now","created_at":"2008-07-31T20:00:00-04:00","body_html":"Do you have an IPod yet?
","blog_id":241253187,"author":"Dennis","user_id":548380009,"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","admin_graphql_api_id":"gid://shopify/Article/134645308","image":{"created_at":"2026-07-02T10:36:00-04:00","alt":"iMac","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/articles/imac.jpg?v=1783002960"}}]} ``` * #### Retrieve all articles from a blog after a specified ID ##### ```curl curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/blogs/241253187/articles.json?since_id=134645308" \ -H "X-Shopify-Access-Token: {access_token}" ``` *** ## getReceive a single Article [article](https://shopify.dev/docs/api/admin-graphql/latest/queries/article?example=receive-a-single-article) Retrieves a single article ### Parameters *** api\_version **string** **required** *** article\_id **string** **required** *** blog\_id **string** **required** *** fields Show only certain fields, specifed by a comma-separated list of field names. *** ### Examples ### Retrieve a single article get ## /admin/api/2026-07/blogs/241253187/articles/134645308.json ```bash curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/blogs/241253187/articles/134645308.json" \ -H "X-Shopify-Access-Token: {access_token}" ``` {} ## Response JSON ```json 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": "Do you have an IPod yet?
", "blog_id": 241253187, "author": "Dennis", "user_id": 548380009, "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", "admin_graphql_api_id": "gid://shopify/Article/134645308", "image": { "created_at": "2026-07-02T10:36:00-04:00", "alt": "iMac", "width": 123, "height": 456, "src": "https://cdn.shopify.com/s/files/1/0005/4838/0009/articles/imac.jpg?v=1783002960" } } } ``` ### examples * #### Retrieve a single article ##### ```curl curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/blogs/241253187/articles/134645308.json" \ -H "X-Shopify-Access-Token: {access_token}" ``` #### response ```json 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":"Do you have an IPod yet?
","blog_id":241253187,"author":"Dennis","user_id":548380009,"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","admin_graphql_api_id":"gid://shopify/Article/134645308","image":{"created_at":"2026-07-02T10:36:00-04:00","alt":"iMac","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/articles/imac.jpg?v=1783002960"}}} ``` *** ## getRetrieves a count of all articles from a blog [blog](https://shopify.dev/docs/api/admin-graphql/latest/queries/blog?example=retrieves-a-count-of-all-articles-from-a-blog) ### Parameters *** api\_version **string** **required** *** blog\_id **string** **required** *** created\_at\_max Count articles created before date (format: 2014-04-25T16:15:47-04:00). *** created\_at\_min Count articles created 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\_at\_min Count articles published after date (format: 2014-04-25T16:15:47-04:00). *** published\_status **default any** Count articles with a given published status. * **published**: Count only published articles. * **unpublished**: Count only unpublished articles. * **any**: Count all articles. *** updated\_at\_max Count articles last updated 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). *** ### Examples ### Count all a blog's articles ### Path parameters blog\_id=241253187 **string** **required** get ## /admin/api/2026-07/blogs/241253187/articles/count.json ```bash curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/blogs/241253187/articles/count.json" \ -H "X-Shopify-Access-Token: {access_token}" ``` {} ## Response JSON ```json HTTP/1.1 200 OK { "count": 4 } ``` ### examples * #### Count all a blog's articles ##### ```curl curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/blogs/241253187/articles/count.json" \ -H "X-Shopify-Access-Token: {access_token}" ``` #### response ```json HTTP/1.1 200 OK{"count":4} ``` *** ## getRetrieves a list of all article tags from a specific blog**deprecated** ### Parameters *** api\_version **string** **required** *** blog\_id **string** **required** *** limit The maximum number of tags to retrieve. *** popular A flag for ordering retrieved tags. If present in the request, then the results will be ordered by popularity, starting with the most popular tag. *** ### Examples ### Retrieve a list of all tags from a specific blog ### Path parameters blog\_id=241253187 **string** **required** ### Retrieve a list of the most popular tags from a specific blog ### Path parameters blog\_id=241253187 **string** **required** ### Query parameters limit=1 The maximum number of tags to retrieve. popular=1 A flag for ordering retrieved tags. If present in the request, then the results will be ordered by popularity, starting with the most popular tag. get ## /admin/api/2026-07/blogs/241253187/articles/tags.json ```bash curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/blogs/241253187/articles/tags.json" \ -H "X-Shopify-Access-Token: {access_token}" ``` {} ## Response JSON ```json HTTP/1.1 200 OK { "tags": [ "Announcing", "Mystery" ] } ``` ### examples * #### Retrieve a list of all tags from a specific blog ##### ```curl curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/blogs/241253187/articles/tags.json" \ -H "X-Shopify-Access-Token: {access_token}" ``` #### response ```json HTTP/1.1 200 OK{"tags":["Announcing","Mystery"]} ``` * #### Retrieve a list of the most popular tags from a specific blog ##### ```curl curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/blogs/241253187/articles/tags.json?limit=1&popular=1" \ -H "X-Shopify-Access-Token: {access_token}" ``` *** ## putUpdates an article [articleUpdate](https://shopify.dev/docs/api/admin-graphql/latest/mutations/articleUpdate?example=updates-an-article) ### Parameters *** api\_version **string** **required** *** article\_id **string** **required** *** blog\_id **string** **required** *** ### Examples ### Add a metafield to an existing article ### Request body article **Article resource** article.id:134645308 **read-only** The ID of the article. article.metafields:\[{"key":"new","value":"newvalue","type":"single\_line\_text\_field","namespace":"global"}] **array** ->[metafields](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleUpdateInput#fields-metafields) The additional information attached to an Article object. It has the following properties: * **key**: An identifier for the metafield. (maximum: 30 characters) * **namespace**: A container for a set of metadata. Namespaces help distinguish between metadata created by different apps. (maximum: 20 characters) * **value**: The information to be stored as metadata. * **type**: The metafield's information type. Refer to the [full list of types](https://shopify.dev/apps/metafields/types). * **description (optional)**: Additional information about the metafield. For more information on attaching metadata to Shopify resources, see the [Metafield](https://shopify.dev/api/admin-rest/latest/resources/metafield) resource. ### Hide a published article ### Request body article **Article resource** article.id:134645308 **read-only** The ID of the article. article.published:false ->[is\_published](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleUpdateInput) Whether the article is visible. ### Publish a hidden article ### Request body article **Article resource** article.id:134645308 **read-only** The ID of the article. article.published:true ->[is\_published](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleUpdateInput) Whether the article is visible. ### Remove the image from an article ### Request body article **Article resource** article.id:134645308 **read-only** The ID of the article. article.image:"" ->[image](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleUpdateInput#fields-image) An image associated with the article. It can have the following properties: * **attachment**: An image attached to article returned as Base64-encoded binary data. * **src**: A source URL that specifies the location of the image. * **alt**: Alternative text that describes the image. ### Update an article's image ### Request body article **Article resource** article.id:134645308 **read-only** The ID of the article. article.title:"My new Title" ->[title](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleUpdateInput#fields-title) The title of the article. article.author:"Your name" ->[author](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleUpdateInput#fields-author) The name of the author of the article. article.tags:"Tags,Will Be,Updated" ->[tags](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleUpdateInput#fields-tags) A comma-separated list of tags. Tags are additional short descriptors formatted as a string of comma-separated values. article.body\_html:"\Look,I can even update through a web service.\
" ->[body](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleUpdateInput#fields-body) The text of the body of the article, complete with HTML markup. article.published\_at:"Thu Mar 24 15:45:47 UTC 2011" ->[publishDate](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleUpdateInput#fields-publishDate) The date and time ([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format) when the article was published. article.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\n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\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"} ->[image](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleUpdateInput#fields-image) An image associated with the article. It can have the following properties: * **attachment**: An image attached to article returned as Base64-encoded binary data. * **src**: A source URL that specifies the location of the image. * **alt**: Alternative text that describes the image. ### Update an existing article of a blog ### Request body article **Article resource** article.id:134645308 **read-only** The ID of the article. article.title:"My new Title" ->[title](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleUpdateInput#fields-title) The title of the article. article.author:"Your name" ->[author](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleUpdateInput#fields-author) The name of the author of the article. article.tags:"Tags,Will Be,Updated" ->[tags](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleUpdateInput#fields-tags) A comma-separated list of tags. Tags are additional short descriptors formatted as a string of comma-separated values. article.body\_html:"\Look,I can even update through a web service.\
" ->[body](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleUpdateInput#fields-body) The text of the body of the article, complete with HTML markup. article.published\_at:"Thu Mar 24 15:45:47 UTC 2011" ->[publishDate](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleUpdateInput#fields-publishDate) The date and time ([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format) when the article was published. ### Update the alt text for an article image ### Request body article **Article resource** article.id:134645308 **read-only** The ID of the article. article.title:"My new Title" ->[title](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleUpdateInput#fields-title) The title of the article. article.author:"Your name" ->[author](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleUpdateInput#fields-author) The name of the author of the article. article.tags:"Tags,Will Be,Updated" ->[tags](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleUpdateInput#fields-tags) A comma-separated list of tags. Tags are additional short descriptors formatted as a string of comma-separated values. article.body\_html:"\Look,I can even update through a web service.\
" ->[body](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleUpdateInput#fields-body) The text of the body of the article, complete with HTML markup. article.published\_at:"Thu Mar 24 15:45:47 UTC 2011" ->[publishDate](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleUpdateInput#fields-publishDate) The date and time ([ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format) when the article was published. article.image:{"alt":"Rails logo"} ->[image](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ArticleUpdateInput#fields-image) An image associated with the article. It can have the following properties: * **attachment**: An image attached to article returned as Base64-encoded binary data. * **src**: A source URL that specifies the location of the image. * **alt**: Alternative text that describes the image. put ## /admin/api/2026-07/blogs/241253187/articles/134645308.json ```bash curl -d '{"article":{"id":134645308,"metafields":[{"key":"new","value":"newvalue","type":"single_line_text_field","namespace":"global"}]}}' \ -X PUT "https://your-development-store.myshopify.com/admin/api/2026-07/blogs/241253187/articles/134645308.json" \ -H "X-Shopify-Access-Token: {access_token}" \ -H "Content-Type: application/json" ``` {} ## Response JSON ```json HTTP/1.1 200 OK { "article": { "blog_id": 241253187, "title": "get on the train now", "handle": "get-on-the-train-now", "body_html": "Do you have an IPod yet?
", "author": "Dennis", "id": 134645308, "summary_html": null, "created_at": "2008-07-31T20:00:00-04:00", "user_id": 548380009, "published_at": "2008-07-31T20:00:00-04:00", "updated_at": "2008-07-31T20:00:00-04:00", "template_suffix": null, "tags": "Announcing", "admin_graphql_api_id": "gid://shopify/Article/134645308", "image": { "created_at": "2026-07-02T10:36:00-04:00", "alt": "iMac", "width": 123, "height": 456, "src": "https://cdn.shopify.com/s/files/1/0005/4838/0009/articles/imac.jpg?v=1783002960" } } } ``` ### examples * #### Add a metafield to an existing article ##### ```curl curl -d '{"article":{"id":134645308,"metafields":[{"key":"new","value":"newvalue","type":"single_line_text_field","namespace":"global"}]}}' \ -X PUT "https://your-development-store.myshopify.com/admin/api/2026-07/blogs/241253187/articles/134645308.json" \ -H "X-Shopify-Access-Token: {access_token}" \ -H "Content-Type: application/json" ``` #### response ```json HTTP/1.1 200 OK{"article":{"blog_id":241253187,"title":"get on the train now","handle":"get-on-the-train-now","body_html":"Do you have an IPod yet?
","author":"Dennis","id":134645308,"summary_html":null,"created_at":"2008-07-31T20:00:00-04:00","user_id":548380009,"published_at":"2008-07-31T20:00:00-04:00","updated_at":"2008-07-31T20:00:00-04:00","template_suffix":null,"tags":"Announcing","admin_graphql_api_id":"gid://shopify/Article/134645308","image":{"created_at":"2026-07-02T10:36:00-04:00","alt":"iMac","width":123,"height":456,"src":"https://cdn.shopify.com/s/files/1/0005/4838/0009/articles/imac.jpg?v=1783002960"}}} ``` * #### Hide a published article ##### ```curl curl -d '{"article":{"id":134645308,"published":false}}' \ -X PUT "https://your-development-store.myshopify.com/admin/api/2026-07/blogs/241253187/articles/134645308.json" \ -H "X-Shopify-Access-Token: {access_token}" \ -H "Content-Type: application/json" ``` * #### Publish a hidden article ##### ```curl curl -d '{"article":{"id":134645308,"published":true}}' \ -X PUT "https://your-development-store.myshopify.com/admin/api/2026-07/blogs/241253187/articles/134645308.json" \ -H "X-Shopify-Access-Token: {access_token}" \ -H "Content-Type: application/json" ``` * #### Remove the image from an article ##### ```curl curl -d '{"article":{"id":134645308,"image":""}}' \ -X PUT "https://your-development-store.myshopify.com/admin/api/2026-07/articles/134645308.json" \ -H "X-Shopify-Access-Token: {access_token}" \ -H "Content-Type: application/json" ``` * #### Update an article's image ##### ```curl curl -d '{"article":{"id":134645308,"title":"My new Title","author":"Your name","tags":"Tags, Will Be, Updated","body_html":"Look, I can even update through a web service.
","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\n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\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"}}}' \ -X PUT "https://your-development-store.myshopify.com/admin/api/2026-07/blogs/241253187/articles/134645308.json" \ -H "X-Shopify-Access-Token: {access_token}" \ -H "Content-Type: application/json" ``` * #### Update an existing article of a blog ##### ```curl curl -d '{"article":{"id":134645308,"title":"My new Title","author":"Your name","tags":"Tags, Will Be, Updated","body_html":"Look, I can even update through a web service.
","published_at":"Thu Mar 24 15:45:47 UTC 2011"}}' \ -X PUT "https://your-development-store.myshopify.com/admin/api/2026-07/blogs/241253187/articles/134645308.json" \ -H "X-Shopify-Access-Token: {access_token}" \ -H "Content-Type: application/json" ``` * #### Update the alt text for an article image ##### ```curl curl -d '{"article":{"id":134645308,"title":"My new Title","author":"Your name","tags":"Tags, Will Be, Updated","body_html":"Look, I can even update through a web service.
","published_at":"Thu Mar 24 15:45:47 UTC 2011","image":{"alt":"Rails logo"}}}' \ -X PUT "https://your-development-store.myshopify.com/admin/api/2026-07/blogs/241253187/articles/134645308.json" \ -H "X-Shopify-Access-Token: {access_token}" \ -H "Content-Type: application/json" ``` *** ## delDeletes an article [articleDelete](https://shopify.dev/docs/api/admin-graphql/latest/mutations/articleDelete?example=deletes-an-article) ### Parameters *** api\_version **string** **required** *** article\_id **string** **required** *** blog\_id **string** **required** *** ### Examples ### Delete an existing article from a blog del ## /admin/api/2026-07/blogs/241253187/articles/134645308.json ```bash curl -X DELETE "https://your-development-store.myshopify.com/admin/api/2026-07/blogs/241253187/articles/134645308.json" \ -H "X-Shopify-Access-Token: {access_token}" ``` {} ## Response JSON ```json HTTP/1.1 200 OK {} ``` ### examples * #### Delete an existing article from a blog ##### ```curl curl -X DELETE "https://your-development-store.myshopify.com/admin/api/2026-07/blogs/241253187/articles/134645308.json" \ -H "X-Shopify-Access-Token: {access_token}" ``` #### response ```json HTTP/1.1 200 OK{} ```