naftiko: 1.0.0-alpha2
info:
  label: Shopify  API — Article
  description: 'Shopify  API — Article. 32 operations. Lead operation: Shopify Retrieves A List All Of Article Authors. Self-contained
    Naftiko capability covering one Shopify business surface.'
  tags:
  - Shopify
  - Article
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    SHOPIFY_API_KEY: SHOPIFY_API_KEY
capability:
  consumes:
  - type: http
    namespace: shopify-article
    baseUri: ''
    description: Shopify  API — Article business capability. Self-contained, no shared references.
    resources:
    - name: admin-api-2020-01-articles-authors.json
      path: /admin/api/2020-01/articles/authors.json
      operations:
      - name: deprecated202001getarticlesauthors
        method: GET
        description: Shopify Retrieves A List All Of Article Authors
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: admin-api-2020-01-blogs-blog_id-articles.json
      path: /admin/api/2020-01/blogs/{blog_id}/articles.json
      operations:
      - name: deprecated202001createblogsparamblogidarticles
        method: POST
        description: Shopify Creates An Article For A Blog
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: blog_id
          in: path
          type: string
          description: blog_id
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: admin-api-2020-01-blogs-blog_id-articles-article_id}.json
      path: /admin/api/2020-01/blogs/{blog_id}/articles/{article_id}.json
      operations:
      - name: deprecated202001getblogsparamblogidarticlesparamarticleid
        method: GET
        description: Shopify Retrieves A Single Article
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: blog_id
          in: path
          type: string
          description: blog_id
          required: true
        - name: article_id
          in: path
          type: string
          description: article_id
          required: true
        - name: fields
          in: query
          type: string
          description: Show only certain fields, specifed by a comma-separated list of field names.
      - name: deprecated202001updateblogsparamblogidarticlesparamarticleid
        method: PUT
        description: Shopify Updates An Article
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: blog_id
          in: path
          type: string
          description: blog_id
          required: true
        - name: article_id
          in: path
          type: string
          description: article_id
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: deprecated202001deleteblogsparamblogidarticlesparamarticleid
        method: DELETE
        description: Shopify Deletes An Article
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: blog_id
          in: path
          type: string
          description: blog_id
          required: true
        - name: article_id
          in: path
          type: string
          description: article_id
          required: true
    - name: admin-api-2020-01-comments.json
      path: /admin/api/2020-01/comments.json
      operations:
      - name: deprecated202001createcomments
        method: POST
        description: Shopify Creates A Comment For An Article
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: admin-api-2020-01-comments-comment_id}.json
      path: /admin/api/2020-01/comments/{comment_id}.json
      operations:
      - name: deprecated202001updatecommentsparamcommentid
        method: PUT
        description: Shopify Updates A Comment Of An Article
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: comment_id
          in: path
          type: string
          description: comment_id
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: admin-api-2020-04-articles-authors.json
      path: /admin/api/2020-04/articles/authors.json
      operations:
      - name: deprecated202004getarticlesauthors
        method: GET
        description: Shopify Retrieves A List All Of Article Authors
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: admin-api-2020-04-blogs-blog_id-articles.json
      path: /admin/api/2020-04/blogs/{blog_id}/articles.json
      operations:
      - name: deprecated202004createblogsparamblogidarticles
        method: POST
        description: Shopify Creates An Article For A Blog
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: blog_id
          in: path
          type: string
          description: blog_id
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: admin-api-2020-04-blogs-blog_id-articles-article_id}.json
      path: /admin/api/2020-04/blogs/{blog_id}/articles/{article_id}.json
      operations:
      - name: deprecated202004getblogsparamblogidarticlesparamarticleid
        method: GET
        description: Shopify Retrieves A Single Article
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: blog_id
          in: path
          type: string
          description: blog_id
          required: true
        - name: article_id
          in: path
          type: string
          description: article_id
          required: true
        - name: fields
          in: query
          type: string
          description: Show only certain fields, specifed by a comma-separated list of field names.
      - name: deprecated202004updateblogsparamblogidarticlesparamarticleid
        method: PUT
        description: Shopify Updates An Article
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: blog_id
          in: path
          type: string
          description: blog_id
          required: true
        - name: article_id
          in: path
          type: string
          description: article_id
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: deprecated202004deleteblogsparamblogidarticlesparamarticleid
        method: DELETE
        description: Shopify Deletes An Article
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: blog_id
          in: path
          type: string
          description: blog_id
          required: true
        - name: article_id
          in: path
          type: string
          description: article_id
          required: true
    - name: admin-api-2020-07-articles-authors.json
      path: /admin/api/2020-07/articles/authors.json
      operations:
      - name: deprecated202007getarticlesauthors
        method: GET
        description: Shopify Retrieves A List All Of Article Authors
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: admin-api-2020-07-blogs-blog_id-articles.json
      path: /admin/api/2020-07/blogs/{blog_id}/articles.json
      operations:
      - name: deprecated202007createblogsparamblogidarticles
        method: POST
        description: Shopify Creates An Article For A Blog
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: blog_id
          in: path
          type: string
          description: blog_id
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: admin-api-2020-07-blogs-blog_id-articles-article_id}.json
      path: /admin/api/2020-07/blogs/{blog_id}/articles/{article_id}.json
      operations:
      - name: deprecated202007getblogsparamblogidarticlesparamarticleid
        method: GET
        description: Shopify Retrieves A Single Article
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: blog_id
          in: path
          type: string
          description: blog_id
          required: true
        - name: article_id
          in: path
          type: string
          description: article_id
          required: true
        - name: fields
          in: query
          type: string
          description: Show only certain fields, specifed by a comma-separated list of field names.
      - name: deprecated202007updateblogsparamblogidarticlesparamarticleid
        method: PUT
        description: Shopify Updates An Article
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: blog_id
          in: path
          type: string
          description: blog_id
          required: true
        - name: article_id
          in: path
          type: string
          description: article_id
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: deprecated202007deleteblogsparamblogidarticlesparamarticleid
        method: DELETE
        description: Shopify Deletes An Article
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: blog_id
          in: path
          type: string
          description: blog_id
          required: true
        - name: article_id
          in: path
          type: string
          description: article_id
          required: true
    - name: admin-api-2020-10-articles-authors.json
      path: /admin/api/2020-10/articles/authors.json
      operations:
      - name: getarticlesauthors
        method: GET
        description: Shopify Retrieves A List All Of Article Authors
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: admin-api-2020-10-blogs-blog_id-articles.json
      path: /admin/api/2020-10/blogs/{blog_id}/articles.json
      operations:
      - name: createblogsparamblogidarticles
        method: POST
        description: Shopify Creates An Article For A Blog
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: blog_id
          in: path
          type: string
          description: blog_id
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: admin-api-2020-10-blogs-blog_id-articles-article_id}.json
      path: /admin/api/2020-10/blogs/{blog_id}/articles/{article_id}.json
      operations:
      - name: getblogsparamblogidarticlesparamarticleid
        method: GET
        description: Shopify Retrieves A Single Article
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: blog_id
          in: path
          type: string
          description: blog_id
          required: true
        - name: article_id
          in: path
          type: string
          description: article_id
          required: true
        - name: fields
          in: query
          type: string
          description: Show only certain fields, specifed by a comma-separated list of field names.
      - name: updateblogsparamblogidarticlesparamarticleid
        method: PUT
        description: Shopify Updates An Article
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: blog_id
          in: path
          type: string
          description: blog_id
          required: true
        - name: article_id
          in: path
          type: string
          description: article_id
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: deleteblogsparamblogidarticlesparamarticleid
        method: DELETE
        description: Shopify Deletes An Article
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: blog_id
          in: path
          type: string
          description: blog_id
          required: true
        - name: article_id
          in: path
          type: string
          description: article_id
          required: true
    - name: admin-api-2021-01-articles-authors.json
      path: /admin/api/2021-01/articles/authors.json
      operations:
      - name: deprecated202101getarticlesauthors
        method: GET
        description: Shopify Retrieves A List All Of Article Authors
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: admin-api-2021-01-blogs-blog_id-articles.json
      path: /admin/api/2021-01/blogs/{blog_id}/articles.json
      operations:
      - name: deprecated202101createblogsparamblogidarticles
        method: POST
        description: Shopify Creates An Article For A Blog
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: blog_id
          in: path
          type: string
          description: blog_id
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: admin-api-2021-01-blogs-blog_id-articles-article_id}.json
      path: /admin/api/2021-01/blogs/{blog_id}/articles/{article_id}.json
      operations:
      - name: deprecated202101getblogsparamblogidarticlesparamarticleid
        method: GET
        description: Shopify Retrieves A Single Article
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: blog_id
          in: path
          type: string
          description: blog_id
          required: true
        - name: article_id
          in: path
          type: string
          description: article_id
          required: true
        - name: fields
          in: query
          type: string
          description: Show only certain fields, specifed by a comma-separated list of field names.
      - name: deprecated202101updateblogsparamblogidarticlesparamarticleid
        method: PUT
        description: Shopify Updates An Article
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: blog_id
          in: path
          type: string
          description: blog_id
          required: true
        - name: article_id
          in: path
          type: string
          description: article_id
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: deprecated202101deleteblogsparamblogidarticlesparamarticleid
        method: DELETE
        description: Shopify Deletes An Article
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: blog_id
          in: path
          type: string
          description: blog_id
          required: true
        - name: article_id
          in: path
          type: string
          description: article_id
          required: true
    - name: admin-api-unstable-articles-authors.json
      path: /admin/api/unstable/articles/authors.json
      operations:
      - name: deprecatedunstablegetarticlesauthors
        method: GET
        description: Shopify Retrieves A List All Of Article Authors
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: admin-api-unstable-blogs-blog_id-articles.json
      path: /admin/api/unstable/blogs/{blog_id}/articles.json
      operations:
      - name: deprecatedunstablecreateblogsparamblogidarticles
        method: POST
        description: Shopify Creates An Article For A Blog
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: blog_id
          in: path
          type: string
          description: blog_id
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: admin-api-unstable-blogs-blog_id-articles-article_id}.json
      path: /admin/api/unstable/blogs/{blog_id}/articles/{article_id}.json
      operations:
      - name: deprecatedunstablegetblogsparamblogidarticlesparamarticleid
        method: GET
        description: Shopify Retrieves A Single Article
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: blog_id
          in: path
          type: string
          description: blog_id
          required: true
        - name: article_id
          in: path
          type: string
          description: article_id
          required: true
        - name: fields
          in: query
          type: string
          description: Show only certain fields, specifed by a comma-separated list of field names.
      - name: deprecatedunstableupdateblogsparamblogidarticlesparamarticleid
        method: PUT
        description: Shopify Updates An Article
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: blog_id
          in: path
          type: string
          description: blog_id
          required: true
        - name: article_id
          in: path
          type: string
          description: article_id
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: deprecatedunstabledeleteblogsparamblogidarticlesparamarticleid
        method: DELETE
        description: Shopify Deletes An Article
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: blog_id
          in: path
          type: string
          description: blog_id
          required: true
        - name: article_id
          in: path
          type: string
          description: article_id
          required: true
  exposes:
  - type: rest
    namespace: shopify-article-rest
    port: 8080
    description: REST adapter for Shopify  API — Article. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/admin/api/2020-01/articles/authors-json
      name: admin-api-2020-01-articles-authors-json
      description: REST surface for admin-api-2020-01-articles-authors.json.
      operations:
      - method: GET
        name: deprecated202001getarticlesauthors
        description: Shopify Retrieves A List All Of Article Authors
        call: shopify-article.deprecated202001getarticlesauthors
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin/api/2020-01/blogs/{blog-id}/articles-json
      name: admin-api-2020-01-blogs-blog-id-articles-json
      description: REST surface for admin-api-2020-01-blogs-blog_id-articles.json.
      operations:
      - method: POST
        name: deprecated202001createblogsparamblogidarticles
        description: Shopify Creates An Article For A Blog
        call: shopify-article.deprecated202001createblogsparamblogidarticles
        with:
          blog_id: rest.blog_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin/api/2020-01/blogs/{blog-id}/articles/article-id-json
      name: admin-api-2020-01-blogs-blog-id-articles-article-id-json
      description: REST surface for admin-api-2020-01-blogs-blog_id-articles-article_id}.json.
      operations:
      - method: GET
        name: deprecated202001getblogsparamblogidarticlesparamarticleid
        description: Shopify Retrieves A Single Article
        call: shopify-article.deprecated202001getblogsparamblogidarticlesparamarticleid
        with:
          blog_id: rest.blog_id
          article_id: rest.article_id
          fields: rest.fields
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: deprecated202001updateblogsparamblogidarticlesparamarticleid
        description: Shopify Updates An Article
        call: shopify-article.deprecated202001updateblogsparamblogidarticlesparamarticleid
        with:
          blog_id: rest.blog_id
          article_id: rest.article_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deprecated202001deleteblogsparamblogidarticlesparamarticleid
        description: Shopify Deletes An Article
        call: shopify-article.deprecated202001deleteblogsparamblogidarticlesparamarticleid
        with:
          blog_id: rest.blog_id
          article_id: rest.article_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin/api/2020-01/comments-json
      name: admin-api-2020-01-comments-json
      description: REST surface for admin-api-2020-01-comments.json.
      operations:
      - method: POST
        name: deprecated202001createcomments
        description: Shopify Creates A Comment For An Article
        call: shopify-article.deprecated202001createcomments
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin/api/2020-01/comments/comment-id-json
      name: admin-api-2020-01-comments-comment-id-json
      description: REST surface for admin-api-2020-01-comments-comment_id}.json.
      operations:
      - method: PUT
        name: deprecated202001updatecommentsparamcommentid
        description: Shopify Updates A Comment Of An Article
        call: shopify-article.deprecated202001updatecommentsparamcommentid
        with:
          comment_id: rest.comment_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin/api/2020-04/articles/authors-json
      name: admin-api-2020-04-articles-authors-json
      description: REST surface for admin-api-2020-04-articles-authors.json.
      operations:
      - method: GET
        name: deprecated202004getarticlesauthors
        description: Shopify Retrieves A List All Of Article Authors
        call: shopify-article.deprecated202004getarticlesauthors
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin/api/2020-04/blogs/{blog-id}/articles-json
      name: admin-api-2020-04-blogs-blog-id-articles-json
      description: REST surface for admin-api-2020-04-blogs-blog_id-articles.json.
      operations:
      - method: POST
        name: deprecated202004createblogsparamblogidarticles
        description: Shopify Creates An Article For A Blog
        call: shopify-article.deprecated202004createblogsparamblogidarticles
        with:
          blog_id: rest.blog_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin/api/2020-04/blogs/{blog-id}/articles/article-id-json
      name: admin-api-2020-04-blogs-blog-id-articles-article-id-json
      description: REST surface for admin-api-2020-04-blogs-blog_id-articles-article_id}.json.
      operations:
      - method: GET
        name: deprecated202004getblogsparamblogidarticlesparamarticleid
        description: Shopify Retrieves A Single Article
        call: shopify-article.deprecated202004getblogsparamblogidarticlesparamarticleid
        with:
          blog_id: rest.blog_id
          article_id: rest.article_id
          fields: rest.fields
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: deprecated202004updateblogsparamblogidarticlesparamarticleid
        description: Shopify Updates An Article
        call: shopify-article.deprecated202004updateblogsparamblogidarticlesparamarticleid
        with:
          blog_id: rest.blog_id
          article_id: rest.article_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deprecated202004deleteblogsparamblogidarticlesparamarticleid
        description: Shopify Deletes An Article
        call: shopify-article.deprecated202004deleteblogsparamblogidarticlesparamarticleid
        with:
          blog_id: rest.blog_id
          article_id: rest.article_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin/api/2020-07/articles/authors-json
      name: admin-api-2020-07-articles-authors-json
      description: REST surface for admin-api-2020-07-articles-authors.json.
      operations:
      - method: GET
        name: deprecated202007getarticlesauthors
        description: Shopify Retrieves A List All Of Article Authors
        call: shopify-article.deprecated202007getarticlesauthors
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin/api/2020-07/blogs/{blog-id}/articles-json
      name: admin-api-2020-07-blogs-blog-id-articles-json
      description: REST surface for admin-api-2020-07-blogs-blog_id-articles.json.
      operations:
      - method: POST
        name: deprecated202007createblogsparamblogidarticles
        description: Shopify Creates An Article For A Blog
        call: shopify-article.deprecated202007createblogsparamblogidarticles
        with:
          blog_id: rest.blog_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin/api/2020-07/blogs/{blog-id}/articles/article-id-json
      name: admin-api-2020-07-blogs-blog-id-articles-article-id-json
      description: REST surface for admin-api-2020-07-blogs-blog_id-articles-article_id}.json.
      operations:
      - method: GET
        name: deprecated202007getblogsparamblogidarticlesparamarticleid
        description: Shopify Retrieves A Single Article
        call: shopify-article.deprecated202007getblogsparamblogidarticlesparamarticleid
        with:
          blog_id: rest.blog_id
          article_id: rest.article_id
          fields: rest.fields
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: deprecated202007updateblogsparamblogidarticlesparamarticleid
        description: Shopify Updates An Article
        call: shopify-article.deprecated202007updateblogsparamblogidarticlesparamarticleid
        with:
          blog_id: rest.blog_id
          article_id: rest.article_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deprecated202007deleteblogsparamblogidarticlesparamarticleid
        description: Shopify Deletes An Article
        call: shopify-article.deprecated202007deleteblogsparamblogidarticlesparamarticleid
        with:
          blog_id: rest.blog_id
          article_id: rest.article_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin/api/2020-10/articles/authors-json
      name: admin-api-2020-10-articles-authors-json
      description: REST surface for admin-api-2020-10-articles-authors.json.
      operations:
      - method: GET
        name: getarticlesauthors
        description: Shopify Retrieves A List All Of Article Authors
        call: shopify-article.getarticlesauthors
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin/api/2020-10/blogs/{blog-id}/articles-json
      name: admin-api-2020-10-blogs-blog-id-articles-json
      description: REST surface for admin-api-2020-10-blogs-blog_id-articles.json.
      operations:
      - method: POST
        name: createblogsparamblogidarticles
        description: Shopify Creates An Article For A Blog
        call: shopify-article.createblogsparamblogidarticles
        with:
          blog_id: rest.blog_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin/api/2020-10/blogs/{blog-id}/articles/article-id-json
      name: admin-api-2020-10-blogs-blog-id-articles-article-id-json
      description: REST surface for admin-api-2020-10-blogs-blog_id-articles-article_id}.json.
      operations:
      - method: GET
        name: getblogsparamblogidarticlesparamarticleid
        description: Shopify Retrieves A Single Article
        call: shopify-article.getblogsparamblogidarticlesparamarticleid
        with:
          blog_id: rest.blog_id
          article_id: rest.article_id
          fields: rest.fields
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: updateblogsparamblogidarticlesparamarticleid
        description: Shopify Updates An Article
        call: shopify-article.updateblogsparamblogidarticlesparamarticleid
        with:
          blog_id: rest.blog_id
          article_id: rest.article_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deleteblogsparamblogidarticlesparamarticleid
        description: Shopify Deletes An Article
        call: shopify-article.deleteblogsparamblogidarticlesparamarticleid
        with:
          blog_id: rest.blog_id
          article_id: rest.article_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin/api/2021-01/articles/authors-json
      name: admin-api-2021-01-articles-authors-json
      description: REST surface for admin-api-2021-01-articles-authors.json.
      operations:
      - method: GET
        name: deprecated202101getarticlesauthors
        description: Shopify Retrieves A List All Of Article Authors
        call: shopify-article.deprecated202101getarticlesauthors
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin/api/2021-01/blogs/{blog-id}/articles-json
      name: admin-api-2021-01-blogs-blog-id-articles-json
      description: REST surface for admin-api-2021-01-blogs-blog_id-articles.json.
      operations:
      - method: POST
        name: deprecated202101createblogsparamblogidarticles
        description: Shopify Creates An Article For A Blog
        call: shopify-article.deprecated202101createblogsparamblogidarticles
        with:
          blog_id: rest.blog_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin/api/2021-01/blogs/{blog-id}/articles/article-id-json
      name: admin-api-2021-01-blogs-blog-id-articles-article-id-json
      description: REST surface for admin-api-2021-01-blogs-blog_id-articles-article_id}.json.
      operations:
      - method: GET
        name: deprecated202101getblogsparamblogidarticlesparamarticleid
        description: Shopify Retrieves A Single Article
        call: shopify-article.deprecated202101getblogsparamblogidarticlesparamarticleid
        with:
          blog_id: rest.blog_id
          article_id: rest.article_id
          fields: rest.fields
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: deprecated202101updateblogsparamblogidarticlesparamarticleid
        description: Shopify Updates An Article
        call: shopify-article.deprecated202101updateblogsparamblogidarticlesparamarticleid
        with:
          blog_id: rest.blog_id
          article_id: rest.article_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deprecated202101deleteblogsparamblogidarticlesparamarticleid
        description: Shopify Deletes An Article
        call: shopify-article.deprecated202101deleteblogsparamblogidarticlesparamarticleid
        with:
          blog_id: rest.blog_id
          article_id: rest.article_id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin/api/unstable/articles/authors-json
      name: admin-api-unstable-articles-authors-json
      description: REST surface for admin-api-unstable-articles-authors.json.
      operations:
      - method: GET
        name: deprecatedunstablegetarticlesauthors
        description: Shopify Retrieves A List All Of Article Authors
        call: shopify-article.deprecatedunstablegetarticlesauthors
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin/api/unstable/blogs/{blog-id}/articles-json
      name: admin-api-unstable-blogs-blog-id-articles-json
      description: REST surface for admin-api-unstable-blogs-blog_id-articles.json.
      operations:
      - method: POST
        name: deprecatedunstablecreateblogsparamblogidarticles
        description: Shopify Creates An Article For A Blog
        call: shopify-article.deprecatedunstablecreateblogsparamblogidarticles
        with:
          blog_id: rest.blog_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/admin/api/unstable/blogs/{blog-id}/articles/article-id-json
      name: admin-api-unstable-blogs-blog-id-articles-article-id-json
      description: REST surface for admin-api-unstable-blogs-blog_id-articles-article_id}.json.
      operations:
      - method: GET
        name: deprecatedunstablegetblogsparamblogidarticlesparamarticleid
        description: Shopify Retrieves A Single Article
        call: shopify-article.deprecatedunstablegetblogsparamblogidarticlesparamarticleid
        with:
          blog_id: rest.blog_id
          article_id: rest.article_id
          fields: rest.fields
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: deprecatedunstableupdateblogsparamblogidarticlesparamarticleid
        description: Shopify Updates An Article
        call: shopify-article.deprecatedunstableupdateblogsparamblogidarticlesparamarticleid
        with:
          blog_id: rest.blog_id
          article_id: rest.article_id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deprecatedunstabledeleteblogsparamblogidarticlesparamarticleid
        description: Shopify Deletes An Article
        call: shopify-article.deprecatedunstabledeleteblogsparamblogidarticlesparamarticleid
        with:
          blog_id: rest.blog_id
          article_id: rest.article_id
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: shopify-article-mcp
    port: 9090
    transport: http
    description: MCP adapter for Shopify  API — Article. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: shopify-retrieves-list-all-article
      description: Shopify Retrieves A List All Of Article Authors
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: shopify-article.deprecated202001getarticlesauthors
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-creates-article-blog
      description: Shopify Creates An Article For A Blog
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: shopify-article.deprecated202001createblogsparamblogidarticles
      with:
        blog_id: tools.blog_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-retrieves-single-article
      description: Shopify Retrieves A Single Article
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: shopify-article.deprecated202001getblogsparamblogidarticlesparamarticleid
      with:
        blog_id: tools.blog_id
        article_id: tools.article_id
        fields: tools.fields
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-updates-article
      description: Shopify Updates An Article
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: shopify-article.deprecated202001updateblogsparamblogidarticlesparamarticleid
      with:
        blog_id: tools.blog_id
        article_id: tools.article_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-deletes-article
      description: Shopify Deletes An Article
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: shopify-article.deprecated202001deleteblogsparamblogidarticlesparamarticleid
      with:
        blog_id: tools.blog_id
        article_id: tools.article_id
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-creates-comment-article
      description: Shopify Creates A Comment For An Article
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: shopify-article.deprecated202001createcomments
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-updates-comment-article
      description: Shopify Updates A Comment Of An Article
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: shopify-article.deprecated202001updatecommentsparamcommentid
      with:
        comment_id: tools.comment_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-retrieves-list-all-article-2
      description: Shopify Retrieves A List All Of Article Authors
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: shopify-article.deprecated202004getarticlesauthors
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-creates-article-blog-2
      description: Shopify Creates An Article For A Blog
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: shopify-article.deprecated202004createblogsparamblogidarticles
      with:
        blog_id: tools.blog_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-retrieves-single-article-2
      description: Shopify Retrieves A Single Article
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: shopify-article.deprecated202004getblogsparamblogidarticlesparamarticleid
      with:
        blog_id: tools.blog_id
        article_id: tools.article_id
        fields: tools.fields
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-updates-article-2
      description: Shopify Updates An Article
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: shopify-article.deprecated202004updateblogsparamblogidarticlesparamarticleid
      with:
        blog_id: tools.blog_id
        article_id: tools.article_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-deletes-article-2
      description: Shopify Deletes An Article
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: shopify-article.deprecated202004deleteblogsparamblogidarticlesparamarticleid
      with:
        blog_id: tools.blog_id
        article_id: tools.article_id
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-retrieves-list-all-article-3
      description: Shopify Retrieves A List All Of Article Authors
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: shopify-article.deprecated202007getarticlesauthors
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-creates-article-blog-3
      description: Shopify Creates An Article For A Blog
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: shopify-article.deprecated202007createblogsparamblogidarticles
      with:
        blog_id: tools.blog_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-retrieves-single-article-3
      description: Shopify Retrieves A Single Article
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: shopify-article.deprecated202007getblogsparamblogidarticlesparamarticleid
      with:
        blog_id: tools.blog_id
        article_id: tools.article_id
        fields: tools.fields
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-updates-article-3
      description: Shopify Updates An Article
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: shopify-article.deprecated202007updateblogsparamblogidarticlesparamarticleid
      with:
        blog_id: tools.blog_id
        article_id: tools.article_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-deletes-article-3
      description: Shopify Deletes An Article
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: shopify-article.deprecated202007deleteblogsparamblogidarticlesparamarticleid
      with:
        blog_id: tools.blog_id
        article_id: tools.article_id
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-retrieves-list-all-article-4
      description: Shopify Retrieves A List All Of Article Authors
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: shopify-article.getarticlesauthors
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-creates-article-blog-4
      description: Shopify Creates An Article For A Blog
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: shopify-article.createblogsparamblogidarticles
      with:
        blog_id: tools.blog_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-retrieves-single-article-4
      description: Shopify Retrieves A Single Article
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: shopify-article.getblogsparamblogidarticlesparamarticleid
      with:
        blog_id: tools.blog_id
        article_id: tools.article_id
        fields: tools.fields
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-updates-article-4
      description: Shopify Updates An Article
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: shopify-article.updateblogsparamblogidarticlesparamarticleid
      with:
        blog_id: tools.blog_id
        article_id: tools.article_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-deletes-article-4
      description: Shopify Deletes An Article
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: shopify-article.deleteblogsparamblogidarticlesparamarticleid
      with:
        blog_id: tools.blog_id
        article_id: tools.article_id
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-retrieves-list-all-article-5
      description: Shopify Retrieves A List All Of Article Authors
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: shopify-article.deprecated202101getarticlesauthors
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-creates-article-blog-5
      description: Shopify Creates An Article For A Blog
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: shopify-article.deprecated202101createblogsparamblogidarticles
      with:
        blog_id: tools.blog_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-retrieves-single-article-5
      description: Shopify Retrieves A Single Article
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: shopify-article.deprecated202101getblogsparamblogidarticlesparamarticleid
      with:
        blog_id: tools.blog_id
        article_id: tools.article_id
        fields: tools.fields
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-updates-article-5
      description: Shopify Updates An Article
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: shopify-article.deprecated202101updateblogsparamblogidarticlesparamarticleid
      with:
        blog_id: tools.blog_id
        article_id: tools.article_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-deletes-article-5
      description: Shopify Deletes An Article
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: shopify-article.deprecated202101deleteblogsparamblogidarticlesparamarticleid
      with:
        blog_id: tools.blog_id
        article_id: tools.article_id
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-retrieves-list-all-article-6
      description: Shopify Retrieves A List All Of Article Authors
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: shopify-article.deprecatedunstablegetarticlesauthors
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-creates-article-blog-6
      description: Shopify Creates An Article For A Blog
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: shopify-article.deprecatedunstablecreateblogsparamblogidarticles
      with:
        blog_id: tools.blog_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-retrieves-single-article-6
      description: Shopify Retrieves A Single Article
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: shopify-article.deprecatedunstablegetblogsparamblogidarticlesparamarticleid
      with:
        blog_id: tools.blog_id
        article_id: tools.article_id
        fields: tools.fields
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-updates-article-6
      description: Shopify Updates An Article
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: shopify-article.deprecatedunstableupdateblogsparamblogidarticlesparamarticleid
      with:
        blog_id: tools.blog_id
        article_id: tools.article_id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: shopify-deletes-article-6
      description: Shopify Deletes An Article
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: shopify-article.deprecatedunstabledeleteblogsparamblogidarticlesparamarticleid
      with:
        blog_id: tools.blog_id
        article_id: tools.article_id
      outputParameters:
      - type: object
        mapping: $.