Update article settings
  • Updated on 05 Apr 2019
  • 2 minutes to read
  • Contributors
  • Print
  • Share
  • Dark
    Light

Update article settings

  • Print
  • Share
  • Dark
    Light

PUT/articles/{ID}/settings

Updates settings for the article


Header

Parameter Type Description
api_token string REST API key you can get it from Settings > API.

Route Parameters

Parameters highlighted in bold are mandatory

Parameter Type Description
ID string ID of the article

Body Parameters

Parameters highlighted in bold are mandatory

Parameter Type Description
slug string The slug of the article
seo_title string The seo title of the article
description string The description of the article
allow_comments boolean Disable / Enable internal commenting on the article
show_table_of_contents boolean Disable / Enable article table of the contents on the knowledge base
featured_image_url string The url of the image that will be used as a featured image
tags string[] Custom article tags
status_indicator int User site article status 0 - none, 1 - new, 2 - updated
status_indicator_expiry_date datetime The date time when the public article status is removed
exclude_from_search boolean Exclude article from search results on knowledge base
related_articles string[] list of related article ids to show on knowledge base

Sample Request

{
    "slug": "New API Documentation",
    "seo_title": "API Documentation",
    "allow_comments": true,
    "show_table_of_contents": true,
    "tags": [
        "API",
        "Demo",
        "Hello"
    ],
    "related_articles": ["ccc1ae8-0cda-4886-9f73-e98f3d8cc737", "bb1a1ae8-0cda-4886-9f73-e98f3d8cc737"]
}

Response

{
    "data": {
        "slug": "new-api-documentation",
        "seo_title": "API Documentation",
        "description": "",
        "allow_comments": true,
        "show_table_of_contents": true,
        "featured_image_url": null,
        "tags": [
            "API",
            "Demo",
            "Hello"
        ],
        "status_indicator": 0,
        "status_indicator_expiry_date": null,
        "exclude_from_search": false,
        "related_articles": [
            {
                "id": "bb1a1ae8-0cda-4886-9f73-e98f3d8cc737",
                "title": "Welcome !",
                "hidden": false,
                "slug": "welcome"
            },
            {
                "id": "ccc1ae8-0cda-4886-9f73-e98f3d8cc737",
                "title": "API Core",
                "hidden": false,
                "slug": "api-core"
            }
        ]
    },
    "extension_data": null,
    "context": null,
    "success": true,
    "errors": [],
    "warnings": [],
    "information": []
}

Response Sample

Parameter Type Description
slug string The slug of the article
seo_title string The seo title of the article
description string The description of the article
allow_comments boolean Disable / Enable internal commenting on the article
show_table_of_contents boolean Disable / Enable article table of the contents on the knowledge base
featured_image_url string The url of the image that will be used as a featured image
tags string[] Custom article tags
status_indicator enumerated User site article status 0 - none, 1 - new, 2 - updated
status_indicator_expiry_date datetime The date time when the public article status is removed
exclude_from_search boolean Exclude article from search results on knowledge base
related_articles object[] list of articles related to this visible on knowledge base

Response > related_articles

Parameter Type Description
id string Article id
title string Article title
hidden boolean Article visibility status
slug string Article slug
Was this article helpful?