Finding an Article ID

An article ID (GUID) references a specific article, including all translated versions of an article. The ID is useful if you are linking from a product that is translated into many languages, and you need a way to keep track of all articles related to your product. Article IDs are necessary when working with article APIs.

To find an article ID:

  1. Go to the live URL of the relevant article.
  2. Click the Toolbar Expand Tab at the top left.
    Note: To see this option, make sure you are logged in as a team member.
  1. Click Manage this article in the Team Member Toolbar.
  2. The article ID appears in the article URL following 'article':
    For example: https://[your-subdomain-name].wixanswers.com/app/hc/article/article-id/

Related Articles

Articles APIs

Articles are documents containing text, images, and videos that provide information to your users. Articles are categorized using categories, subcategories, and labels. There are three types of articles: (regular) articles, feature requests, and known issues. Users can follow articles and vote for feature requests. Agents can add notes and tasks to articles, such as "review", and assign them to other agents.You can use the Articles API to manage your articles (including feature requests, known issues, and videos). Categories and labels are manged by other APIs.Importing RecordsYou can contact Wix Answers to enable administrators to import articles in bulk.An article starts as a draft until you publish it. The draft and all previously published drafts are the article versions. When you publish a draft, Wix Answers marks the draft version as published, makes the version visible in the Help Center, and automatically creates a new draft.In the Wix Answers App, the option to publish the draft appears only when there is a difference between the draft and the most recently published version.NoteSee Common Elements in API Payloads / Objects, including the note about undocumented parameters.Get Article or Article InformationThese methods enable you to manipulate a single article.Get Article by IDGET https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}?locale={locale} Get an article by its GUID and locale. See Finding an Article ID. Authorization: None Content type: application/json; charset=utf-8. Accept: application/json. Response: Article Object (public level)Request ParamsDescriptionTypeRequiredlocale Article languageTwo-letter country code string (for example: 'de')✓defaultLocaleFallbackWhether to get the article associated with the default locale if no article exists for the specified locale.Boolean. Default is false.Request Example:GET https://<tenant_subdomain>.wixanswers.com/api/v1/articles/bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fa?locale=enRequest Example Using curl:curl -X GET https://<tenant_subdomain>.wixanswers.com/api/v1/articles/bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fa?locale=en -H 'Content-Type: application/json; charset=utf-8' -H 'Authorization: Bearer <token>'Get Extended Article InformationGET https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/extended?locale={locale} Get extended information about an article by its GUID and locale, including task information, agent information, and so forth. See Finding an Article ID. Authorization: Requires agent authorization token and permission FETCH_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: Article Object (extended level)Request ParamsDescriptionTypeRequiredlocale Article languageTwo-letter country code string (for example: 'de')✓Request Example:GET https://<tenant_subdomain>.wixanswers.com/api/v1/articles/bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fa/extended?locale=enGet Article by URIGET https://<tenant_subdomain>.wixanswers.com/api/v1/articles/uri/{URI}?locale={locale} Get an article by its URI and locale. Authorization: None Content type: application/json; charset=utf-8. Accept: application/json. Response: Article Object (public level)Request ParamsDescriptionTypeRequiredlocaleArticle languageTwo-letter country code string (for example: 'de')✓Request Example:GET https://<tenant_subdomain>.wixanswers.com/api/v1/articles/uri/machines-1?locale=enGet Article PreviewGET https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/preview?locale={locale} Get an article with only its latest data by its GUID and locale. The data comes from the draft; the draft's data may or may not be different from the most recently published version's data. See Finding an Article ID. Authorization: Requires agent authorization token and permission CREATE_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: Article Object (restricted level)Request ParamsDescriptionTypeRequiredlocale Article languageTwo-letter country code string (for example: 'de')✓Request Example:GET https://<tenant_subdomain>.wixanswers.com/api/v1/articles/bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fa/preview?locale=enGet List of Article VersionsGET https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/versions?locale={locale} Get a list of article versions, including the draft version and all previously published versions. Authorization: Requires agent authorization token and permission FETCH_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: List of ArticleVersion objects (restricted level)Request ParamsDescriptionTypeRequiredlocale Article languageTwo-letter country code string (for example: 'de')✓Request Example:GET https://<tenant_subdomain>.wixanswers.com/api/v1/articles/bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fa/versions?locale=enAdd ArticlePOST https://<tenant_subdomain>.wixanswers.com/api/v1/articles Create a new article. Authorization: Requires agent authorization token and permission CREATE_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: Article Object (restricted level)Payload ParamsDescriptionTypeRequiredlocale Article languageTwo-letter country code string (for example: 'de')✓categoryId CategoryTo add an article without a category, use  00000000-0000-0000-0000-000000000000 as the category ID.If a category has subcategories, you cannot associate the article with the category, only with one of its subcategories.GUID✓typeArticle TypeInteger✓title The article titleThe default is an empty string.StringThe default is an empty string.✓content  The article content (HTML)The default is an empty string.StringThe default is an empty string.status  Article StatusIntegerThe default is 0 (Draft).Payload Example:POST https://<tenant_subdomain>.wixanswers.com/api/v1/articles { "locale": "en", "categoryId": "bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fa", "type": 100, "status": 10, "title": "New App Article", "content": "<div>This is the article content</div>" }Request Example Using curl:curl -X POST https://<tenant_subdomain>.wixanswers.com/api/v1/articles -H 'Authorization: Bearer <token>' -H 'Content-Type: application/json; charset=utf-8' -H 'Accept: application/json' -d '{"locale": "en", "categoryId": "bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fa", "type": 100, "status": 10, "title": "New App Article", "content": "<div>This is the article content</div>"}Publish or Unpublish an ArticlePublish or unpublish a single article.Publish ArticlePOST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/publish Optionally update an article's title and content, and then publish the article. See Important Information about Updating Using the API. To just update the article, see Update Article Title and/or Content. Authorization: Requires agent authorization token and permission PUBLISH_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: Article Object (restricted level) The payload parameters are the same as those for Update Article.Request Example Using curl:curl -X POST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fa/publish -H 'Authorization: Bearer <token>' -H 'Content-Type: application/json; charset=utf-8' -H 'Accept: application/json' -d '{ "title": "Wix Answers - Articles APIs", "content": "<div>This is the article content</div>", "locale": "en", "notify": false }Unpublish ArticlePOST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/unpublish Unpublish a published article. Authorization: Requires agent authorization token and permission PUBLISH_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: Article Object (restricted level)Payload ParamsDescriptionTypeRequiredlocale Article languageTwo-letter country code string (for example: 'de')✓Payload Example:POST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fa/unpublish { "locale": "en" }Delete or Restore an ArticleDelete or restore a single article.Delete ArticleDELETE https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}?locale={locale} Delete a single article. The article can be restored (see Restore Deleted Article). To delete all articles in a category or subcategory, see Delete All Articles in a Category. Authorization: Requires agent authorization token and permission DELETE_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: NoneRequest ParamsDescriptionTypeRequiredlocale Article languageTwo-letter country code string (for example: 'de')✓Request Example:DELETE https://<tenant_subdomain>.wixanswers.com/api/v1/articles/bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fa?locale=enRestore Deleted ArticlePOST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/restore Restore a previously deleted article. Note that the ID of the article to restore is in the path. Authorization: Requires agent authorization token and permission CREATE_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: NonePayload ParamsDescriptionTypeRequiredlocale Article languageTwo-letter country code string (for example: 'de')✓Payload Example:POST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fa/restore { "locale": "en" }Merge ArticlesPOST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/merge Merge this article (the article whose GUID appears in the path) into another one. This article is removed. All followers and notes move to the target article. Authorization: Requires agent authorization token and permission CREATE_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: Article Object (restricted level)Payload ParamsDescriptionTypeRequiredlocale Article languageTwo-letter country code string (for example: 'de')✓targetIdThe article into which to merge this articleGUID✓updateCategoriesWhether to move the target article to be under the category of this article.Boolean. Default is false.Payload Example:POST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/e932c0a3-6e9b-43cf-b3a9-0ae790f6ee6a/merge { "locale": "en", "targetId": "bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fa" }Update Article or Article MetadataThese methods enable you to update metadata associated with an article.Update Article Title and/or ContentPUT https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID} Update an article's title and content. See Important Information about Updating Using the API. Also see Publish Article. Authorization: Requires agent authorization token and permission CREATE_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: Article Object (restricted level)Payload ParamsDescriptionTypeRequiredlocale Article languageTwo-letter country code string (for example: 'de')✓titleThe article titleTo not change the title, send the existing title. Otherwise, the title is changed to a blank string.StringcontentThe article content (HTML)To not change the content, send the existing content. Otherwise, the content is changed to a blank string.StringupdateUrlIf you updated the title, Wix Answers updates the article URI to match the new title. Any requests to the old URI are redirected to the new one.Set this to false to keep the old URI.BooleanDefault is true.notifyWhether to notify users who follow the article that the article was updated.BooleanDefault is false.Payload Example:PUT https://<tenant_subdomain>.wixanswers.com/api/v1/articles/bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fa { "title": "Wix Answers - Articles APIs", "content": "<div>This is the article content</div>", "locale": "en", "notify": false }Update Article CategoryPOST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/move Move an article to a different category. Also see Move All Articles from One Category to Another. If a category has subcategories, you cannot move an article to the category, only to one of its subcategories. Authorization: Requires agent authorization token and permission CREATE_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: NonePayload ParamsDescriptionTypeRequirednewCategoryIdNew categoryTo remove the category, use 00000000-0000-0000-0000-000000000000 as the category ID.GUIDPayload Example:POST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/e932c0a3-6e9b-43cf-b3a9-0ae790f6ee6a/move { "newCategoryId": "bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fa" }Update Article TypePOST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/changeType Change an article type, and optionally its resolution (for the recommended way to change the resolution, see Update Article Resolution). Authorization: Requires agent authorization token and permission CREATE_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: NonePayload ParamsDescriptionTypeRequiredtypeNew Article TypeInteger✓resolutionNew Article ResolutionIntegerPayload Example:POST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/e932c0a3-6e9b-43cf-b3a9-0ae790f6ee6a/changeType { "type": 110 }Update Article ResolutionPOST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/setResolution Change an article resolution. Authorization: Requires agent authorization token and permission CREATE_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: NonePayload ParamsDescriptionTypeRequiredresolutionNew Article ResolutionInteger✓localesList of articles language to set the resolutionList of two-letter country code strings (for example: ['de','en'])At least one is requirednotifyWhether to notify article followers about the change in resolutionBooleanDefault is true.Payload Example:POST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/e932c0a3-6e9b-43cf-b3a9-0ae790f6ee6a/setResolution { "resolution": 124, "locales": ["en"] }Update Article PhrasesPUT https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/phrases Change an article's phrases. These are keywords that are used for when searching for articles (see Search for Articles (Agent)). See Important Information about Updating Using the API. Authorization: Requires agent authorization token and permission CREATE_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: Article Object (restricted level)NoteCurrently, phrases do not appear, and cannot be managed, in the Help Center or the Wix Answers App. However, if phrases are attached to articles, they are used when searching in the Help Center or using the API.Payload ParamsDescriptionTypeRequiredlocaleArticle languageTwo-letter country code string (for example: 'de')✓textValuesList of phrasesList of strings✓Payload Example:PUT https://<tenant_subdomain>.wixanswers.com/api/v1/articles/e932c0a3-6e9b-43cf-b3a9-0ae790f6ee6a/phrases { "locale": "en", "textValues": ["programming", "JavaScript"] }Update Article LabelsPUT https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/labels Add or remove labels from an article. Authorization: Requires agent authorization token and permission CREATE_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: Article Object (restricted level)Payload ParamsDescriptionTypeRequiredlocale Article languageTwo-letter country code string (for example: 'de')✓addedLabelIdsList of labels to add to articleList of GUIDsremovedLabelIdsList of labels to remove from articleNote that if the same label appears in both the "add" and "remove" lists, it will remain in the article (labels are first removed, and then added).List of GUIDsPayload Example:PUT https://<tenant_subdomain>.wixanswers.com/api/v1/articles/e932c0a3-6e9b-43cf-b3a9-0ae790f6ee6a/labels { "locale": "en", "addedLabelIds": ["bd948e62-ee6a-a3fd-4cf0-87f30ae7f3fa","bd948e62-a3fd-ee6a-4cf0-87f30ae7f3fb"], "removedLabelIds": ["bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fc"] }Manage Article's Related ArticlesThese methods enable you to update related articles associated with an article.Add Article RelationPOST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/relations Add an article relation. The related article must be published. Authorization: Requires agent authorization token and permission CREATE_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: NonePayload ParamsDescriptionTypeRequiredlocale Article language for which to add the new relationsIf not sent, the related articles are added to the article in all locales.Two-letter country code string (for example: 'de')relatedIdThe published article to relate to this oneGUID✓Payload Example:POST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/e932c0a3-6e9b-43cf-b3a9-0ae790f6ee6a/relations { "locale": "en", "relatedId": "bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fa" }Get an Article's Related Articles (Guest)GET https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/relations?locale={locale} Get related articles for this article. See also Get an Article's Related Articles (Agent). Authorization: None Content type: application/json; charset=utf-8. Accept: application/json. Response: List of Article Objects (public level)Request ParamsDescriptionTypeRequiredlocale Article languageTwo-letter country code string (for example: 'de')✓Request Example:GET https://<tenant_subdomain>.wixanswers.com/api/v1/articles/bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fa/relations?locale=enGet an Article's Related Articles (Agent)GET https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/relations/admin?locale={locale} Get related articles for this article, including task information, agent information, and so forth. Authorization: Requires agent authorization token and permission FETCH_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: List of Article Objects (restricted level)Request ParamsDescriptionTypeRequiredlocale Article languageTwo-letter country code string (for example: 'de')✓Request Example:GET https://<tenant_subdomain>.wixanswers.com/api/v1/articles/bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fa/relations/admin?locale=enDelete Article RelationDELETE https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/relations/{related article GUID} Delete an article relation. Authorization: Requires agent authorization token and permission CREATE_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: NoneRequest ParamsDescriptionTypelocale Article language for which to remove the related articlesIf not sent, the related articles are removed from the article in all locales.Two-letter country code string (for example: 'de')Request Example:DELETE https://<tenant_subdomain>.wixanswers.com/api/v1/articles/bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fa/relations/bd948e62-ee6a-a3fd-4cf0-87f30ae7f3fbSort an Article's Related ArticlesPOST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/relations/sort For this article, sort list of related articles by their title, ascending. Related articles are normally sorted according to the order they were added. Authorization: Requires agent authorization token and permission CREATE_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: NonePayload ParamsDescriptionTypeRequiredlocaleArticle languageTwo-letter country code string (for example: 'de')✓relatedIdsRelated articles to sortList of GUIDs✓Payload Example:POST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/e932c0a3-6e9b-43cf-b3a9-0ae790f6ee6a/relations/sort { "relatedIds": ["bd948e62-ee6a-a3fd-4cf0-87f30ae7f3fa", "bd948e62-a3fd-ee6a-4cf0-87f30ae7f3fb"], "locale": "en" }Manage Article NotesThese methods enable you to update notes associated with an article.Add Article NotePOST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/notes Add article note. Authorization: Requires agent authorization token and permission CREATE_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: Note object (restricted level)Payload ParamsDescriptionTypeRequiredlocale Article languageTwo-letter country code string (for example: 'de')✓contentThe note contentString✓Payload Example:POST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/e932c0a3-6e9b-43cf-b3a9-0ae790f6ee6a/notes { "locale": "en", "content": "A note." }Get Article NoteGET https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/notes/{note GUID}?locale={locale} Get article note. For information about a GUID, see GUID. Authorization: Requires agent authorization token and permission FETCH_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: Note object (restricted level)Request ParamsDescriptionTypeRequiredlocale Article languageTwo-letter country code string (for example: 'de')✓Request Example:GET https://<tenant_subdomain>.wixanswers.com/api/v1/articles/bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fa/notes/bd948e62-ee6a-a3fd-4cf0-87f30ae7f3fb?locale=enGet All Article NotesGET https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/notes Get all notes of an article. Authorization: Requires agent authorization token and permission FETCH_ARTICLES Content type: application/json; charset=utf-8. Accept : application/json. Response: List of Note objects (restricted level)Payload ParamsDescriptionTypeRequiredlocale Article languageTwo-letter country code string (for example: 'de')✓Request Example:GET https://<tenant_subdomain>.wixanswers.com/api/v1/articles/bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fa/notes?locale=enUpdate Article NotePUT https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/notes/{note GUID} Update article note. See Important Information about Updating Using the API. Authorization: Requires agent authorization token and permission CREATE_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: NonePayload ParamsDescriptionTypeRequiredlocale Article languageTwo-letter country code string (for example: 'de')✓contentThe note contentString✓Payload Example:PUT https://<tenant_subdomain>.wixanswers.com/api/v1/articles/bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fa/notes/e932c0a3-6e9b-43cf-b3a9-0ae790f6ee6a { "locale": "en", "content": "A new note." }Delete Article NoteDELETE https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/notes/{note GUID}?locale={locale} Delete article note. Authorization: Requires agent authorization token and permission CREATE_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: NoneRequest ParamsDescriptionTypeRequiredlocale Article languageTwo-letter country code string (for example: 'de')✓Request Example:DELETE https://<tenant_subdomain>.wixanswers.com/api/v1/articles/bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fa/notes/bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fb?locale=enManage Article TasksThese methods enable you to update tasks associated with an article, as well notes associated with these tasks.Add Article TaskPOST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/tasks Add article task. Authorization: Requires agent authorization token and permission CREATE_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: ContentTask object (restricted level)Payload ParamsDescriptionTypeRequiredlocale Article languageTwo-letter country code string (for example: 'de')✓typeContent Task TypeInteger✓priorityContent Task PriorityInteger✓assignedGroupIdAgent group to which to assign this taskGUIDEither this or assignedUserId is required.assignedUserIdAgent to which to assign this taskGUIDEither this or assignedGroupId is required.descriptionTask descriptionStringPayload Example:POST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/e932c0a3-6e9b-43cf-b3a9-0ae790f6ee6a/tasks { "locale": "en", "type": 30, "priority": 20, "assignedUserId": "bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fa", "description": "Please review!" }Get Article Task InformationGET https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/tasks/{task GUID} Get information about an article task. Authorization: Requires agent authorization token and permission FETCH_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: ContentTask object (restricted level)Request Example:GET https://<tenant_subdomain>.wixanswers.com/api/v1/articles/bd948e62-a3fd-4cf0-ee6a-87f30ae7f3fa/tasks/bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fbGet All Article TasksGET https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/tasks?locale={locale} Get information about all article tasks. Authorization: Requires agent authorization token and permission FETCH_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: Structure including ContentTask objects (restricted level)Request ParamsDescriptionTypeRequiredlocale Article languageTwo-letter country code string (for example: 'de')✓pageThe page of results to returnIf not specified, the default is 1.IntegerpageSizeThe number of results to return on each pageIf not specified, the default is 20.IntegerRequest Example:GET https://<tenant_subdomain>.wixanswers.com/api/v1/articles/bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fa/tasks?locale=enResponse Example:{ "items": [ List of @ContentTask objects ], "itemsCount": 108, "page": 2, "numPages": 22, "previousPage": 1, "nextPage": 3, "pageSize": 5 }Get a Count of an Article's TasksGET https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/tasks/count Get the number of tasks attached to an article. You can filter by task status. Authorization: Requires agent authorization token and permission FETCH_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: IntegerRequest ParamsDescriptionTypeRequiredlocale Article languageTwo-letter country code string (for example: 'de')✓statusFilter by Content Task StatusIntegerAdd Article TranslationsPOST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/translations Add article translations and, by default, translation tasks for these translations. After creating a translation task, Wix Answer invokes the Article Sent to Translation webhook. Authorization: Requires agent authorization token and permission CREATE_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: NonePayload ParamsDescriptionTypeRequiredlocalesList of required Article languagesList of two-letter country code strings (for example: ['de','en'])At least one is requiredtaskPriorityContent Task PrioritiesIntegerDefault is 20.openTranslationTasksWhether to add translation tasks for the article translationsBooleanDefault is true.noteTextNote contentsStringPayload Example:POST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/e932c0a3-6e9b-43cf-b3a9-0ae790f6ee6a/translations { "locales": ["de"] }Update Article TaskPUT https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/tasks/{task GUID} Update article task. See Important Information about Updating Using the API. To mark a task as complete / open, see Complete Article Task or Open/Reopen Article Task. Authorization: Requires agent authorization token and permission CREATE_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: ContentTask object (restricted level)Payload ParamsDescriptionTypeRequiredpriorityContent Task PriorityInteger✓assignedGroupIdAgent group to which to assign this taskGUIDEither this or assignedUserId is required.assignedUserIdAgent to which to assign this taskGUIDEither this or assignedGroupId is required.descriptionTask descriptionStringPayload Example:PUT https://<tenant_subdomain>.wixanswers.com/api/v1/articles/e932c0a3-6e9b-43cf-b3a9-0ae790f6ee6a/tasks/d367738e-368e-41fe-9289-1a5cbbc3c239 { "priority": 20, "assignedUserId": "bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fa", "description": "Please review!" }Complete Article TaskPOST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/tasks/{task GUID}/complete Complete an article task. This updates the status, completion date, and "completed by user" fields of the task. Authorization: Requires agent authorization token and permission CREATE_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: ContentTask object (restricted level) No payload is required.Open/Reopen Article TaskPOST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/tasks/{task GUID}/open Open or reopen an article task. This updates the task's status. If the article was previously marked as complete, this does not change the completion date or "completed by user" fields of the task. Authorization: Requires agent authorization token and permission CREATE_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: ContentTask object (restricted level) No payload is required.Add Article Task NotePOST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/tasks/{task GUID}/notes Add note about article task. Authorization: Requires agent authorization token and permission CREATE_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: Note object (restricted level)Payload ParamsDescriptionTypeRequiredlocale Article languageTwo-letter country code string (for example: 'de')contentThe note contentString✓Payload Example:POST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/d367738e-368e-41fe-9289-1a5cbbc3c239/tasks/e932c0a3-6e9b-43cf-b3a9-0ae790f6ee6a/notes { "locale": "en", "content": "I will review." }Update Article Task NotePUT https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/tasks/{task GUID}/notes/{note GUID} Update note about article task. See Important Information about Updating Using the API. Authorization: Requires agent authorization token and permission CREATE_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: NonePayload ParamsDescriptionTypeRequiredlocale Article languageTwo-letter country code string (for example: 'de')✓contentThe note contentString✓Payload Example:PUT https://<tenant_subdomain>.wixanswers.com/api/v1/articles/e932c0a3-6e9b-43cf-b3a9-0ae790f6ee6a/tasks/bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fa/notes/d367738e-368e-41fe-9289-1a5cbbc3c239 { "locale": "en", "content": "I will review." }Delete Article Task NoteDELETE https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/tasks/{task GUID}/notes/{note GUID}?locale={locale} Delete note about article task. Authorization: Requires agent authorization token and permission CREATE_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: NoneRequest ParamsDescriptionTypeRequiredlocale Article languageTwo-letter country code string (for example: 'de')✓Request Example:DELETE https://<tenant_subdomain>.wixanswers.com/api/v1/articles/bd948e62-ee6a-a3fd-4cf0-87f30ae7f3fa/tasks/bd948e62-a3fd-4cf0-ee6a-87f30ae7f3fb/notes/bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fc?locale=enDelete an Article TaskDELETE https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/tasks/{task GUID}?locale={locale} Delete an article task. To delete multiple tasks, see Delete One or More Article Tasks. Authorization: Requires agent authorization token and permission CREATE_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: NoneRequest ParamsDescriptionTypeRequiredlocale Article languageTwo-letter country code string (for example: 'de')✓Request Example:DELETE https://<tenant_subdomain>.wixanswers.com/api/v1/articles/bd948e62-ee6a-a3fd-4cf0-87f30ae7f3fa/tasks/bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fb?locale=enDelete One or More Article TasksDELETE https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/tasks?locale={locale}&ids={task GUID},{task GUID},... Delete one or more tasks from an article. Authorization: Requires agent authorization token and permission CREATE_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: NoneRequest ParamsDescriptionTypeRequiredlocale Article languageTwo-letter country code string (for example: 'de')✓idsTasks to delete, separated by commasAlternately, include this param for each task to delete.List of GUIDs✓Request Example:DELETE https://<tenant_subdomain>.wixanswers.com/api/v1/articles/bd948e62-ee6a-a3fd-4cf0-87f30ae7f3fa/tasks/bd948e62-a3fd-4cf0-ee6a-87f30ae7f3fb?locale=en&ids=bd948e62-a3fd-4cf0-87f30ae7f3fc,bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fdManage Article Interaction (Follow, Helpful, Vote)These methods enable you to update user interaction associated with an article, including followers, votes for feature requests, and users who marked an article or video as helpful (or otherwise).Get Counters of Article InteractionsGET https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/counters?locale={locale} Get a list of counts of article followers, views, voters, and helpful/unhelpful indications. Authorization: Requires agent authorization token Content type: application/json; charset=utf-8. Accept: application/json. Response: List of Counter objects, one of each counter type.Request ParamsDescriptionTypelocale Article languageTwo-letter country code string (for example: 'de')Request Example:GET https://<tenant_subdomain>.wixanswers.com/api/v1/articles/bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fa/counters?locale=enGet Whether You Follow an ArticleGET https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/follow?locale={locale} Get whether you are following an article. Authorization: Requires agent authorization token for specific user Content type: application/json; charset=utf-8. Accept: application/json. Response: BooleanRequest ParamsDescriptionTypeRequiredlocale Article languageTwo-letter country code string (for example: 'de')✓Request Example:GET https://<tenant_subdomain>.wixanswers.com/api/v1/articles/bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fa/follow?locale=enGet List of Articles You FollowGET https://<tenant_subdomain>.wixanswers.com/api/v1/articles/followed?locale={locale} Get the list of articles that you follow. Authorization: Requires agent authorization token for specific user Content type: application/json; charset=utf-8. Accept: application/json. Response: Structure including list of Article Objects (public level)Request ParamsDescriptionTypeRequiredlocale Article languageTwo-letter country code string (for example: 'de')✓pagePage of resultsIntegerDefault is 1.pageSizeNumber of results on each pageInteger, between 1 and 500Default is 10.Request Example:GET https://<tenant_subdomain>.wixanswers.com/api/v1/articles/followed?locale=en&page=2&pageSize=20Response Example:{ "items": [ List of @Article objects ], "itemsCount": 108, "page": 2, "numPages": 22, "previousPage": 1, "nextPage": 3, "pageSize": 5 }Follow an ArticlePOST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/follow Follow an article. Authorization: Requires agent authorization token for specific user Content type: application/json; charset=utf-8. Accept: application/json. Response: NonePayload ParamsDescriptionTypeRequiredlocale Article languageTwo-letter country code string (for example: 'de')✓Payload Example:POST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/d367738e-368e-41fe-9289-1a5cbbc3c239/follow { "locale": "en" }Unfollow an ArticleDELETE https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/follow?locale={locale} Unfollow an article. Authorization: Requires agent authorization token for specific user Content type: application/json; charset=utf-8. Accept: application/json. Response: NoneRequest ParamsDescriptionTypeRequiredlocale Article languageTwo-letter country code string (for example: 'de')✓Request Example:DELETE https://<tenant_subdomain>.wixanswers.com/api/v1/articles/bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fa/follow?locale=enIndicate If You Find an Article or Video HelpfulPOST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/helpful Mark or clear an article or video as helpful or not helpful. Authorization: None Content type: application/json; charset=utf-8. Accept: application/json. Response: NonePayload ParamsDescriptionTypeRequiredlocale Article languageTwo-letter country code string (for example: 'de')✓newStateNew helpful indication:* Not helpful (-1)* No indication (0)* Helpful (1)-1, 0, or 1✓statePrevious helpful indication:* Not helpful (-1)* No indication (0)* Helpful (1)-1, 0, 1Payload Example:POST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/d367738e-368e-41fe-9289-1a5cbbc3c239/helpful { "locale": "en", "newState": 1 }Vote for a Feature RequestPOST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/vote Vote for a feature request article. If you have already voted for this request, this has no effect. Authorization: None Content type: application/json; charset=utf-8. Accept: application/json. Response: NonePayload ParamsDescriptionTypeRequiredlocale Article languageTwo-letter country code string (for example: 'de')✓Payload Example:POST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/d367738e-368e-41fe-9289-1a5cbbc3c239/vote { "locale": "en" }Clear Your Vote from a Feature RequestDELETE https://<tenant_subdomain>.wixanswers.com/api/v1/articles/{article GUID}/vote?locale={locale} Clear your vote from a feature request article. If you have not already voted for this request, this has no effect. Authorization: None Content type: application/json; charset=utf-8. Accept: application/json. Response: NoneRequest ParamsDescriptionTypeRequiredlocale Article languageTwo-letter country code string (for example: 'de')✓Request Example:DELETE https://<tenant_subdomain>.wixanswers.com/api/v1/articles/bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fa/vote?locale=enManage Multiple ArticlesThese methods enable you to work with articles in bulk.Search for Articles (Agent)POST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/search/adminGet list of articles matching search / filter criteria.Note:The search include drafts and deleted articles.  The returned articles include extended information, including associated labels. Authorization: Requires agent authorization token and permission FETCH_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: Structure including list of Article Objects (extended level)Payload ParamsDescriptionTypeRequiredidsSearch for specific articlesList of GUIDsexcludedIdsFilter by excluding specific articlesList of GUIDspermalinkSearch for article at specific URIStringlocaleArticle languageTwo-letter country code string (for example: 'de')✓statusesFilter by list of Article StatusesDraft (0) is the default.List of integersresolutionsFilter by list of Article ResolutionsList of integershandledByuserIdsFilter by list of agents that have handled (created or edited) the article.List of GUIDshandledByMeFilter by articles that you have handledBooleantypesFilter by list of Article TypesList of integerscategoryIdsFilter by list of included categories/subcategoriesList of GUIDsexcludedCategoryIdsFilter by list of excluded categories/subcategoriesList of GUIDssearchParentCategoriesWhether to also include / exclude parent categories for the categories listed in categoryIds / excludedCategoryIdsBooleanDefault is true.textFor a text search (sortType=100), filter by best match for exact text in the article title, content (see searchContent.), or phrasesStringMax 200 characters.mustMatchTextFor a text search (sortType=100), filter by exact text that must appear in the article title, content, or phrases.StringmustNotMatchTextFor a text search (sortType=100), filter by exact text that must not appear in the article title, content, or phrases.StringsearchContentWhether to also apply a text search (text, mustMatchText, mustNotMatchText) to the article content (and not only the title or phrases)BooleanDefault is true.spellcheckWhether to correct the spelling in the text search string and try the search again if searching with the uncorrected search string yielded no results.BooleanDefault is true.analyzeTextWhen true, then if text is not empty, and mustMatchText and mustNotMatchText are empty, then parse the text search string, as follows:- Words that starts with a dash "-" are added to a "must not match" list.- Words that starts with a dash "+" are added to a "must match" list.- All other words are used to search as regular text.When false, the text field is used to search as regular text.BooleanDefault is true.multilingualFilter by whether the article is multilingual (has multiple versions for different languages)BooleantaskTypeFilter by list of Content Task Types associated with the articleList of integerstaskStatusesFilter by list of Content Task Statuses associated with the articleList of integerstaskPrioritiesFilter by list of Content Task Priorities of tasks associated with the articleList of integerstaskCreatedByUserIdsFilter by list of agents who created tasks associated with the articleList of GUIDstaskAssignedUsedIdsFilter by list of agents assigned to tasks associated with the articleList of GUIDstaskAssignedGroupIdsFilter by list of agent groups assigned to tasks associated with the articleList of GUIDstaskExcludedAssignedUserIdsFilter by list of agents not assigned to tasks associated with the articleList of GUIDstaskCompletedByUserIdsfilter by list of agents who completed tasks associated with the articleList of GUIDsunassignedTasksWhether to return only articles with unassigned tasksfalse means don't consider whether or not there are unassigned tasks associated with the article.BooleanDefault is false.summarizeLimit the returned article content to 200 characters, each.BooleanDefault is false.hasAllOfLabelIds Filter by articles that include all of a list of included labelsList of GUIDshasAnyOfLabelIdsFilter by articles that include any of a list of included labelsList of GUIDsnotHasAnyOfLabelIdsFilter by articles that do not include any of a list of included labelsList of GUIDsfromCreationDateFilter by articles first created after this timeUnix time stringtoCreationDateFilter by articles first created before this timeUnix time stringfromLastUpdateDateFilter by articles last updated after this timeUnix time stringtoLastUpdateDateFilter by articles last updated before this timeUnix time stringfromFirstPublishDateFilter by articles first published after this time.Unix time stringtoFirstPublishDateFilter by articles first published before this time.Unix time stringfromLastPublishDateFilter by articles last published after this time.Unix time stringtoLastPublishDateFilter by articles last published before this time.Unix time stringpageThe page of results to getInteger, 1 or greaterDefault is 1.pageSizeThe number of results on each pageInteger. between 1 and 500Default is 10.sortTypeSort type. Possible values:* Creation date, ascending (10)* Creation date, descending (20)* Last updated date, ascending (30)* Last updated date, descending (40)* Position (50): The article's current sort order* Related tickets count, ascending (60)* Related tickets count, descending (70)* Best match (text search) (100). When using this sort type, enter a text string in text.* First published date, ascending (110)* First published date, descending (120)* Last published date, ascending (130)* Last published date, descending (140)* Content last updated, ascending (150)* Content last updated, descending (160)IntegerPayload Example:POST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/search/admin { "text": "search article", "locale": "en", "spellcheck": true, "page": 1, "pageSize": 5, "sortType": 100 }Response Example:{ "items": [ List of @Article objects ], "itemsCount": 108, "page": 2, "numPages": 22, "previousPage": 1, "nextPage": 3, "pageSize": 5 }Search for Articles (User)POST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/search Get list of articles matching search / filter criteria. Any content scope settings defined for the Help Center are merged with the search criteria sent in the request. Authorization: None Content type: application/json; charset=utf-8. Accept: application/json. Response: Structure including list of Article Objects (public level) The payload params and return structure are the same as those for the agent search; see Search for Articles (Agent).Search for Articles by TicketPOST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/ticketsRelatedSearch Get list of articles associated to a list of tickets. Authorization: Requires agent authorization token and permission FETCH_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: Structure including list of Article Objects (restricted level) The payload and return structure is the same as for the regular agent search; see Search for Articles (Agent).Get the Number of Articles in a CategoryPOST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/category/count/admin Get the number of articles in a category. If the category has subcategories, this gets the number of articles in all of its subcategories. Includes draft-only articles (articles with no published versions), but does not include deleted articles. Authorization: Requires agent authorization token and permission FETCH_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: Result structure, see belowPayload ParamsDescriptionTypeRequiredlocaleArticle languageTwo-letter country code string (for example: 'de')✓categoryIdCategoryGUID✓Payload Example:POST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/category/count/admin { "locale": "en", "categoryId": "bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fa" }Response Example:Map of category IDs to category article count structure, for example:{ {"bd948e62-ee6a-a3fd-4cf0-87f30ae7f3fa", {"draftCount": 1, "publishedCount": 24} }, {"bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fb", {"draftCount": 0, "publishedCount": 5} } }Move All Articles from One Category to AnotherPOST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/move Move all articles from one category to another category. To move only one article, see Update Article Category. If a category has subcategories, you cannot associate articles with the category, only with one of its  subcategories. Authorization: Requires agent authorization token and permission CREATE_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: NonePayload ParamsDescriptionTypeRequiredcategoryIdCurrent categoryGUID✓newCategoryIdNew categoryTo remove the category, use  00000000-0000-0000-0000-000000000000 as the new category ID.GUID✓Payload Example:POST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/move { "categoryId": "bd948e62-ee6a-a3fd-4cf0-87f30ae7f3fa", "newCategoryId": "bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fb" }Sort Articles in a CategoryPOST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/sort Sort all articles in a category according to the specified order. Before this is run, articles are sorted according to the order they were added. Authorization: Requires agent authorization token and permission CREATE_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: NonePayload ParamsDescriptionTypeRequiredlocaleArticle languageTwo-letter country code string (for example: 'de')✓categoryIdCategory to sortGUID✓idList of articles in the desired sort orderIf you include any articles that are not associated with the category, the operation fails. If you do not include one or more articles that are are associated with the category, the ones that you include are sorted in the specified order and appear before the other (not included) articles.List of GUIDs✓Payload Example:POST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/sort { "categoryId": "bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fa", "locale": "en" }Delete All Articles in a CategoryPOST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/deleteByCategory Delete all articles in a category. If the category has subcategories, the operation fails. To delete one article, see Delete Article. To restore an article, see Restore Deleted Article. Authorization: Requires agent authorization token and permission CREATE_ARTICLES Content type: application/json; charset=utf-8. Accept: application/json. Response: Result structure, see belowPayload ParamsDescriptionTypeRequiredcategoryIdCategoryGUID✓Payload Example:POST https://<tenant_subdomain>.wixanswers.com/api/v1/articles/deleteByCategory { "categoryId": "bd948e62-a3fd-4cf0-87f3-ee6a0ae7f3fa" }Response Example:Response ParamsDescriptionTypesuccessCountThe number of articles deletedIntegerfailCountThe number of articles that could not be deletedInteger{ "successCount": 12, "failCount": 0 }

24 min read

Finding a Category ID

A category ID (GUID) references a specific knowledge base category, including all translated versions of it. You can get category IDs from the URLs in your Wix Answers account's Categories page.To find a category ID: Hover over the Knowledge Base icon and click Categories. Select the relevant category on the left.  The category ID appears in the URL following 'categories': For example: https://[your-subdomain-name].wixanswers.com/app/kb/categories/2cbc3ca3-9e77-45ef-a4a0-c37bdd66267dNote:To find a subcategory's ID, select the subcategory in step 2 above, then locate the ID at the end of the URL after the parent category's ID (view image below). 

1 min read