Posting an article using the API

This section details how to post an article to Fuse using a HTTP POST request. You might compose an article and post it to a community. For example, you might write an article about invoice best practices and share it with your organisation's Finance community.

Making knowledge more accessible and discoverable is at the heart of Fuse's philosophy. For recommendations and tips on how to make the knowledge within your content more accessible and easily discoverable, see

Creating accessible content within Fuse.

Embedding external content (e.g. Google files) in Fuse articles.

Resource URL:

https://<instance_name>.fuseuniversal.com/api/v4.4/contents/article

Request

Request Header Parameters

Authorisation is required.

Request Parameters

The following parameters are mandatory when posting an article Fuse:

name: The title of the article.
description: The description of the article.
community_ids: The IDs of the communities where the article will be available.
body: The main body of the article, such as the HTML and text.

Please use the request examples as reference.

Response

The response for this API endpoint contains the new content ID that was created. Security sensitive fields may not be returned in the response.

The Fuse Content ID is automatically generated by the system on content creation. It cannot be changed. All other content attributes can be changed/updated.

Please refer to the Response Codes page for more information.

Example requests

Request URL example:

CODE

https://<instance_name>.fuseuniversal.com/api/v4.4/contents/article?auth_token=<valid_auth_token>

Request body example (basic article body):

JSON

{
    "name": "API content",
    "description": "Created With API",
    "composite_attributes": {
        "body": "This is a body of an article posted with the API"
    },
    "community_ids": [<valid_community_id>]
}

Request body example (embed video in article body):

JSON

{
    "name": "Embed Video Via API",
    "description": "Added via api",
    "composite_attributes": {
        "body": "<iframe width=\"560\" height=\"315\" src=\"https://www.youtube.com/embed/AWvdpouEl0w\" title=\"YouTube video player\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture\" allowfullscreen></iframe>"
    },
    "community_ids": [<valid_community_id>]
}

Request body example (Embed multiple videos in article body):

JSON

{
    "name": "Embed Video Via API",
    "description": "Added via api",
    "composite_attributes": {
        "body": "<iframe width=\"560\" height=\"315\" src=\"https://www.youtube.com/embed/AWvdpouEl0w\" title=\"YouTube video player\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture\" allowfullscreen></iframe><iframe width=\"560\" height=\"315\" src=\"https://www.youtube.com/embed/vJmQUy6lV2c\" title=\"YouTube video player\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture\" allowfullscreen></iframe><iframe width=\"560\" height=\"315\" src=\"https://www.youtube.com/embed/_NYgl-qzYPI\" title=\"YouTube video player\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture\" allowfullscreen></iframe>"
    },
    "community_ids": [
        <valid_community_id>
    ]
}

Request body example (HTML in article body):

JSON

{
    "name": "Acer SpatialLabs™ View/Pro RMA solution (Qisda DS1) NEW",
    "description": "added via api",
    "composite_attributes": {
        "body": "<h1><span style=\"font-size: 24px;\">Monthly CSD Report</span></h1><table border=\"1\" cellpadding=\"1\" cellspacing=\"1\" style=\"width: 900px;\"><tbody id=\"technical_news_table\"><tr><td style=\"width: 240px; text-align: center;\"><div class=\"info\"><span style=\"font-size:20px;\">Update Date</span></div></td><td style=\"width: 544px; text-align: center;\"><div class=\"info\"><span style=\"font-size:20px;\">Subject</span></div></td><td style=\"text-align: center; width: 128px;\"><div class=\"info\"><span style=\"font-size:20px;\">Version</span></div></td><td style=\"width: 138px; text-align: center;\"><div class=\"info\"><span style=\"font-size:20px;\">Owner</span></div></td><td style=\"width: 89px; text-align: center;\"> <div class=\"info\"><span style=\"font-size:20px;\">Link</span></div></td></tr><tr><td style=\"text-align: center; width: 240px;\">2020/05/22</td><td style=\"width: 544px;\">2020 Jan. CSD Monthly Report</td><td style=\"width: 128px; text-align: center;\">V0.1</td><td style=\"width: 138px; text-align: center;\">Vivian Lo</td><td style=\"width: 89px; text-align: center;\"><a href=https://dzf8vqv24eqhg.cloudfront.net/userfiles/14618/18978/ckfinder/files/PAPcsd012020.pdf>Link</a></td></tr><tr><td style=\"width: 240px; text-align: center;\">2020/05/22</td><td style=\"width: 544px;\">2020 Feb. CSD Monthly Report</td><td style=\"width: 128px; text-align: center;\">V0.1</td><td style=\"width: 138px; text-align: center;\">Vivian Lo</td><td style=\"width: 89px; text-align: center;\"><a href=https://dzf8vqv24eqhg.cloudfront.net/userfiles/14618/18978/ckfinder/files/PAPcsd022020.pdf>Link</a></td></tr><tr><td style=\"text-align: center; width: 240px;\">2020/05/22</td><td style=\"width: 544px;\">2020 Mar. CSD Monthly Report</td><td style=\"width: 128px; text-align: center;\">V0.1</td><td style=\"width: 138px; text-align: center;\">Vivian Lo</td><td style=\"width: 89px; text-align: center;\"><p><a href=https: //dzf8vqv24eqhg.cloudfront.net/userfiles/14618/18978/ckfinder/files/PAPcsd032020.pdf>Link</a></p></td></tr>"
    },
    "community_ids": [
        <valid_community_id>
    ]
}