Posting an article using the API (v5 and above)

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/v5.0/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.

Example requests

Request URL example:

https://<instance_name>.fuseuniversal.com/api/v5.0/contents/article

Request body example (basic article body):

{
    "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):

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

Wiki