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
| 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 REQUEST
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 | ||
|---|---|---|
| ||
{
"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 a Video in an ArticleREQUEST BODY EXAMPLE - EMBED VIDEO IN ARTICLE BODY:
| Code Block | ||
|---|---|---|
| ||
{
"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) Video’s in an ArticleREQUEST BOD EXAMPLE: EMBED MULTIPLE VIDEOS ARTICLE BODY:
| Code Block | ||
|---|---|---|
| ||
{
"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 to ArticleREQUEST BODY EXAMPLE - HTML IN ARTICLE BODY:
| Code Block | ||
|---|---|---|
| ||
{
"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>
]
} |
