Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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.

Note

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.

Info

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.

Note

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.

Info

Please refer to the Response Codes page for more information.

...

Example requests

...

REQUEST

...

URL EXAMPLE:

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

REQUEST BODY EXAMPLE - BASIC ARTICLE BODY:

Code Block
languagejson
{
    "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:

Code Block
languagejson
{
    "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 BOD EXAMPLE: EMBED MULTIPLE VIDEOS ARTICLE BODY:

Code Block
languagejson
{
    "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:

Code Block
languagejson
{
    "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>
    ]
}

...