Creating new articles is one of the actions you would often perform in Document360. Creating and publishing multiple articles with API allows you to automate the authoring process.

You can create articles in any version. You are not restricted to only one version.

For example, you can create 2 articles in a category present in the V1 version and 3 articles in another category in the V2 version at the same time.

Publishing articles in this method can be done much faster and easier. Publishing each article separately will require more effort.


Basic requirements for creating articles

To create an article, you need the below values:

  • Project version id
  • Category id
  • User id

Get Project version id

1_Screenshot-Gets_list_of_project_versions

  1. Under Document360 Customer API, expand v2 → Project Versions
  2. Click Gets list of project versions → Send
    This action will display all the versions available in the project
  3. Copy the desired project version id available next to the 'id' property and paste it into notepad or the preferred space

Get Category id

2_Screenshot-Gets_list_of_categories

  1. Under Project Versions, expand {project Version Id} and click Get the list of categories within project version
  2. In the Params tab, you can find the Path Variables section
  3. In the 'Value' field of projectVersionId, paste the project id copied in step 3 and click Send
    This action will display all the categories in the desired version
  4. Copy the desired category id available next to the 'id' property and paste it into notepad or the preferred space

Get User id

3_Screenshot-Gets_list_of_team accounts

  1. Under v2, expand Teams and click Get all team accounts → Send
    This action will display all the team accounts in the project.
  2. Copy the desired user id available next to the 'id' property and paste it into notepad or the preferred space

Create multiple articles

1_Screenshot-Create_bulk_articles

  1. Under v2, expand Articles and click Adds multiple articles
  2. Navigate to the Body tab in the main window

The properties inside a JSON object '{}' apply to one article.

  1. By default, the properties for two sample articles are available. To add more articles, copy the object with article properties, and paste them the desired number of times at the bottom of the object

For example, If you want to create five more articles, copy the object with the article properties and paste them five times.

  • When you paste at the bottom of the section, ensure that you paste it before close bracket ']'
  • Ensure that you add a comma ',' next to all the close brace '}'
  1. Update all the properties available in the object:
    • category_id - Paste the desired category id
    • project_version_id - Paste the desired project version id
    • title - Add the desired article title
    • user_id - Paste the desired user id
    • content - Add the desired article content
    • order - Specify the desired position of the article in the category. Enter the previous number of the desired position

      For example, If you want the new article to appear as the first in the category, enter the order property value as 0.
      If you wish for the new article to appear as the fifth article in the category, enter the order property value as 4.

You can add articles into different categories and project versions. You are not restricted to articles within only one category or version.

  1. Click Send
  2. The new articles are created successfully. You can verify this with the 200 OK status and success property value as true
  3. Copy all article id's available next to the 'id' property and paste them into notepad or preferred space

Publish multiple articles

To publish multiple articles, you need the following values:

  • Article id
  • User id

Follow the below steps to publish multiple articles:
2_Screenshot-Publish_bulk_articles

  1. Under v2, expand Articles and click Publishes multiple articles
  2. Navigate to the Body tab in the main window

The properties inside a JSON object '{}' apply to one article.

  1. By default, the properties for two sample articles are available. To publish more articles, copy the properties with the braces, and paste them the desired number of times at the bottom of the object

For example, If you want to publish five more articles, copy the article properties with braces and paste them five times.

  • When you paste at the bottom of the object, ensure that you paste it before close bracket ']'
  • Ensure that you add a comma ',' next to all the close brace '}'
  1. You can find the below properties:
    • article_id - Paste the desired article id
    • user_id - Paste the desired user id
    • version_number - Add the desired article version number
    • publish_message - Add the desired publish message for the article
  2. Click Send
  3. The desired articles are published successfully. You can verify this with the 200 OK status and success property value as true