Get Latest Version Of Article.

Overview

  • This API allows user to get the latest version of an article.

Permissions

  • If user has only 'Edit Article' permission on the parent folder or 'View Folder' permission.
    • If the requested article is check out by someone else, the user sees the latest checked-in version.
    • If the requested article is check out by the same user (requesting user), he will get the checkout version.

Response attributes

  • If $attribute is not passed in query parameter, summary attributes are returned in response.
  • If $attribute is passed in query parameter, then response body contains the summary attributes and additional attributes requested.
SecurityoAuthUser or oAuthClient
Request
path Parameters
ID
required
string

The comma separated Ids of the articles on which operation is performed. Both numeric and alternate Ids formats are supported for article Id.

Examples:
Providing readable article ids.
PROD-2268,PROD-2269
Providing numeric article ids.
202200000002268,202200000002269
query Parameters
$attribute
string

article attributes to be returned. comma separated input

Enum: "id" "lastModified" "created" "suggestionState" "folder" "lock" "language" "attachments" "name" "versionNumber" "articleState" "availabilityDate" "expirationDate" "description" "keywords" "summary" "additionalInfo" "content" "label" "imageUrl" "translationStatus" "department" "articleType" "notes" "relatedQuestions" "macro" "linkAlias" "availableEditions" "path" "personalization" "classification" "suggestionResolutionCode" "currentReviewStage" "previousReviewStage" "currentWorkflow" "ownedBy" "lockedBy" "expiryDateTimeZone" "availabilityDateTimeZone" "returnArticleStateInfo" "all"
expandMacros
string

This is an optional query parameter. Allowed values are 'yes' or 'no'. If 'expandMacros=yes', then it will expand all the macros in the result.

Enum: "no" "yes"
Example: expandMacros=no
$lang
string

The knowledge base language used for retrieving the response. This must be a language that is made available to the user. If this parameter is not passed, then the default language of the system is used.

Enum: "en-US" "en-GB" "fr-FR" "fi-FI" "es-ES" "it-IT" "de-DE" "nl-NL" "pt-BR" "pt-PT" "da-DA" "ru-RU" "zh-CN" "sv-SE" "no-NB" "no-NN" "zh-TW" "tr-TR" "pl-PL" "cs-CS" "hu-HU" "ar-SA" "ro-RO" "ja-JA" "ko-KO" "el-EL" "xx-XX"
Example: $lang=en-US
$pagenum
string

Pagination parameter that specifies the page number of results to be returned. Used in conjunction with $pagesize.
Default value: 1

$pagesize
string

Pagination parameter that specifies the number of results per page. Used in conjunction with $pagenum.
Default value: 10

Responses
200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal server error

get/articles/{ID}/latest
Request samples
Response samples
application/json
{
  • "link": {
    },
  • "paginationInfo": {
    },
  • "article": [
    ],
  • "count": 1
}