Update a published article

Updating and publishing an article with API allows you to automate the authoring process. Three steps are involved in updating an article:

1. Fork the article

2. Update the article content

3. Publish the article

Fork the article

1. Under v2, expand Articles → {article Id} and click Forks an article with an ID

2. In the Params tab, you can find the Path variables section

3. In the 'Value' field of articleId, paste the desired article id
   

4. Navigate to the Body tab in the main window

5. You can find the below parameters:

   • lang_code - Add the desired language code. Language code is filled as 'en' by default

   • user_id - Add the desired user id

   • version_number - Add the desired version number you want to fork

   For example, If you want to create an article version by forking version 3, mention the 'version_number' as 3

   How to find the versions of an article?

   a. Under v2, expand Articles → {article Id} → {lang Code} → versions and click Get all article versions
   b. In the Params tab, you can find the Path variables section
   c. In the 'Value' field of articleId and langCode, enter the desired article id and language code
   d. Click Send
   e. All the versions of that article appears in the Response section

6. Click Send and the desired article version is created

Update the article

1. Under v2, expand Articles → {article Id} → {lang Code} → settings and click Updates an article with the ID

2. In the Params tab, you can find the Path variables section

3. In the 'Value' field of articleId, paste the desired article id

4. In the 'Value' field of langCode, type in the desired language code. Language code is filled as 'en' by default
   

5. Navigate to the Body tab in the main window

6. You can find the below parameters:
   title, content/html_content, category_id, and version_number are mandatory parameters.

   • title - Add the desired article title

   • content - Add the desired article markdown content. If the editor type is Markdown, update here. If the article is in the WYSIWYG editor, remove this parameter.

   • html_content - Add the desired HTML content. If the editor type is WYSIWYG, update here. If the article is in the Markdown editor, remove this parameter.

   • category_id - Paste the desired category id

   • hidden - Hide/Show article

   • version_number - Add the desired article version you want to update

   • translation_option - Mention the translation status of the article. 0 - None, 1 - Needs translation, 2 - Translated

   • source - Mention any free text. It can be used for future reference

8. Click Send

9. The article changes are updated successfully. You can verify this with the 200 OK status and success parameter value as true

Publish the article

To publish an article, you need the following values:

1. Article id

2. User id

1. Under v2, expand Articles → {article Id} and click Publishes an article with an id

2. In the Params tab, you can find the Path variables section

3. In the 'Value' field of articleId, paste the desired article id
    

4. Navigate to the Body tab in the main window

5. You can find the below parameters:

   • 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

6. Click Send

7. The desired article is published successfully. You can verify this with the 200 OK status and success parameter value as true