{"items":[{"type":"link","label":"Knowledge Portal Manager APIs","link":"/apis/v4/knowledge/portalmgr/api-bundled","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled","content":{"contentType":"overview","meta":{"name":"Knowledge Portal Manager APIs"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"api-bundled.json","url":"/_bundle/apis/v4/knowledge/portalmgr/api-bundled.json?download"},{"kind":"download","label":"api-bundled.yaml","url":"/_bundle/apis/v4/knowledge/portalmgr/api-bundled.yaml?download"}]},{"title":"Overview","titleTranslationKey":"info.title","children":[]},{"title":"Languages","titleTranslationKey":"languages.title","children":[{"kind":"languages","options":[{"key":"curl","title":"curl","lang":"curl"},{"key":"javascript","title":"JavaScript","lang":"JavaScript"},{"key":"node","title":"Node.js","lang":"Node.js"},{"key":"python","title":"Python","lang":"Python"},{"key":"java","title":"Java","lang":"Java"},{"key":"csharp","title":"C#","lang":"C#"},{"key":"php","title":"PHP","lang":"PHP"},{"key":"go","title":"Go","lang":"Go"},{"key":"ruby","title":"Ruby","lang":"Ruby"},{"key":"r","title":"R","lang":"R"},{"key":"payload","title":"Payload","lang":"Payload"}]}]},{"title":"Servers","titleTranslationKey":"servers.title","children":[{"kind":"servers","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"Knowledge Portal Manager APIs","showPageActions":true},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[]}],"sectionId":"/apis/v4/knowledge/portalmgr/api-bundled"}],"sectionId":"/apis/v4/knowledge/portalmgr/api-bundled"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"section/license"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"License"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The following licenses are required to use the Knowledge Access APIs:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the user is an agent, then the "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Knowledge + AI"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" license is required."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the user is a customer, the "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Self-Service"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Advanced Self-Service"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" licenses must be available."},"children":[]}]}]}]}]}],"sectionId":"/apis/v4/knowledge/portalmgr/api-bundled/section/license"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"section/tiers"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Tiers"},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Tier"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Tier Name"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Named Users"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Tier 1"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Starter"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Up to 10"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Designed for small-scale implementations or pilot environments"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Tier 2"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Growth"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Up to 1000"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Suitable for mid-scale deployments requiring moderate scalability"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Tier 3"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Enterprise"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Greater than 1000"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Supports large-scale environments with extended configuration options"},"children":[]}]}]}]}]}]}]}],"sectionId":"/apis/v4/knowledge/portalmgr/api-bundled/section/tiers"},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"section/api-resource-limits"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"API Resource Limits"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The following Resources have predefined limits for specific access attributes for Starter, Growth and Enterprise use."},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Resource"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Limits"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Starter"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Growth"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Enterprise"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Article Reference"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Number of attachments used in any article"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"25"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"50"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"50"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Number of custom attributes of an article in the system"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"25"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"25"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"25"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Number of publish views used in an article version"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"20"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"20"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"20"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Topic Reference"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"User-defined topics in a department"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"1000"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"5000"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"10000"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Depth of topics"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"5"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"20"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"20"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Topics at any level"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"500"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"500"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"500"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Number of custom attributes in a topic"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"10"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"10"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"10"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Portal Reference"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Tag categories in a portal"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"15"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"15"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"15"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Topics to be included in a portal"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"100"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"500"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"5000"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Number of articles to display in announcements"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"10"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"25"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"25"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Usage links and link groups setup for a portal"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"5"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"10"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"25"},"children":[]}]}]}]}]}]}]}],"sectionId":"/apis/v4/knowledge/portalmgr/api-bundled/section/api-resource-limits"}]}]}},{"type":"link","label":"License","link":"/apis/v4/knowledge/portalmgr/api-bundled/section/license","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/section/license","content":null},{"type":"link","label":"Tiers","link":"/apis/v4/knowledge/portalmgr/api-bundled/section/tiers","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/section/tiers","content":null},{"type":"link","label":"API Resource Limits","link":"/apis/v4/knowledge/portalmgr/api-bundled/section/api-resource-limits","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/section/api-resource-limits","content":null},{"type":"group","label":"Article","link":"/apis/v4/knowledge/portalmgr/api-bundled/article","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/article","items":[{"label":"Get Article by ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/article/getarticlebyid","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/article/getarticlebyid","metadata":{"seo":{"title":"Get Article by ID","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getArticleById","name":"Get Article by ID","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Article by ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article/getarticlebyid/request/overview","deepLinkHash":"/article/getarticlebyid#article/getarticlebyid/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get Article by ID API allows a user or client application to retrieve an Article using its ID."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It requires a Portal ID, which a user or client application can retrieve through the Administrative Console or by calling Get All Portals API."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Additional Article attributes and contextual views can be specified in the query parameters."},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This API returns structured authoring attributes of Issue, Environment, Cause and Confidence Level when the following conditions are met:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The \"Allow Structured Authoring\" setting is enabled at the partition/department level through the Administrative Console."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The \"Use Structured Authoring\" flag is set on the article type."},"children":[]}]}]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article/getarticlebyid/request/prerequisites","deepLinkHash":"/article/getarticlebyid#article/getarticlebyid/request/prerequisites"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Prerequisites"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Agents without a user profile and customers in a portal without a default user profile only have access to articles that:"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Do not contain any access tags."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Do not contain any publish views."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Contain publish views without any associated tags."},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Agents with a user profile and customers in a portal with a default user profile have access to articles that:"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Do not contain any access tags."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Do not contain any publish views."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Contain publish views without any associated tags."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Contain access tags that are also in the assigned user profiles."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Contain publish views with associated tags that are also in the assigned user profiles."},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Agents with the following assigned actions can view updates to articles currently being processed in workflows:"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"View Author Portal – Allows agents to view updates to articles at any stage in a workflow."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"View Staging Portal – Allows agents to view updates to articles in the Staging stage or a subsequent stage in a workflow."},"children":[]}]}]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]},{"schemes":[{"name":"oAuthAnonymousCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as an anonymous customer.","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true},{"name":"articleID","in":"path","schemaId":"schema_511","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An Article ID is composed of a 2-4 letter prefix followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"$lang","in":"query","schemaId":"schema_512","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language used for a resource. Resources available in different languages may differ from each other."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"$lang"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not passed, then the portal's default language is used."},"children":[]}]}]}]},{"name":"articleAdditionalAttributes","in":"query","schemaId":"schema_513","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The attributes of an Article to be returned "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"in addition to"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" the default list of attributes, listed below. Multiple additional attributes can be specified using a comma-separated list. Passing 'all' will return all attributes."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":4},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Default Attributes"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"These Article attributes are always returned:"},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Name"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"id"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"name"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name of the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"additionalInfo"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Additional information provided as Article metadata."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"articleType"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Article type and its attributes."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"articleKeywords"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A comma-separated list of keywords associated with this Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"articleState"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The current state of the Article. States include A (Authoring), S (Staging), and P (Published)."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"articleSummary"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A brief summary of the Article, provided as metadata."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"createdBy"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID, first name, middle name and last name of the user that created the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"createdDate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date that the Article was created."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"departmentId"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ID of the department for which this Article belongs to."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"description"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Article's description."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"expirationDate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date that the Article is set to expire."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"attachments"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Article's attachments"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"imageURL"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The URL of the image that is present in the Article version. It is used as the thumbnail image for the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"includeInGenAI"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indicates whether this Article is used for eGain's generative AI features."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"isSubscribed"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indicates whether the Article is subscribed for notifications."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"languageCode"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language code of the Article language."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"link"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The link object, used to retrieve the details of the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"modifiedBy"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID, first name, middle name and last name of the user that last modified the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"modifiedDate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date that the Article was last modified on."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"topicBreadcrumb"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Contains a list of topics from the top-level topic to this Article. There may be multiple paths."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"versionId"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article version that is returned."},"children":[]}]}]}]}]}]}],"examples":{"Single":{"description":"An additional attribute to be returned.","value":"[\"averageRating\"]"},"Multiple":{"description":"Additional attributes to be returned.","value":"[\"ownedBy\",\"ownedBy.userName\"]"},"All":{"description":"All additional attributes to be returned.","value":"[\"all\"]"}}},{"name":"$customAdditionalAttributes","in":"query","schemaId":"schema_514","examples":{"Single":{"description":"A user-defined custom attribute.","value":"country_name"},"Multiple":{"description":"Multiple user-defined custom attributes.","value":"internalScore,performance-rating_dept_923"}}},{"name":"accessSource","in":"query","schemaId":"schema_515","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Provides information about the method in which the Article is accessed and is used for self-service analytics. Refer to the eGain User Guide regarding \"Article View Contexts\"."},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Name"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"article_view"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"View an Article directly using its ID."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"article_view_more_related_Article"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"View related articles of an Article using its ID."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"article_view_basic_search"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"View an Article via a basic search."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"article_view_adv_search"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"View an Article via an advanced search."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"article_view_guided_help"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"View an Article via a Guided Help solution."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"article_view_browse_topic"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"View an Article via browsing a topic."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"article_view_browse_tree"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"View an Article via browsing a topic tree."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"article_view_popular_articles"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"View an Article using the Popular Items list in the Self-Service portal."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"article_view_useful_items"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"View Article using the Useful Items list in the Self-Service portal."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"article_view_widget"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"View an Article via a widget."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"article_view_announcement"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"View an Article from the announcement section in the Self-Service portal."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"article_view_bookmarked"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"View a bookmarked Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"article_view_subscription_notification"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"View an Article from a subscription notification."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"article_view_guided_help_additional_info"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"View an Article via additional information from a Guided Help search."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"view_articles_pending_compliance"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"View an Article via Read & Sign in the Self-Service portal."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"type_ahead_Suggestion"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"View an Article from a type-ahead Suggestion in the Self-Service portal."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"semantic_Suggestion"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"View an Article from a semantic Suggestion in the Self-Service portal."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"instant_answer"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"View an Article via an Instant Answers solution."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"instant_answer_reference"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"View an Article that is used as a reference for an Instant Answers solution."},"children":[]}]}]}]}]}]}],"example":"article_view"},{"name":"publishViewId","in":"query","schemaId":"schema_516","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of a publish view for an Article. A publish view is a set of tags used to generate multiple editions of the same Article for display on the self-service portal. Publish views are used in conjunction with single sourcing to tailor the content of an Article to a specific audience by granting access to an Article's version to users that possess the same tags."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A publish view ID is composed of a 4-letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"examples":{"Readable Id":{"description":"A readable publish view ID.","value":"PROD-3203"}}},{"name":"workflowMilestone","in":"query","schemaId":"schema_517","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For agents with the View Author Portal or View Staging Portal actions, this determines which version of the Article is returned."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"'Authoring' returns the most recent version of an Article checked-in by an author."},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"'Staging' returns the updated version currently being processed in a workflow."},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"'Publish' returns the most recently published version."},"children":[]}]}]}]}]}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/{portalID}/articles/{articleID}","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"},{"name":"articleID","in":"path","required":true,"example":"PROD-2996","schemaId":"schema_511"}],"query":[{"name":"$lang","in":"query","required":false,"example":"en-US","schemaId":"components/schemas/LegacyKBLanguageCodes"},{"name":"articleAdditionalAttributes","in":"query","required":false,"example":["averageRating"],"schemaId":"schema_513","style":"form","explode":false},{"name":"$customAdditionalAttributes","in":"query","required":false,"example":"country_name","schemaId":"schema_514"},{"name":"accessSource","in":"query","example":"article_view","schemaId":"schema_515"},{"name":"publishViewId","in":"query","example":"PROD-3203","schemaId":"schema_516"},{"name":"workflowMilestone","in":"query","example":"publish","schemaId":"schema_517"}],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthAnonymousCustomer","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}],"responseCodes":["200","204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/articles/{articleID}","href":"article/getarticlebyid","openApiOperationId":"getArticleById","summary":"Get Article by ID","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthAnonymousCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Article","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/200/content/application~1json/examples/Summary Attributes with Structured Authoring enabled","paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/200/content/application~1json/examples/All Attributes"]}},"schemaId":"components/schemas/Article","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/200/content/application~1json/examples/Summary Attributes with Structured Authoring enabled","paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/200/content/application~1json/examples/All Attributes"]},{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/Article","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/200/content/application~1json/examples/Summary Attributes with Structured Authoring enabled","paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/200/content/application~1json/examples/All Attributes"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Article","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/200/content/application~1json/examples/Summary Attributes with Structured Authoring enabled","paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/200/content/application~1json/examples/All Attributes"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/article/getarticlebyid"}],"panels":[]}]},"httpPath":"/portals/{portalID}/articles/{articleID}"},{"label":"Get Article By ID with Editions","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/article/getarticlebyidwitheditions","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/article/getarticlebyidwitheditions","metadata":{"seo":{"title":"Get Article By ID with Editions","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getArticleByIdWithEditions","name":"Get Article By ID with Editions","isWebhook":false,"pointer":"/paths/~1articles~1{articleID}~1witheditions/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Article By ID with Editions","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article/getarticlebyidwitheditions/request/overview","deepLinkHash":"/article/getarticlebyidwitheditions#article/getarticlebyidwitheditions/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This API allows a user to retrieve an article with all its editions."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If there are no editions for the article, the response will contain the base content of the article."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthClient","scopes":["https://api.egain.cloud/auth/.default"],"type":"oauth2","description":"Authenticate as a client (Server to Server).","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/global/f51302dd-7036-41b5-b619-e1a52a67c780/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/.default":"Default scope"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"articleID","in":"path","schemaId":"schema_511","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An Article ID is composed of a 2-4 letter prefix followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1articles~1{articleID}~1witheditions/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"$lang","in":"query","schemaId":"schema_512","description":"The language used for a resource. Resources available in different languages may differ from each other.","required":true},{"name":"workflowMilestone","in":"query","schemaId":"schema_517","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For agents with the View Author Portal or View Staging Portal actions, this determines which version of the Article is returned."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"'Authoring' returns the most recent version of an Article checked-in by an author."},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"'Staging' returns the updated version currently being processed in a workflow."},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"'Publish' returns the most recently published version."},"children":[]}]}]}]}]}],"pointer":"/paths/~1articles~1{articleID}~1witheditions/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}}],"pointer":"/paths/~1articles~1{articleID}~1witheditions/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/articles/{articleID}/witheditions","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"articleID","in":"path","required":true,"example":"PROD-2996","schemaId":"schema_511"}],"query":[{"name":"$lang","in":"query","required":true,"example":"en-US","schemaId":"components/schemas/LegacyKBLanguageCodes"},{"name":"workflowMilestone","in":"query","example":"publish","schemaId":"schema_517"}],"querystring":[],"header":[{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthClient","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/global/f51302dd-7036-41b5-b619-e1a52a67c780/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/.default":"Default scope"}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/.default"]}],"responseCodes":["200","400","401","403","404","406","500"],"pointer":"/articles/{articleID}/witheditions","href":"article/getarticlebyidwitheditions","openApiOperationId":"getArticleByIdWithEditions","summary":"Get Article By ID with Editions"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ArticleWithEditions","exampleIds":["paths/~1articles~1{articleID}~1witheditions/get/responses/200/content/application~1json/examples/Article with Editions"]}},"schemaId":"components/schemas/ArticleWithEditions","exampleIds":["paths/~1articles~1{articleID}~1witheditions/get/responses/200/content/application~1json/examples/Article with Editions"]},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1witheditions/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1articles~1{articleID}~1witheditions/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1witheditions/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1articles~1{articleID}~1witheditions/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1witheditions/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1witheditions/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1witheditions/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1witheditions/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1witheditions/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1witheditions/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1witheditions/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1witheditions/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1witheditions/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1witheditions/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1articles~1{articleID}~1witheditions/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ArticleWithEditions","exampleIds":["paths/~1articles~1{articleID}~1witheditions/get/responses/200/content/application~1json/examples/Article with Editions"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ArticleWithEditions","exampleIds":["paths/~1articles~1{articleID}~1witheditions/get/responses/200/content/application~1json/examples/Article with Editions"]}}},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1witheditions/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1articles~1{articleID}~1witheditions/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1witheditions/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1articles~1{articleID}~1witheditions/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1witheditions/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1witheditions/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1witheditions/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1witheditions/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1witheditions/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1witheditions/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1witheditions/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1witheditions/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1witheditions/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1witheditions/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/article/getarticlebyidwitheditions"}],"panels":[]}]},"httpPath":"/articles/{articleID}/witheditions"},{"label":"Get Article Edition Details","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/article/getarticleeditiondetails","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/article/getarticleeditiondetails","metadata":{"seo":{"title":"Get Article Edition Details","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getArticleEditionDetails","name":"Get Article Edition Details","isWebhook":false,"pointer":"/paths/~1articles~1{articleID}~1editions~1{publishViewId}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Article Edition Details","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article/getarticleeditiondetails/request/overview","deepLinkHash":"/article/getarticleeditiondetails#article/getarticleeditiondetails/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This API retrieves the details of an article edition."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthClient","scopes":["https://api.egain.cloud/auth/.default"],"type":"oauth2","description":"Authenticate as a client (Server to Server).","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/global/f51302dd-7036-41b5-b619-e1a52a67c780/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/.default":"Default scope"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"articleID","in":"path","schemaId":"schema_521","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article. Both numeric and alternate ID formats are supported."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Valid numerical IDs are 15-19 digits long."},"children":[]}]}]}],"required":true,"examples":{"Readable Id":{"description":"A readable Article ID.","value":"PROD-2996"},"Numeric Id":{"description":"A numerical Article ID.","value":"202200000002996"}}},{"name":"publishViewId","in":"path","schemaId":"schema_522","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of a Publish View Id."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A Publish View Id ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"$lang","in":"query","schemaId":"schema_512","description":"The language used for a resource. Resources available in different languages may differ from each other.","required":true},{"name":"workflowMilestone","in":"query","schemaId":"schema_517","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For agents with the View Author Portal or View Staging Portal actions, this determines which version of the Article is returned."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"'Authoring' returns the most recent version of an Article checked-in by an author."},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"'Staging' returns the updated version currently being processed in a workflow."},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"'Publish' returns the most recently published version."},"children":[]}]}]}]}]}],"pointer":"/paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/articles/{articleID}/editions/{publishViewId}","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"articleID","in":"path","required":true,"example":"PROD-2996","schemaId":"schema_521"},{"name":"publishViewId","in":"path","required":true,"example":"PROD-3020","schemaId":"schema_522"}],"query":[{"name":"$lang","in":"query","required":true,"example":"en-US","schemaId":"components/schemas/LegacyKBLanguageCodes"},{"name":"workflowMilestone","in":"query","example":"publish","schemaId":"schema_517"}],"querystring":[],"header":[{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthClient","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/global/f51302dd-7036-41b5-b619-e1a52a67c780/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/.default":"Default scope"}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/.default"]}],"responseCodes":["200","400","401","403","404","406","500"],"pointer":"/articles/{articleID}/editions/{publishViewId}","href":"article/getarticleeditiondetails","openApiOperationId":"getArticleEditionDetails","summary":"Get Article Edition Details"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EditionWithContent","exampleIds":["paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/EditionWithContent","exampleIds":["paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/EditionWithContent","exampleIds":["paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/EditionWithContent","exampleIds":["paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/article/getarticleeditiondetails"}],"panels":[]}]},"httpPath":"/articles/{articleID}/editions/{publishViewId}"},{"label":"Get All Article Types in a Department","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/article/getallarticletypes","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/article/getallarticletypes","metadata":{"seo":{"title":"Get All Article Types in a Department","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getAllArticleTypes","name":"Get All Article Types in a Department","isWebhook":false,"pointer":"/paths/~1articletypes/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get All Article Types in a Department","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article/getallarticletypes/request/overview","deepLinkHash":"/article/getallarticletypes#article/getallarticletypes/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get All Article Types in a Department API retrieves a list of all Article Types configured for a specific department."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]},{"schemes":[{"name":"oAuthAnonymousCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as an anonymous customer.","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"departmentID","in":"query","schemaId":"schema_523","description":"The ID of the department.","required":true},{"name":"articleTypeAdditionalAttributes","in":"query","schemaId":"schema_524","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The attributes of an ArticleType to be returned "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"in addition to"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" the default list of attributes, listed below. Multiple additional attributes can be specified using a comma-separated list."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":4},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Default Attributes"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"These Article Type attributes are always returned:"},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Name"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"articleCategoryId"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Article category ID of the Article Type."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"typeName"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name of the Article Type."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"articleTypeId"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article Type."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"useStructuredAuthoring"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indicates if article type is using structured authoring."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"imageURL"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL of the image associated with the Article Type."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"description"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The description of the Article Type."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"isSearchable"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indicates whether articles of this type are included in portal search results"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"isBrowsable"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indicates whether articles of this type are displayed in portal browsing areas such as topics and lists"},"children":[]}]}]}]}]}]}],"examples":{"Single":{"description":"An additional attribute to be returned.","value":"[\"useForCertifiedAnswers\"]"}}}],"pointer":"/paths/~1articletypes/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1articletypes/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/articletypes","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[],"query":[{"name":"departmentID","in":"query","required":true,"example":"999","schemaId":"schema_523"},{"name":"articleTypeAdditionalAttributes","in":"query","required":false,"example":["useForCertifiedAnswers"],"schemaId":"schema_524","style":"form","explode":false}],"querystring":[],"header":[{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthAnonymousCustomer","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}],"responseCodes":["200","204","400","401","403","404","406","500"],"pointer":"/articletypes","href":"article/getallarticletypes","openApiOperationId":"getAllArticleTypes","summary":"Get All Article Types in a Department","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthAnonymousCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ArticleTypes","exampleIds":["paths/~1articletypes/get/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/ArticleTypes","exampleIds":["paths/~1articletypes/get/responses/200/content/application~1json/example"]},{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articletypes/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1articletypes/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articletypes/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1articletypes/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articletypes/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articletypes/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articletypes/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articletypes/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articletypes/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articletypes/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articletypes/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articletypes/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articletypes/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articletypes/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1articletypes/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ArticleTypes","exampleIds":["paths/~1articletypes/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ArticleTypes","exampleIds":["paths/~1articletypes/get/responses/200/content/application~1json/example"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articletypes/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1articletypes/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articletypes/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1articletypes/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articletypes/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articletypes/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articletypes/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articletypes/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articletypes/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articletypes/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articletypes/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articletypes/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articletypes/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articletypes/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/article/getallarticletypes"}],"panels":[]}]},"httpPath":"/articletypes"},{"label":"Add Article to Reply","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/article/addtoreply","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/article/addtoreply","metadata":{"seo":{"title":"Add Article to Reply","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AddToReply","name":"Add Article to Reply","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Add Article to Reply","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article/addtoreply/request/overview","deepLinkHash":"/article/addtoreply#article/addtoreply/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Add Article to Reply API captures events for articles used in a reply for a digital channel activity."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note:  Either the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"x-ext-activity-id"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or"},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"x-ext-integration-id"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"x-ext-interaction-id"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header must be provided."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article/addtoreply/request/permissions","deepLinkHash":"/article/addtoreply#article/addtoreply/request/permissions"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Permissions"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Only Agents can invoke this API."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true},{"name":"articleID","in":"path","schemaId":"schema_511","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An Article ID is composed of a 2-4 letter prefix followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true},{"name":"Accept","in":"header","schemaId":"schema_525","description":"The content type accepted by the client.","required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ArticleActivityLink"}},"schemaId":"components/schemas/ArticleActivityLink","pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/portals/{portalID}/articles/{articleID}/addtoreply","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"},{"name":"articleID","in":"path","required":true,"example":"PROD-2996","schemaId":"schema_511"}],"query":[],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"},{"name":"Accept","in":"header","required":true,"schemaId":"schema_525"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/ArticleActivityLink"}},"responseCodes":["204","400","401","403","404","406","415","500"],"pointer":"/portals/{portalID}/articles/{articleID}/addtoreply","href":"article/addtoreply","openApiOperationId":"AddToReply","summary":"Add Article to Reply","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"schemaId":"components/schemas/ArticleActivityLink","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ArticleActivityLink"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"415","description":"Incorrect Content Type Header"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"415"},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/article/addtoreply"}],"panels":[]}]},"httpPath":"/portals/{portalID}/articles/{articleID}/addtoreply"},{"label":"Add as Reference","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/article/addasreference","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/article/addasreference","metadata":{"seo":{"title":"Add as Reference","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"AddAsReference","name":"Add as Reference","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Add as Reference","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article/addasreference/request/overview","deepLinkHash":"/article/addasreference#article/addasreference/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Add as Reference API captures events for articles that are referenced by agents replying inside of a digital channel activity."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: Either the "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"x-ext-activity-id"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or"},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"x-ext-integration-id"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"x-ext-interaction-id"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header must be provided."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article/addasreference/request/permissions","deepLinkHash":"/article/addasreference#article/addasreference/request/permissions"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Permissions"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Only Agents can invoke this API."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true},{"name":"articleID","in":"path","schemaId":"schema_511","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An Article ID is composed of a 2-4 letter prefix followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true},{"name":"Accept","in":"header","schemaId":"schema_525","description":"The content type accepted by the client.","required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ArticleActivityLink"}},"schemaId":"components/schemas/ArticleActivityLink","pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/portals/{portalID}/articles/{articleID}/addasreference","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"},{"name":"articleID","in":"path","required":true,"example":"PROD-2996","schemaId":"schema_511"}],"query":[],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"},{"name":"Accept","in":"header","required":true,"schemaId":"schema_525"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/ArticleActivityLink"}},"responseCodes":["204","400","401","403","404","406","415","500"],"pointer":"/portals/{portalID}/articles/{articleID}/addasreference","href":"article/addasreference","openApiOperationId":"AddAsReference","summary":"Add as Reference","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"schemaId":"components/schemas/ArticleActivityLink","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ArticleActivityLink"}},"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"415","description":"Incorrect Content Type Header"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"415"},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/article/addasreference"}],"panels":[]}]},"httpPath":"/portals/{portalID}/articles/{articleID}/addasreference"},{"label":"Get Articles in Topic","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/article/getarticlesintopic","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/article/getarticlesintopic","metadata":{"seo":{"title":"Get Articles in Topic","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getArticlesInTopic","name":"Get Articles in Topic","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1articles/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Articles in Topic","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article/getarticlesintopic/request/overview","deepLinkHash":"/article/getarticlesintopic#article/getarticlesintopic/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get Articles in Topic API allows a user to retrieve the browsable articles in a topic."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article/getarticlesintopic/request/prerequisites","deepLinkHash":"/article/getarticlesintopic#article/getarticlesintopic/request/prerequisites"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Prerequisites"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set the Article type’s parameter “Include in browse on portals” to \"Yes\" for an article to be returned by this API."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Agents without a user profile and customers in a portal without a default user profile only have access to articles that:"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Do not contain any access tags."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Do not contain any publish views."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Contain published views without any associated tags."},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Agents with a user profile and customers in a portal with a default user profile have access to articles that:"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Do not contain any access tags."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Do not contain any publish views."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Contain publish views without any associated tags."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Contain access tags that are also in the assigned user profiles."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Contain publish views with associated tags that are also in the assigned user profiles."},"children":[]}]}]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article/getarticlesintopic/request/permissions","deepLinkHash":"/article/getarticlesintopic#article/getarticlesintopic/request/permissions"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Permissions"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Agents with the following assigned actions can view updates to articles currently being processed in workflows:"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"View Author Portal – Allows agents to view updates to articles at any stage in a workflow."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"View Staging Portal – Allows agents to view updates to articles in the Staging stage or a subsequent stage in a workflow."},"children":[]}]}]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]},{"schemes":[{"name":"oAuthAnonymousCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as an anonymous customer.","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}}}]},{"schemes":[{"name":"oAuthClient","scopes":["https://api.egain.cloud/auth/.default"],"type":"oauth2","description":"Authenticate as a client (Server to Server).","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/global/f51302dd-7036-41b5-b619-e1a52a67c780/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/.default":"Default scope"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"searchProfileId","in":"query","schemaId":"schema_526","description":"Search Profile ID"},{"name":"$filter[topicId]","in":"query","schemaId":"schema_516","description":"The ID of the topic. It is used to restrict to a specific topic.","required":true,"example":"PROD-1065"},{"name":"articleResultAdditionalAttributes","in":"query","schemaId":"schema_527","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The attributes of an Article to be returned "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"in addition to"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" the default list of attributes, listed below. Multiple additional attributes can be specified using a comma-separated list. Passing 'all' will return all attributes."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":4},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Default Attributes"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"These Article attributes are always returned:"},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Name"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"id"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"name"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name of the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"articleType"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Article Type and its attributes."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"createdBy"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID, first name, middle name and last name of the user that created the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"createdDate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date that the Article was created."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"hasAttachments"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"True: The Article has one or more attachments."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"False: The Article does not have any attachments."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"languageCode"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language code of the Article language."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"modifiedBy"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID, first name, middle name and last name of the user that last modified the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"modifiedDate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date that the Article was last modified on."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"link"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The link object, used to retrieve the details of the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"versionId"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article version that is returned."},"children":[]}]}]}]}]}]}],"examples":{"Single":{"description":"An additional attribute to be returned.","value":"[\"averageRating\"]"},"Multiple":{"description":"Additional attributes to be returned.","value":"[\"ownedBy\",\"ownedBy.userName\"]"},"All":{"description":"All additional attributes to be returned.","value":"[\"all\"]"}}},{"name":"$filter[tags]","in":"query","schemaId":"schema_528","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A comma separated list of Tag / Tag Group IDs. The query results will be filtered by the tags that are specified."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Tag IDs and Tag Group IDs can be mixed together."},"children":[]}]}]}]},{"name":"workflowMilestone","in":"query","schemaId":"schema_517","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For agents with the View Author Portal or View Staging Portal actions, this determines which version of the Article is returned."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"'Authoring' returns the most recent version of an Article checked-in by an author."},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"'Staging' returns the updated version currently being processed in a workflow."},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"'Publish' returns the most recently published version."},"children":[]}]}]}]}]},{"name":"$lang","in":"query","schemaId":"schema_512","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language used for a resource. Resources available in different languages may differ from each other."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"$lang"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not passed, then the portal's default language is used."},"children":[]}]}]}]},{"name":"$pagenum","in":"query","schemaId":"schema_529","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the page number of results to be returned. Used in conjunction with $pagesize."},"children":[]}]}]}]},{"name":"$pagesize","in":"query","schemaId":"schema_530","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the number of results per page. Used in conjunction with $pagenum."},"children":[]}]}]}]},{"name":"$sort","in":"query","schemaId":"schema_531","description":"Articles to be sorted on."},{"name":"$order","in":"query","schemaId":"schema_532"}],"pointer":"/paths/~1portals~1{portalID}~1articles/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/{portalID}/articles","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"}],"query":[{"name":"searchProfileId","in":"query","example":"959500000204621","schemaId":"schema_526"},{"name":"$filter[topicId]","in":"query","required":true,"example":"PROD-1065","schemaId":"schema_516"},{"name":"articleResultAdditionalAttributes","in":"query","required":false,"example":["averageRating"],"schemaId":"schema_527","style":"form","explode":false},{"name":"$filter[tags]","in":"query","required":false,"example":"PROD-5381","schemaId":"schema_528"},{"name":"workflowMilestone","in":"query","example":"publish","schemaId":"schema_517"},{"name":"$lang","in":"query","required":false,"example":"en-US","schemaId":"components/schemas/LegacyKBLanguageCodes"},{"name":"$pagenum","in":"query","required":false,"schemaId":"schema_529"},{"name":"$pagesize","in":"query","required":false,"schemaId":"schema_530"},{"name":"$sort","in":"query","required":false,"example":"name","schemaId":"schema_531"},{"name":"$order","in":"query","required":false,"example":"asc","schemaId":"schema_532"}],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthAnonymousCustomer","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthClient","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/global/f51302dd-7036-41b5-b619-e1a52a67c780/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/.default":"Default scope"}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/.default"]}],"responseCodes":["200","204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/articles","href":"article/getarticlesintopic","openApiOperationId":"getArticlesInTopic","summary":"Get Articles in Topic","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthAnonymousCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthClient":["https://api.egain.cloud/auth/.default"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ArticleResults","exampleIds":["paths/~1portals~1{portalID}~1articles/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1articles/get/responses/200/content/application~1json/examples/All Attributes"]}},"schemaId":"components/schemas/ArticleResults","exampleIds":["paths/~1portals~1{portalID}~1articles/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1articles/get/responses/200/content/application~1json/examples/All Attributes"]},{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1articles/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ArticleResults","exampleIds":["paths/~1portals~1{portalID}~1articles/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1articles/get/responses/200/content/application~1json/examples/All Attributes"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ArticleResults","exampleIds":["paths/~1portals~1{portalID}~1articles/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1articles/get/responses/200/content/application~1json/examples/All Attributes"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/article/getarticlesintopic"}],"panels":[]}]},"httpPath":"/portals/{portalID}/articles"},{"label":"Get Article Attachment By ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/article/getarticleattachmentbyid","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/article/getarticleattachmentbyid","metadata":{"seo":{"title":"Get Article Attachment By ID","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getArticleAttachmentById","name":"Get Article Attachment By ID","isWebhook":false,"pointer":"/paths/~1articles~1attachments~1{attachmentID}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Article Attachment By ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article/getarticleattachmentbyid/request/overview","deepLinkHash":"/article/getarticleattachmentbyid#article/getarticleattachmentbyid/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This API allows one article attachment identified by an attachment ID to be retrieved."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthClient","scopes":["https://api.egain.cloud/auth/.default"],"type":"oauth2","description":"Authenticate as a client (Server to Server).","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/global/f51302dd-7036-41b5-b619-e1a52a67c780/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/.default":"Default scope"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"attachmentID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the attachment."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An attachment ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1articles~1attachments~1{attachmentID}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1articles~1attachments~1{attachmentID}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/articles/attachments/{attachmentID}","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"attachmentID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"}],"query":[],"querystring":[],"header":[{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthClient","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/global/f51302dd-7036-41b5-b619-e1a52a67c780/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/.default":"Default scope"}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/.default"]}],"responseCodes":["200","400","401","403","404","406","500"],"pointer":"/articles/attachments/{attachmentID}","href":"article/getarticleattachmentbyid","openApiOperationId":"getArticleAttachmentById","summary":"Get Article Attachment By ID"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AttachmentContentResult","exampleIds":["paths/~1articles~1attachments~1{attachmentID}/get/responses/200/content/application~1json/examples/GetAttachmentById"]}},"schemaId":"components/schemas/AttachmentContentResult","exampleIds":["paths/~1articles~1attachments~1{attachmentID}/get/responses/200/content/application~1json/examples/GetAttachmentById"]},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1articles~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1articles~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1attachments~1{attachmentID}/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1attachments~1{attachmentID}/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1attachments~1{attachmentID}/get/responses/403/content/application~1json/examples/Actor Not Allowed","paths/~1articles~1attachments~1{attachmentID}/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1attachments~1{attachmentID}/get/responses/403/content/application~1json/examples/Actor Not Allowed","paths/~1articles~1attachments~1{attachmentID}/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1attachments~1{attachmentID}/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1attachments~1{attachmentID}/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1attachments~1{attachmentID}/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1attachments~1{attachmentID}/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1attachments~1{attachmentID}/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1attachments~1{attachmentID}/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1articles~1attachments~1{attachmentID}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/AttachmentContentResult","exampleIds":["paths/~1articles~1attachments~1{attachmentID}/get/responses/200/content/application~1json/examples/GetAttachmentById"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AttachmentContentResult","exampleIds":["paths/~1articles~1attachments~1{attachmentID}/get/responses/200/content/application~1json/examples/GetAttachmentById"]}}},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1articles~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1articles~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1attachments~1{attachmentID}/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1attachments~1{attachmentID}/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1attachments~1{attachmentID}/get/responses/403/content/application~1json/examples/Actor Not Allowed","paths/~1articles~1attachments~1{attachmentID}/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1attachments~1{attachmentID}/get/responses/403/content/application~1json/examples/Actor Not Allowed","paths/~1articles~1attachments~1{attachmentID}/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1attachments~1{attachmentID}/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1attachments~1{attachmentID}/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1attachments~1{attachmentID}/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1attachments~1{attachmentID}/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1attachments~1{attachmentID}/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1articles~1attachments~1{attachmentID}/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/article/getarticleattachmentbyid"}],"panels":[]}]},"httpPath":"/articles/attachments/{attachmentID}"},{"label":"Get Article Attachment in Portal","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/article/getattachmentbyidinportal","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/article/getattachmentbyidinportal","metadata":{"seo":{"title":"Get Article Attachment in Portal","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getAttachmentByIdInPortal","name":"Get Article Attachment in Portal","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Article Attachment in Portal","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article/getattachmentbyidinportal/request/overview","deepLinkHash":"/article/getattachmentbyidinportal#article/getattachmentbyidinportal/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get Article Attachment API retrieves an attachment associated to an article by calling the attachment ID for a specified portal ID."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]},{"schemes":[{"name":"oAuthAnonymousCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as an anonymous customer.","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true},{"name":"attachmentID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the attachment."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An attachment ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"$lang","in":"query","schemaId":"schema_512","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language used for a resource. Resources available in different languages may differ from each other."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"$lang"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not passed, then the portal's default language is used."},"children":[]}]}]}]}],"pointer":"/paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/{portalID}/articles/attachments/{attachmentID}","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"},{"name":"attachmentID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"}],"query":[{"name":"$lang","in":"query","required":false,"example":"en-US","schemaId":"components/schemas/LegacyKBLanguageCodes"}],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthAnonymousCustomer","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}],"responseCodes":["200","204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/articles/attachments/{attachmentID}","href":"article/getattachmentbyidinportal","openApiOperationId":"getAttachmentByIdInPortal","summary":"Get Article Attachment in Portal","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthAnonymousCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AttachmentContentResult","exampleIds":["paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/200/content/application~1json/examples/All Attributes"]}},"schemaId":"components/schemas/AttachmentContentResult","exampleIds":["paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/200/content/application~1json/examples/All Attributes"]},{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/AttachmentContentResult","exampleIds":["paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/200/content/application~1json/examples/All Attributes"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AttachmentContentResult","exampleIds":["paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/200/content/application~1json/examples/All Attributes"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/article/getattachmentbyidinportal"}],"panels":[]}]},"httpPath":"/portals/{portalID}/articles/attachments/{attachmentID}"},{"label":"Get Related Articles","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/article/getrelatedarticles","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/article/getrelatedarticles","metadata":{"seo":{"title":"Get Related Articles","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getRelatedArticles","name":"Get Related Articles","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Related Articles","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article/getrelatedarticles/request/overview","deepLinkHash":"/article/getrelatedarticles#article/getrelatedarticles/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get Related Articles API retrieves all related articles associated to a given article."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article/getrelatedarticles/request/prerequisites","deepLinkHash":"/article/getrelatedarticles#article/getrelatedarticles/request/prerequisites"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Prerequisites"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Set the Article type’s parameter “Include in browse on portals” to \"Yes\" for an article to be returned by this API."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Agents without a user profile and customers in a portal without a default user profile only have access to articles that:"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Do not contain any access tags."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Do not contain any publish views."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Contain publish views without any associated tags."},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Agents with a user profile and customers in a portal with a default user profile have access to articles that:"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Do not contain any access tags."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Do not contain any publish views."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Contain publish views without any associated tags."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Contain access tags that are also in the assigned user profiles."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Contain publish views with associated tags that are also in the assigned user profiles."},"children":[]}]}]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article/getrelatedarticles/request/permissions","deepLinkHash":"/article/getrelatedarticles#article/getrelatedarticles/request/permissions"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Permissions"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Agents with the following assigned actions can view updates to articles currently being processed in workflows:"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"View Author Portal – Allows agents to view updates to articles at any stage in a workflow."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"View Staging Portal – Allows agents to view updates to articles in the Staging stage or a subsequent stage in a workflow."},"children":[]}]}]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]},{"schemes":[{"name":"oAuthAnonymousCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as an anonymous customer.","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true},{"name":"articleID","in":"path","schemaId":"schema_511","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An Article ID is composed of a 2-4 letter prefix followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"$filter[tags]","in":"query","schemaId":"schema_528","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A comma separated list of Tag / Tag Group IDs. The query results will be filtered by the tags that are specified."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Tag IDs and Tag Group IDs can be mixed together."},"children":[]}]}]}]},{"name":"articleResultAdditionalAttributes","in":"query","schemaId":"schema_527","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The attributes of an Article to be returned "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"in addition to"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" the default list of attributes, listed below. Multiple additional attributes can be specified using a comma-separated list. Passing 'all' will return all attributes."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":4},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Default Attributes"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"These Article attributes are always returned:"},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Name"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"id"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"name"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name of the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"articleType"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Article Type and its attributes."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"createdBy"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID, first name, middle name and last name of the user that created the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"createdDate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date that the Article was created."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"hasAttachments"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"True: The Article has one or more attachments."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"False: The Article does not have any attachments."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"languageCode"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language code of the Article language."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"modifiedBy"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID, first name, middle name and last name of the user that last modified the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"modifiedDate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date that the Article was last modified on."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"link"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The link object, used to retrieve the details of the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"versionId"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article version that is returned."},"children":[]}]}]}]}]}]}],"examples":{"Single":{"description":"An additional attribute to be returned.","value":"[\"averageRating\"]"},"Multiple":{"description":"Additional attributes to be returned.","value":"[\"ownedBy\",\"ownedBy.userName\"]"},"All":{"description":"All additional attributes to be returned.","value":"[\"all\"]"}}},{"name":"workflowMilestone","in":"query","schemaId":"schema_517","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For agents with the View Author Portal or View Staging Portal actions, this determines which version of the Article is returned."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"'Authoring' returns the most recent version of an Article checked-in by an author."},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"'Staging' returns the updated version currently being processed in a workflow."},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"'Publish' returns the most recently published version."},"children":[]}]}]}]}]},{"name":"$lang","in":"query","schemaId":"schema_512","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language used for a resource. Resources available in different languages may differ from each other."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"$lang"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not passed, then the portal's default language is used."},"children":[]}]}]}]},{"name":"$pagenum","in":"query","schemaId":"schema_529","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the page number of results to be returned. Used in conjunction with $pagesize."},"children":[]}]}]}]},{"name":"$pagesize","in":"query","schemaId":"schema_530","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the number of results per page. Used in conjunction with $pagenum."},"children":[]}]}]}]}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/{portalID}/articles/{articleID}/related","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"},{"name":"articleID","in":"path","required":true,"example":"PROD-2996","schemaId":"schema_511"}],"query":[{"name":"$filter[tags]","in":"query","required":false,"example":"PROD-5381","schemaId":"schema_528"},{"name":"articleResultAdditionalAttributes","in":"query","required":false,"example":["averageRating"],"schemaId":"schema_527","style":"form","explode":false},{"name":"workflowMilestone","in":"query","example":"publish","schemaId":"schema_517"},{"name":"$lang","in":"query","required":false,"example":"en-US","schemaId":"components/schemas/LegacyKBLanguageCodes"},{"name":"$pagenum","in":"query","required":false,"schemaId":"schema_529"},{"name":"$pagesize","in":"query","required":false,"schemaId":"schema_530"}],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthAnonymousCustomer","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}],"responseCodes":["200","204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/articles/{articleID}/related","href":"article/getrelatedarticles","openApiOperationId":"getRelatedArticles","summary":"Get Related Articles","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthAnonymousCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ArticleResults","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/200/content/application~1json/examples/All Attributes"]}},"schemaId":"components/schemas/ArticleResults","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/200/content/application~1json/examples/All Attributes"]},{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ArticleResults","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/200/content/application~1json/examples/All Attributes"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ArticleResults","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/200/content/application~1json/examples/All Attributes"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/article/getrelatedarticles"}],"panels":[]}]},"httpPath":"/portals/{portalID}/articles/{articleID}/related"},{"label":"Get Announcement Articles","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/article/getannouncementarticles","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/article/getannouncementarticles","metadata":{"seo":{"title":"Get Announcement Articles","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getAnnouncementArticles","name":"Get Announcement Articles","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1articles~1announcements/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Announcement Articles","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article/getannouncementarticles/request/overview","deepLinkHash":"/article/getannouncementarticles#article/getannouncementarticles/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get Announcement Articles API returns a portal's announcement articles. Only displayable announcement articles in the portal are returned."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article/getannouncementarticles/request/prerequisites","deepLinkHash":"/article/getannouncementarticles#article/getannouncementarticles/request/prerequisites"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Prerequisites"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For an article to display or be returned, set the Article type’s parameter, “Include in browse on portals,” to \"Yes\"."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Agents without a user profile and customers in a portal without a default user profile only have access to articles that:"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Do not contain any access tags."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Do not contain any publish views."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Contain publish views without any associated tags."},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Agents with a user profile and customers in a portal with a default user profile have access to articles that:"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Do not contain any access tags."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Do not contain any publish views."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Contain publish views without any associated tags."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Contain access tags that are also in the assigned user profiles."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Contain publish views with associated tags that are also in the assigned user profiles."},"children":[]}]}]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article/getannouncementarticles/request/permissions","deepLinkHash":"/article/getannouncementarticles#article/getannouncementarticles/request/permissions"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Permissions"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Agents with the following assigned actions can view updates to articles currently being processed in workflows:"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"View Author Portal – Allows agents to view updates to articles at any stage in a workflow."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"View Staging Portal – Allows agents to view updates to articles in the Staging stage or a subsequent stage in a workflow."},"children":[]}]}]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]},{"schemes":[{"name":"oAuthAnonymousCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as an anonymous customer.","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles~1announcements/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"$filter[tags]","in":"query","schemaId":"schema_528","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A comma separated list of Tag / Tag Group IDs. The query results will be filtered by the tags that are specified."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Tag IDs and Tag Group IDs can be mixed together."},"children":[]}]}]}]},{"name":"articleResultAdditionalAttributes","in":"query","schemaId":"schema_527","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The attributes of an Article to be returned "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"in addition to"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" the default list of attributes, listed below. Multiple additional attributes can be specified using a comma-separated list. Passing 'all' will return all attributes."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":4},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Default Attributes"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"These Article attributes are always returned:"},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Name"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"id"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"name"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name of the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"articleType"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Article Type and its attributes."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"createdBy"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID, first name, middle name and last name of the user that created the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"createdDate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date that the Article was created."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"hasAttachments"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"True: The Article has one or more attachments."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"False: The Article does not have any attachments."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"languageCode"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language code of the Article language."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"modifiedBy"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID, first name, middle name and last name of the user that last modified the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"modifiedDate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date that the Article was last modified on."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"link"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The link object, used to retrieve the details of the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"versionId"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article version that is returned."},"children":[]}]}]}]}]}]}],"examples":{"Single":{"description":"An additional attribute to be returned.","value":"[\"averageRating\"]"},"Multiple":{"description":"Additional attributes to be returned.","value":"[\"ownedBy\",\"ownedBy.userName\"]"},"All":{"description":"All additional attributes to be returned.","value":"[\"all\"]"}}},{"name":"workflowMilestone","in":"query","schemaId":"schema_517","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For agents with the View Author Portal or View Staging Portal actions, this determines which version of the Article is returned."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"'Authoring' returns the most recent version of an Article checked-in by an author."},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"'Staging' returns the updated version currently being processed in a workflow."},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"'Publish' returns the most recently published version."},"children":[]}]}]}]}]},{"name":"$lang","in":"query","schemaId":"schema_512","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language used for a resource. Resources available in different languages may differ from each other."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"$lang"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not passed, then the portal's default language is used."},"children":[]}]}]}]},{"name":"$pagenum","in":"query","schemaId":"schema_529","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the page number of results to be returned. Used in conjunction with $pagesize."},"children":[]}]}]}]},{"name":"$pagesize","in":"query","schemaId":"schema_530","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the number of results per page. Used in conjunction with $pagenum."},"children":[]}]}]}]}],"pointer":"/paths/~1portals~1{portalID}~1articles~1announcements/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles~1announcements/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/{portalID}/articles/announcements","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"}],"query":[{"name":"$filter[tags]","in":"query","required":false,"example":"PROD-5381","schemaId":"schema_528"},{"name":"articleResultAdditionalAttributes","in":"query","required":false,"example":["averageRating"],"schemaId":"schema_527","style":"form","explode":false},{"name":"workflowMilestone","in":"query","example":"publish","schemaId":"schema_517"},{"name":"$lang","in":"query","required":false,"example":"en-US","schemaId":"components/schemas/LegacyKBLanguageCodes"},{"name":"$pagenum","in":"query","required":false,"schemaId":"schema_529"},{"name":"$pagesize","in":"query","required":false,"schemaId":"schema_530"}],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthAnonymousCustomer","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}],"responseCodes":["200","204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/articles/announcements","href":"article/getannouncementarticles","openApiOperationId":"getAnnouncementArticles","summary":"Get Announcement Articles","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthAnonymousCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ArticleResults","exampleIds":["paths/~1portals~1{portalID}~1articles~1announcements/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1articles~1announcements/get/responses/200/content/application~1json/examples/All Attributes"]}},"schemaId":"components/schemas/ArticleResults","exampleIds":["paths/~1portals~1{portalID}~1articles~1announcements/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1articles~1announcements/get/responses/200/content/application~1json/examples/All Attributes"]},{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1announcements/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1announcements/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1announcements/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1announcements/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1announcements/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1announcements/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1announcements/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1announcements/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1announcements/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1announcements/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1announcements/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1announcements/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1announcements/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1announcements/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1articles~1announcements/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ArticleResults","exampleIds":["paths/~1portals~1{portalID}~1articles~1announcements/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1articles~1announcements/get/responses/200/content/application~1json/examples/All Attributes"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ArticleResults","exampleIds":["paths/~1portals~1{portalID}~1articles~1announcements/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1articles~1announcements/get/responses/200/content/application~1json/examples/All Attributes"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1announcements/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1announcements/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1announcements/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1announcements/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1announcements/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1announcements/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1announcements/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1announcements/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1announcements/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1announcements/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1announcements/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1announcements/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1announcements/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1announcements/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/article/getannouncementarticles"}],"panels":[]}]},"httpPath":"/portals/{portalID}/articles/announcements"},{"label":"Get Article Ratings","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/article/getarticleratings","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/article/getarticleratings","metadata":{"seo":{"title":"Get Article Ratings","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getArticleRatings","name":"Get Article Ratings","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Article Ratings","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article/getarticleratings/request/overview","deepLinkHash":"/article/getarticleratings#article/getarticleratings/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get Article Ratings API returns ratings set for an Article. These ratings help you to assess the quality, helpfulness, or relevance of an article."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]},{"schemes":[{"name":"oAuthAnonymousCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as an anonymous customer.","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true},{"name":"articleID","in":"path","schemaId":"schema_511","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An Article ID is composed of a 2-4 letter prefix followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"$lang","in":"query","schemaId":"schema_512","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language used for a resource. Resources available in different languages may differ from each other."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"$lang"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not passed, then the portal's default language is used."},"children":[]}]}]}]},{"name":"$pagenum","in":"query","schemaId":"schema_529","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the page number of results to be returned. Used in conjunction with $pagesize."},"children":[]}]}]}]},{"name":"$pagesize","in":"query","schemaId":"schema_530","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the number of results per page. Used in conjunction with $pagenum."},"children":[]}]}]}]}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/{portalID}/articles/{articleID}/ratings","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"},{"name":"articleID","in":"path","required":true,"example":"PROD-2996","schemaId":"schema_511"}],"query":[{"name":"$lang","in":"query","required":false,"example":"en-US","schemaId":"components/schemas/LegacyKBLanguageCodes"},{"name":"$pagenum","in":"query","required":false,"schemaId":"schema_529"},{"name":"$pagesize","in":"query","required":false,"schemaId":"schema_530"}],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthAnonymousCustomer","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}],"responseCodes":["200","204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/articles/{articleID}/ratings","href":"article/getarticleratings","openApiOperationId":"getArticleRatings","summary":"Get Article Ratings","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthAnonymousCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ArticleRatingsResponse","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/ArticleRatingsResponse","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/200/content/application~1json/example"]},{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ArticleRatingsResponse","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ArticleRatingsResponse","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/200/content/application~1json/example"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/article/getarticleratings"}],"panels":[]}]},"httpPath":"/portals/{portalID}/articles/{articleID}/ratings"},{"label":"Rate an Article","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/article/ratearticle","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/article/ratearticle","metadata":{"seo":{"title":"Rate an Article","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"rateArticle","name":"Rate an Article","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Rate an Article","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article/ratearticle/request/overview","deepLinkHash":"/article/ratearticle#article/ratearticle/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Rate an Article API allows a user to set a rating for an article. These ratings allow you to assess the quality, helpfulness, or relevance of an article."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]},{"schemes":[{"name":"oAuthAnonymousCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as an anonymous customer.","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true},{"name":"articleID","in":"path","schemaId":"schema_511","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An Article ID is composed of a 2-4 letter prefix followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"$lang","in":"query","schemaId":"schema_512","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language used for a resource. Resources available in different languages may differ from each other."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"$lang"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not passed, then the portal's default language is used."},"children":[]}]}]}]},{"name":"score","in":"query","schemaId":"schema_533","description":"A positive number. Each portal can have its own scoring guidelines.","required":true},{"name":"comments","in":"query","schemaId":"schema_534","description":"A comment about the Article rating.","example":"Accepted"}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/portals/{portalID}/articles/{articleID}/ratings","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"},{"name":"articleID","in":"path","required":true,"example":"PROD-2996","schemaId":"schema_511"}],"query":[{"name":"$lang","in":"query","required":false,"example":"en-US","schemaId":"components/schemas/LegacyKBLanguageCodes"},{"name":"score","in":"query","required":true,"example":10,"schemaId":"schema_533"},{"name":"comments","in":"query","required":false,"example":"Accepted","schemaId":"schema_534"}],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"schemes":[{"id":"oAuthAnonymousCustomer","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]}],"responseCodes":["201","400","401","403","404","406","415","500"],"pointer":"/portals/{portalID}/articles/{articleID}/ratings","href":"article/ratearticle","openApiOperationId":"rateArticle","summary":"Rate an Article","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"oAuthAnonymousCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Created."},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"415","description":"Incorrect Content Type Header"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"415"},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/article/ratearticle"}],"panels":[]}]},"httpPath":"/portals/{portalID}/articles/{articleID}/ratings"},{"label":"Get Pending Article Compliances","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/article/getpendingcompliancearticles","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/article/getpendingcompliancearticles","metadata":{"seo":{"title":"Get Pending Article Compliances","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getPendingComplianceArticles","name":"Get Pending Article Compliances","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1articles~1compliance~1pending/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Pending Article Compliances","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article/getpendingcompliancearticles/request/overview","deepLinkHash":"/article/getpendingcompliancearticles#article/getpendingcompliancearticles/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get Pending Article Compliances API retrieves all compliance-enabled articles in a portal that need to be read by the current user. Results are sorted in ascending order of the compliance due date."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article/getpendingcompliancearticles/request/prerequisites","deepLinkHash":"/article/getpendingcompliancearticles#article/getpendingcompliancearticles/request/prerequisites"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Prerequisites"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Article compliances that are returned must be:"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Available for the current user profile."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Displayable. An article is displayable when the \"Include in browse on portals\" property is enabled for the article."},"children":[]}]}]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"complianceArticleResultAdditionalAttributes","in":"query","schemaId":"schema_535","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The attributes of an Article to be returned "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"in addition to"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" the default list of attributes, listed below. Multiple additional attributes can be specified using a comma-separated list. Passing 'all' will return all attributes."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":4},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Default Attributes"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"These Article attributes are always returned:"},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Name"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"id"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"name"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name of the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"updateSummary"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Summary of the Article update."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"articleType"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Article Type and its attributes."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"createdBy"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID, first name, middle name and last name of the user that created the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"createdDate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date that the Article was created."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"hasAttachments"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"True: The Article has one or more attachments."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"False: The Article does not have any attachments."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"languageCode"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language code of the Article language."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"modifiedBy"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID, first name, middle name and last name of the user that last modified the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"modifiedDate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date that the Article was last modified on."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"link"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The link object, used to retrieve the details of the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"versionId"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article version that is returned."},"children":[]}]}]}]}]}]}],"examples":{"Single":{"description":"An additional attribute to be returned.","value":"[\"averageRating\"]"},"Multiple":{"description":"Additional attributes to be returned.","value":"[\"ownedBy\",\"ownedBy.userName\"]"},"All":{"description":"All additional attributes to be returned.","value":"[\"all\"]"}}},{"name":"$lang","in":"query","schemaId":"schema_512","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language used for a resource. Resources available in different languages may differ from each other."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"$lang"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not passed, then the portal's default language is used."},"children":[]}]}]}]},{"name":"$pagenum","in":"query","schemaId":"schema_529","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the page number of results to be returned. Used in conjunction with $pagesize."},"children":[]}]}]}]},{"name":"$pagesize","in":"query","schemaId":"schema_530","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the number of results per page. Used in conjunction with $pagenum."},"children":[]}]}]}]}],"pointer":"/paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/{portalID}/articles/compliance/pending","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"}],"query":[{"name":"complianceArticleResultAdditionalAttributes","in":"query","required":false,"example":["averageRating"],"schemaId":"schema_535","style":"form","explode":false},{"name":"$lang","in":"query","required":false,"example":"en-US","schemaId":"components/schemas/LegacyKBLanguageCodes"},{"name":"$pagenum","in":"query","required":false,"schemaId":"schema_529"},{"name":"$pagesize","in":"query","required":false,"schemaId":"schema_530"}],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]}],"responseCodes":["200","204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/articles/compliance/pending","href":"article/getpendingcompliancearticles","openApiOperationId":"getPendingComplianceArticles","summary":"Get Pending Article Compliances","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ComplianceArticleResults","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/200/content/application~1json/examples/Summary Article","paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/200/content/application~1json/examples/All Attributes"]}},"schemaId":"components/schemas/ComplianceArticleResults","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/200/content/application~1json/examples/Summary Article","paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/200/content/application~1json/examples/All Attributes"]},{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ComplianceArticleResults","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/200/content/application~1json/examples/Summary Article","paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/200/content/application~1json/examples/All Attributes"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ComplianceArticleResults","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/200/content/application~1json/examples/Summary Article","paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/200/content/application~1json/examples/All Attributes"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/article/getpendingcompliancearticles"}],"panels":[]}]},"httpPath":"/portals/{portalID}/articles/compliance/pending"},{"label":"Get Acknowledged Article Compliances","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/article/getacknowledgedcompliancearticles","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/article/getacknowledgedcompliancearticles","metadata":{"seo":{"title":"Get Acknowledged Article Compliances","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getAcknowledgedComplianceArticles","name":"Get Acknowledged Article Compliances","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Acknowledged Article Compliances","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article/getacknowledgedcompliancearticles/request/overview","deepLinkHash":"/article/getacknowledgedcompliancearticles#article/getacknowledgedcompliancearticles/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get Acknowledged Article Compliances API retrieves all compliance-enabled articles in a portal that have been read by the current user in the last 60 days. Results are sorted in descending order of the acknowledgement date."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article/getacknowledgedcompliancearticles/request/prerequisites","deepLinkHash":"/article/getacknowledgedcompliancearticles#article/getacknowledgedcompliancearticles/request/prerequisites"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Prerequisites"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Article compliances that are returned must be:"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Available for the current user profile."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Displayable. An article is displayable when the \"Include in browse on portals\" property is enabled for the article."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Acknowledged within the last 60 days."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Only the latest version of a republished compliance article will be shown."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Results will be sorted in descending order of acknowledgment date."},"children":[]}]}]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"complianceArticleResultAdditionalAttributes","in":"query","schemaId":"schema_535","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The attributes of an Article to be returned "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"in addition to"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" the default list of attributes, listed below. Multiple additional attributes can be specified using a comma-separated list. Passing 'all' will return all attributes."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":4},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Default Attributes"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"These Article attributes are always returned:"},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Name"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"id"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"name"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name of the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"updateSummary"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Summary of the Article update."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"articleType"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Article Type and its attributes."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"createdBy"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID, first name, middle name and last name of the user that created the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"createdDate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date that the Article was created."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"hasAttachments"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"True: The Article has one or more attachments."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"False: The Article does not have any attachments."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"languageCode"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language code of the Article language."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"modifiedBy"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID, first name, middle name and last name of the user that last modified the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"modifiedDate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date that the Article was last modified on."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"link"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The link object, used to retrieve the details of the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"versionId"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article version that is returned."},"children":[]}]}]}]}]}]}],"examples":{"Single":{"description":"An additional attribute to be returned.","value":"[\"averageRating\"]"},"Multiple":{"description":"Additional attributes to be returned.","value":"[\"ownedBy\",\"ownedBy.userName\"]"},"All":{"description":"All additional attributes to be returned.","value":"[\"all\"]"}}},{"name":"$lang","in":"query","schemaId":"schema_512","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language used for a resource. Resources available in different languages may differ from each other."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"$lang"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not passed, then the portal's default language is used."},"children":[]}]}]}]},{"name":"$pagenum","in":"query","schemaId":"schema_529","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the page number of results to be returned. Used in conjunction with $pagesize."},"children":[]}]}]}]},{"name":"$pagesize","in":"query","schemaId":"schema_530","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the number of results per page. Used in conjunction with $pagenum."},"children":[]}]}]}]}],"pointer":"/paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/{portalID}/articles/compliance/acknowledged","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"}],"query":[{"name":"complianceArticleResultAdditionalAttributes","in":"query","required":false,"example":["averageRating"],"schemaId":"schema_535","style":"form","explode":false},{"name":"$lang","in":"query","required":false,"example":"en-US","schemaId":"components/schemas/LegacyKBLanguageCodes"},{"name":"$pagenum","in":"query","required":false,"schemaId":"schema_529"},{"name":"$pagesize","in":"query","required":false,"schemaId":"schema_530"}],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]}],"responseCodes":["200","204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/articles/compliance/acknowledged","href":"article/getacknowledgedcompliancearticles","openApiOperationId":"getAcknowledgedComplianceArticles","summary":"Get Acknowledged Article Compliances","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ComplianceArticleResults","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/200/content/application~1json/examples/Summary Article","paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/200/content/application~1json/examples/All Attributes"]}},"schemaId":"components/schemas/ComplianceArticleResults","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/200/content/application~1json/examples/Summary Article","paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/200/content/application~1json/examples/All Attributes"]},{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ComplianceArticleResults","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/200/content/application~1json/examples/Summary Article","paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/200/content/application~1json/examples/All Attributes"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ComplianceArticleResults","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/200/content/application~1json/examples/Summary Article","paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/200/content/application~1json/examples/All Attributes"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/article/getacknowledgedcompliancearticles"}],"panels":[]}]},"httpPath":"/portals/{portalID}/articles/compliance/acknowledged"},{"label":"Comply With an Article","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/article/complyarticle","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/article/complyarticle","metadata":{"seo":{"title":"Comply With an Article","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"complyArticle","name":"Comply With an Article","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Comply With an Article","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article/complyarticle/request/overview","deepLinkHash":"/article/complyarticle#article/complyarticle/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Comply with an Article API allows the user to comply with an article by passing the Article's ID, which marks it as read by the user."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article/complyarticle/request/prerequisites","deepLinkHash":"/article/complyarticle#article/complyarticle/request/prerequisites"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Prerequisites"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user must be an agent and:"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Be available in the portal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Be available for the current user profile."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Have the Article's compliance policy enabled."},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the Article has Access Tags, then it must be available for the agent's current user profile."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the Article has Publish Views, then at least one edition of the Article must be available for the agent's current user profile."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true},{"name":"articleID","in":"path","schemaId":"schema_511","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An Article ID is composed of a 2-4 letter prefix followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/portals/{portalID}/articles/{articleID}/comply","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"},{"name":"articleID","in":"path","required":true,"example":"PROD-2996","schemaId":"schema_511"}],"query":[],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]}],"responseCodes":["204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/articles/{articleID}/comply","href":"article/complyarticle","openApiOperationId":"complyArticle","summary":"Comply With an Article","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/article/complyarticle"}],"panels":[]}]},"httpPath":"/portals/{portalID}/articles/{articleID}/comply"},{"label":"My Subscription","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/article/getmysubscription","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/article/getmysubscription","metadata":{"seo":{"title":"My Subscription","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getMySubscription","name":"My Subscription","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1articles~1subscribed/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"My Subscription","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article/getmysubscription/request/overview","deepLinkHash":"/article/getmysubscription#article/getmysubscription/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The My Subscription API allows authenticated users and agents to retrieve the list of articles to which they are subscribed."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles~1subscribed/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"workflowMilestone","in":"query","schemaId":"schema_517","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For agents with the View Author Portal or View Staging Portal actions, this determines which version of the Article is returned."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"'Authoring' returns the most recent version of an Article checked-in by an author."},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"'Staging' returns the updated version currently being processed in a workflow."},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"'Publish' returns the most recently published version."},"children":[]}]}]}]}]},{"name":"$pagenum","in":"query","schemaId":"schema_529","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the page number of results to be returned. Used in conjunction with $pagesize."},"children":[]}]}]}]},{"name":"$pagesize","in":"query","schemaId":"schema_530","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the number of results per page. Used in conjunction with $pagenum."},"children":[]}]}]}]},{"name":"articleResultAdditionalAttributes","in":"query","schemaId":"schema_527","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The attributes of an Article to be returned "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"in addition to"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" the default list of attributes, listed below. Multiple additional attributes can be specified using a comma-separated list. Passing 'all' will return all attributes."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":4},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Default Attributes"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"These Article attributes are always returned:"},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Name"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"id"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"name"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name of the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"articleType"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Article Type and its attributes."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"createdBy"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID, first name, middle name and last name of the user that created the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"createdDate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date that the Article was created."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"hasAttachments"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"True: The Article has one or more attachments."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"False: The Article does not have any attachments."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"languageCode"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language code of the Article language."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"modifiedBy"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID, first name, middle name and last name of the user that last modified the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"modifiedDate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date that the Article was last modified on."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"link"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The link object, used to retrieve the details of the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"versionId"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article version that is returned."},"children":[]}]}]}]}]}]}],"examples":{"Single":{"description":"An additional attribute to be returned.","value":"[\"averageRating\"]"},"Multiple":{"description":"Additional attributes to be returned.","value":"[\"ownedBy\",\"ownedBy.userName\"]"},"All":{"description":"All additional attributes to be returned.","value":"[\"all\"]"}}}],"pointer":"/paths/~1portals~1{portalID}~1articles~1subscribed/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles~1subscribed/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/{portalID}/articles/subscribed","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"}],"query":[{"name":"workflowMilestone","in":"query","example":"publish","schemaId":"schema_517"},{"name":"$pagenum","in":"query","required":false,"schemaId":"schema_529"},{"name":"$pagesize","in":"query","required":false,"schemaId":"schema_530"},{"name":"articleResultAdditionalAttributes","in":"query","required":false,"example":["averageRating"],"schemaId":"schema_527","style":"form","explode":false}],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]}],"responseCodes":["200","204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/articles/subscribed","href":"article/getmysubscription","openApiOperationId":"getMySubscription","summary":"My Subscription","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ArticleResults","exampleIds":["paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/200/content/application~1json/examples/Summary Article","paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/200/content/application~1json/examples/All Attributes"]}},"schemaId":"components/schemas/ArticleResults","exampleIds":["paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/200/content/application~1json/examples/Summary Article","paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/200/content/application~1json/examples/All Attributes"]},{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1articles~1subscribed/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ArticleResults","exampleIds":["paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/200/content/application~1json/examples/Summary Article","paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/200/content/application~1json/examples/All Attributes"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ArticleResults","exampleIds":["paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/200/content/application~1json/examples/Summary Article","paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/200/content/application~1json/examples/All Attributes"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/article/getmysubscription"}],"panels":[]}]},"httpPath":"/portals/{portalID}/articles/subscribed"},{"label":"Subscribe to an Article","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/article/subscribearticle","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/article/subscribearticle","metadata":{"seo":{"title":"Subscribe to an Article","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"subscribeArticle","name":"Subscribe to an Article","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Subscribe to an Article","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article/subscribearticle/request/overview","deepLinkHash":"/article/subscribearticle#article/subscribearticle/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Subscribe to an Article API allows eGain users, authenticated customers and agents to subscribe and receive notifications about changes to an Article."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article/subscribearticle/request/prerequisites","deepLinkHash":"/article/subscribearticle#article/subscribearticle/request/prerequisites"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Prerequisites"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Notifications are sent only if the following conditions are met:"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Article content has been modified since the last published version."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The attachment list has been modified since the last published version."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The author has checked the \"Include Article in new and modified Article list\" option while publishing the Article."},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For the Subscribe to an Article API to execute successfully:"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Article must be in the portal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user must have provided an email address."},"children":[]}]}]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article/subscribearticle/request/permissions","deepLinkHash":"/article/subscribearticle#article/subscribearticle/request/permissions"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Permissions"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Agent Permissions: The following permissions are required if the user is an agent:"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the Article has Access Tags:"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Article must be available for the agent's current user profile."},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the Article has Publish Views:"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"At least one edition of the Article must be available for the agent's current user profile."},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the Article has filters and the \"tags query parameter\" is provided:"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Article filters must match the provided tags or tag groups."},"children":[]}]}]}]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Customer Permissions: The following permissions are required if the user is a customer:"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the Article has Access Tags:"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The portal must have a default user profile"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Article must be available for the portal's default user profile."},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the Article has Publish Views:"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The portal must have a default user profile"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"At least one edition must be available for the portal's default user profile."},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the Article has filters and the \"tags query parameter\" is provided, then the Article filters must match the provided tags or tag groups."},"children":[]}]}]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true},{"name":"articleID","in":"path","schemaId":"schema_511","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An Article ID is composed of a 2-4 letter prefix followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/portals/{portalID}/articles/{articleID}/subscribe","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"},{"name":"articleID","in":"path","required":true,"example":"PROD-2996","schemaId":"schema_511"}],"query":[],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]}],"responseCodes":["204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/articles/{articleID}/subscribe","href":"article/subscribearticle","openApiOperationId":"subscribeArticle","summary":"Subscribe to an Article","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/article/subscribearticle"}],"panels":[]}]},"httpPath":"/portals/{portalID}/articles/{articleID}/subscribe"},{"label":"Unsubscribe to an Article","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/article/unsubscribearticle","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/article/unsubscribearticle","metadata":{"seo":{"title":"Unsubscribe to an Article","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"unsubscribeArticle","name":"Unsubscribe to an Article","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Unsubscribe to an Article","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article/unsubscribearticle/request/overview","deepLinkHash":"/article/unsubscribearticle#article/unsubscribearticle/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Unsubscribe to an Article API allows authenticated users and agents to unsubscribe to an Article for which they were earlier subscribed to receive change notifications."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true},{"name":"articleID","in":"path","schemaId":"schema_511","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An Article ID is composed of a 2-4 letter prefix followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"unsubscriptionToken","in":"query","schemaId":"schema_536","description":"An encrypted token that contains information about \"object/userId/userType/userProfileId\". This is used to unsubscribe the user from Article change notifications sent via email, without necessitating that the user be logged into the eGain application."}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/portals/{portalID}/articles/{articleID}/unsubscribe","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"},{"name":"articleID","in":"path","required":true,"example":"PROD-2996","schemaId":"schema_511"}],"query":[{"name":"unsubscriptionToken","in":"query","required":false,"schemaId":"schema_536"}],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]}],"responseCodes":["204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/articles/{articleID}/unsubscribe","href":"article/unsubscribearticle","openApiOperationId":"unsubscribeArticle","summary":"Unsubscribe to an Article","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/article/unsubscribearticle"}],"panels":[]}]},"httpPath":"/portals/{portalID}/articles/{articleID}/unsubscribe"},{"label":"Get Article Permissions By ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/article/getarticlepermissionsbyid","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/article/getarticlepermissionsbyid","metadata":{"seo":{"title":"Get Article Permissions By ID","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getArticlePermissionsById","name":"Get Article Permissions By ID","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Article Permissions By ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article/getarticlepermissionsbyid/request/overview","deepLinkHash":"/article/getarticlepermissionsbyid#article/getarticlepermissionsbyid/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get Article Permission by ID permits a user to retrieve permissions associated to an article."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]},{"schemes":[{"name":"oAuthAnonymousCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as an anonymous customer.","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true},{"name":"articleID","in":"path","schemaId":"schema_511","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An Article ID is composed of a 2-4 letter prefix followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/{portalID}/articles/{articleID}/permissions","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"},{"name":"articleID","in":"path","required":true,"example":"PROD-2996","schemaId":"schema_511"}],"query":[],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthAnonymousCustomer","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}],"responseCodes":["200","204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/articles/{articleID}/permissions","href":"article/getarticlepermissionsbyid","openApiOperationId":"getArticlePermissionsById","summary":"Get Article Permissions By ID","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthAnonymousCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ArticlePermissionsResult","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/ArticlePermissionsResult","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/200/content/application~1json/example"]},{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ArticlePermissionsResult","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ArticlePermissionsResult","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/200/content/application~1json/example"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/article/getarticlepermissionsbyid"}],"panels":[]}]},"httpPath":"/portals/{portalID}/articles/{articleID}/permissions"},{"label":"Get Article Personalization Details","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/article/getarticlepersonalization","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/article/getarticlepersonalization","metadata":{"seo":{"title":"Get Article Personalization Details","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getArticlePersonalization","name":"Get Article Personalization Details","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Article Personalization Details","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article/getarticlepersonalization/request/overview","deepLinkHash":"/article/getarticlepersonalization#article/getarticlepersonalization/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get Article Personalization Details API allows agents to retrieve the personalization tag details of an Article."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true},{"name":"articleID","in":"path","schemaId":"schema_511","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An Article ID is composed of a 2-4 letter prefix followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"$lang","in":"query","schemaId":"schema_512","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language used for a resource. Resources available in different languages may differ from each other."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"$lang"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not passed, then the portal's default language is used."},"children":[]}]}]}]},{"name":"workflowMilestone","in":"query","schemaId":"schema_537","description":"Workflow milestone of the Article"}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/{portalID}/articles/{articleID}/personalization","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"},{"name":"articleID","in":"path","required":true,"example":"PROD-2996","schemaId":"schema_511"}],"query":[{"name":"$lang","in":"query","required":false,"example":"en-US","schemaId":"components/schemas/LegacyKBLanguageCodes"},{"name":"workflowMilestone","in":"query","required":false,"example":"publish","schemaId":"schema_537"}],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]}],"responseCodes":["200","204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/articles/{articleID}/personalization","href":"article/getarticlepersonalization","openApiOperationId":"getArticlePersonalization","summary":"Get Article Personalization Details","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Personalization","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/Personalization","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/200/content/application~1json/example"]},{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/400/content/application~1json/examples/Invalid Article Id","paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/400/content/application~1json/examples/Invalid Portal Id","paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/400/content/application~1json/examples/Invalid workflow milestone","paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/400/content/application~1json/examples/Invalid $lang"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/400/content/application~1json/examples/Invalid Article Id","paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/400/content/application~1json/examples/Invalid Portal Id","paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/400/content/application~1json/examples/Invalid workflow milestone","paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/400/content/application~1json/examples/Invalid $lang"]},{"code":"401","description":"Unauthorized Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/401/content/application~1json/example"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/401/content/application~1json/example"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/403/content/application~1json/examples/User Not Allowed","paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/403/content/application~1json/examples/Customer Not Allowed on Portal","paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/403/content/application~1json/examples/Milestone not assigned","paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/403/content/application~1json/examples/Personalization disabled"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/403/content/application~1json/examples/User Not Allowed","paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/403/content/application~1json/examples/Customer Not Allowed on Portal","paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/403/content/application~1json/examples/Milestone not assigned","paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/403/content/application~1json/examples/Personalization disabled"]},{"code":"404","description":"Not found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/404/content/application~1json/examples/Portal Id Not Found","paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/404/content/application~1json/examples/Article Id Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/404/content/application~1json/examples/Portal Id Not Found","paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/404/content/application~1json/examples/Article Id Not Found"]},{"code":"406","description":"Unsupported Accept-Language value in Header.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/406/content/application~1json/example"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/406/content/application~1json/example"]},{"code":"500","description":"Internal Server Error. Returned when unexpected error is encountered","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/500/content/application~1json/example"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/500/content/application~1json/example"]}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/Personalization","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Personalization","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/200/content/application~1json/example"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/400/content/application~1json/examples/Invalid Article Id","paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/400/content/application~1json/examples/Invalid Portal Id","paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/400/content/application~1json/examples/Invalid workflow milestone","paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/400/content/application~1json/examples/Invalid $lang"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/400/content/application~1json/examples/Invalid Article Id","paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/400/content/application~1json/examples/Invalid Portal Id","paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/400/content/application~1json/examples/Invalid workflow milestone","paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/400/content/application~1json/examples/Invalid $lang"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/401/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/401/content/application~1json/example"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/403/content/application~1json/examples/User Not Allowed","paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/403/content/application~1json/examples/Customer Not Allowed on Portal","paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/403/content/application~1json/examples/Milestone not assigned","paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/403/content/application~1json/examples/Personalization disabled"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/403/content/application~1json/examples/User Not Allowed","paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/403/content/application~1json/examples/Customer Not Allowed on Portal","paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/403/content/application~1json/examples/Milestone not assigned","paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/403/content/application~1json/examples/Personalization disabled"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/404/content/application~1json/examples/Portal Id Not Found","paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/404/content/application~1json/examples/Article Id Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/404/content/application~1json/examples/Portal Id Not Found","paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/404/content/application~1json/examples/Article Id Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/406/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/406/content/application~1json/example"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/500/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/500/content/application~1json/example"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/article/getarticlepersonalization"}],"panels":[]}]},"httpPath":"/portals/{portalID}/articles/{articleID}/personalization"}],"content":{"contentType":"group","meta":{"name":"Article"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Article","showPageActions":true},{"nodeType":"markdoc","content":"Article APIs"}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/portals/{portalID}/articles/{articleID}","summary":"Get Article by ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/article/getarticlebyid","deprecated":false},{"title":"/articles/{articleID}/witheditions","summary":"Get Article By ID with Editions","prefix":{"name":"get","color":"get"},"badges":[],"link":"/article/getarticlebyidwitheditions","deprecated":false},{"title":"/articles/{articleID}/editions/{publishViewId}","summary":"Get Article Edition Details","prefix":{"name":"get","color":"get"},"badges":[],"link":"/article/getarticleeditiondetails","deprecated":false},{"title":"/articletypes","summary":"Get All Article Types in a Department","prefix":{"name":"get","color":"get"},"badges":[],"link":"/article/getallarticletypes","deprecated":false},{"title":"/portals/{portalID}/articles/{articleID}/addtoreply","summary":"Add Article to Reply","prefix":{"name":"put","color":"put"},"badges":[],"link":"/article/addtoreply","deprecated":false},{"title":"/portals/{portalID}/articles/{articleID}/addasreference","summary":"Add as Reference","prefix":{"name":"put","color":"put"},"badges":[],"link":"/article/addasreference","deprecated":false},{"title":"/portals/{portalID}/articles","summary":"Get Articles in Topic","prefix":{"name":"get","color":"get"},"badges":[],"link":"/article/getarticlesintopic","deprecated":false},{"title":"/articles/attachments/{attachmentID}","summary":"Get Article Attachment By ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/article/getarticleattachmentbyid","deprecated":false},{"title":"/portals/{portalID}/articles/attachments/{attachmentID}","summary":"Get Article Attachment in Portal","prefix":{"name":"get","color":"get"},"badges":[],"link":"/article/getattachmentbyidinportal","deprecated":false},{"title":"/portals/{portalID}/articles/{articleID}/related","summary":"Get Related Articles","prefix":{"name":"get","color":"get"},"badges":[],"link":"/article/getrelatedarticles","deprecated":false},{"title":"/portals/{portalID}/articles/announcements","summary":"Get Announcement Articles","prefix":{"name":"get","color":"get"},"badges":[],"link":"/article/getannouncementarticles","deprecated":false},{"title":"/portals/{portalID}/articles/{articleID}/ratings","summary":"Get Article Ratings","prefix":{"name":"get","color":"get"},"badges":[],"link":"/article/getarticleratings","deprecated":false},{"title":"/portals/{portalID}/articles/{articleID}/ratings","summary":"Rate an Article","prefix":{"name":"put","color":"put"},"badges":[],"link":"/article/ratearticle","deprecated":false},{"title":"/portals/{portalID}/articles/compliance/pending","summary":"Get Pending Article Compliances","prefix":{"name":"get","color":"get"},"badges":[],"link":"/article/getpendingcompliancearticles","deprecated":false},{"title":"/portals/{portalID}/articles/compliance/acknowledged","summary":"Get Acknowledged Article Compliances","prefix":{"name":"get","color":"get"},"badges":[],"link":"/article/getacknowledgedcompliancearticles","deprecated":false},{"title":"/portals/{portalID}/articles/{articleID}/comply","summary":"Comply With an Article","prefix":{"name":"put","color":"put"},"badges":[],"link":"/article/complyarticle","deprecated":false},{"title":"/portals/{portalID}/articles/subscribed","summary":"My Subscription","prefix":{"name":"get","color":"get"},"badges":[],"link":"/article/getmysubscription","deprecated":false},{"title":"/portals/{portalID}/articles/{articleID}/subscribe","summary":"Subscribe to an Article","prefix":{"name":"put","color":"put"},"badges":[],"link":"/article/subscribearticle","deprecated":false},{"title":"/portals/{portalID}/articles/{articleID}/unsubscribe","summary":"Unsubscribe to an Article","prefix":{"name":"put","color":"put"},"badges":[],"link":"/article/unsubscribearticle","deprecated":false},{"title":"/portals/{portalID}/articles/{articleID}/permissions","summary":"Get Article Permissions By ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/article/getarticlepermissionsbyid","deprecated":false},{"title":"/portals/{portalID}/articles/{articleID}/personalization","summary":"Get Article Personalization Details","prefix":{"name":"get","color":"get"},"badges":[],"link":"/article/getarticlepersonalization","deprecated":false}]}]}]}]}},{"type":"group","label":"Article Lists","link":"/apis/v4/knowledge/portalmgr/api-bundled/article-lists","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/article-lists","items":[{"label":"Get All Article Lists","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/article-lists/getallarticlelists","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/article-lists/getallarticlelists","metadata":{"seo":{"title":"Get All Article Lists","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getAllArticleLists","name":"Get All Article Lists","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1articlelists/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get All Article Lists","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article-lists/getallarticlelists/request/overview","deepLinkHash":"/article-lists/getallarticlelists#article-lists/getallarticlelists/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get All Article Lists API returns all quick Article lists that are configured for a portal."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]},{"schemes":[{"name":"oAuthAnonymousCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as an anonymous customer.","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1articlelists/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"$lang","in":"query","schemaId":"schema_512","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language used for a resource. Resources available in different languages may differ from each other."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"$lang"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not passed, then the portal's default language is used."},"children":[]}]}]}]}],"pointer":"/paths/~1portals~1{portalID}~1articlelists/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1articlelists/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/{portalID}/articlelists","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"}],"query":[{"name":"$lang","in":"query","required":false,"example":"en-US","schemaId":"components/schemas/LegacyKBLanguageCodes"}],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthAnonymousCustomer","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}],"responseCodes":["200","204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/articlelists","href":"article-lists/getallarticlelists","openApiOperationId":"getAllArticleLists","summary":"Get All Article Lists","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthAnonymousCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ArticleListsResult","exampleIds":["paths/~1portals~1{portalID}~1articlelists/get/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/ArticleListsResult","exampleIds":["paths/~1portals~1{portalID}~1articlelists/get/responses/200/content/application~1json/example"]},{"code":"204","description":"No Article Lists Configured in Portal"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articlelists/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articlelists/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1articlelists/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ArticleListsResult","exampleIds":["paths/~1portals~1{portalID}~1articlelists/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ArticleListsResult","exampleIds":["paths/~1portals~1{portalID}~1articlelists/get/responses/200/content/application~1json/example"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articlelists/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articlelists/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/article-lists/getallarticlelists"}],"panels":[]}]},"httpPath":"/portals/{portalID}/articlelists"},{"label":"Get Article List by ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/article-lists/getarticlelistdetails","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/article-lists/getarticlelistdetails","metadata":{"seo":{"title":"Get Article List by ID","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getArticleListDetails","name":"Get Article List by ID","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1articlelists~1{listID}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Article List by ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"article-lists/getarticlelistdetails/request/overview","deepLinkHash":"/article-lists/getarticlelistdetails#article-lists/getarticlelistdetails/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get Article Lists by ID API returns the details of a quick access Article list that is configured for a portal."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Only those articles in the quick access list articles are returned and are:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Available for current user profile."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Tagged with at least one of the provided tags, if tags query parameter is provided."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Displayable. An Article is displayable if \"Include in browse on portals\" property is enable for the Article."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]},{"schemes":[{"name":"oAuthAnonymousCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as an anonymous customer.","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true},{"name":"listID","in":"path","schemaId":"schema_538","description":"The ID of the list to be returned.","required":true}],"pointer":"/paths/~1portals~1{portalID}~1articlelists~1{listID}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"$filter[topicId]","in":"query","schemaId":"schema_516","description":"The ID of the topic. It is used to restrict to a specific topic.","example":"PROD-1067"},{"name":"articleResultAdditionalAttributes","in":"query","schemaId":"schema_527","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The attributes of an Article to be returned "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"in addition to"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" the default list of attributes, listed below. Multiple additional attributes can be specified using a comma-separated list. Passing 'all' will return all attributes."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":4},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Default Attributes"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"These Article attributes are always returned:"},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Name"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"id"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"name"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name of the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"articleType"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Article Type and its attributes."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"createdBy"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID, first name, middle name and last name of the user that created the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"createdDate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date that the Article was created."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"hasAttachments"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"True: The Article has one or more attachments."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"False: The Article does not have any attachments."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"languageCode"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language code of the Article language."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"modifiedBy"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID, first name, middle name and last name of the user that last modified the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"modifiedDate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date that the Article was last modified on."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"link"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The link object, used to retrieve the details of the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"versionId"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article version that is returned."},"children":[]}]}]}]}]}]}],"examples":{"Single":{"description":"An additional attribute to be returned.","value":"[\"averageRating\"]"},"Multiple":{"description":"Additional attributes to be returned.","value":"[\"ownedBy\",\"ownedBy.userName\"]"},"All":{"description":"All additional attributes to be returned.","value":"[\"all\"]"}}},{"name":"$lang","in":"query","schemaId":"schema_512","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language used for a resource. Resources available in different languages may differ from each other."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"$lang"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not passed, then the portal's default language is used."},"children":[]}]}]}]}],"pointer":"/paths/~1portals~1{portalID}~1articlelists~1{listID}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1articlelists~1{listID}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/{portalID}/articlelists/{listID}","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"},{"name":"listID","in":"path","required":true,"example":"PROD-12345","schemaId":"schema_538"}],"query":[{"name":"$filter[topicId]","in":"query","required":false,"example":"PROD-1067","schemaId":"schema_516"},{"name":"articleResultAdditionalAttributes","in":"query","required":false,"example":["averageRating"],"schemaId":"schema_527","style":"form","explode":false},{"name":"$lang","in":"query","required":false,"example":"en-US","schemaId":"components/schemas/LegacyKBLanguageCodes"}],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthAnonymousCustomer","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}],"responseCodes":["200","204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/articlelists/{listID}","href":"article-lists/getarticlelistdetails","openApiOperationId":"getArticleListDetails","summary":"Get Article List by ID","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthAnonymousCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ArticleList","exampleIds":["paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/200/content/application~1json/examples/All Attributes"]}},"schemaId":"components/schemas/ArticleList","exampleIds":["paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/200/content/application~1json/examples/All Attributes"]},{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ArticleList","exampleIds":["paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/200/content/application~1json/examples/All Attributes"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ArticleList","exampleIds":["paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/200/content/application~1json/examples/All Attributes"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/article-lists/getarticlelistdetails"}],"panels":[]}]},"httpPath":"/portals/{portalID}/articlelists/{listID}"}],"content":{"contentType":"group","meta":{"name":"Article Lists"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Article Lists","showPageActions":true},{"nodeType":"markdoc","content":"Article List APIs"}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/portals/{portalID}/articlelists","summary":"Get All Article Lists","prefix":{"name":"get","color":"get"},"badges":[],"link":"/article-lists/getallarticlelists","deprecated":false},{"title":"/portals/{portalID}/articlelists/{listID}","summary":"Get Article List by ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/article-lists/getarticlelistdetails","deprecated":false}]}]}]}]}},{"type":"group","label":"Bookmark","link":"/apis/v4/knowledge/portalmgr/api-bundled/bookmark","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/bookmark","items":[{"label":"Add a Bookmark","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/bookmark/addbookmark","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/bookmark/addbookmark","metadata":{"seo":{"title":"Add a Bookmark","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"addbookmark","name":"Add a Bookmark","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1bookmarks/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Add a Bookmark","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"bookmark/addbookmark/request/overview","deepLinkHash":"/bookmark/addbookmark#bookmark/addbookmark/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Add a Bookmark API adds a bookmark from a portal."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1bookmarks/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Content-Type","in":"header","schemaId":"schema_525","description":"The media type sent by the client.","required":true},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1bookmarks/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateBookmark","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/post/requestBody/content/application~1json/examples/Bookmark Topic With Bookmark Name Provided","paths/~1portals~1{portalID}~1bookmarks/post/requestBody/content/application~1json/examples/Bookmark Article Without Bookmark Name"]}},"schemaId":"components/schemas/CreateBookmark","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/post/requestBody/content/application~1json/examples/Bookmark Topic With Bookmark Name Provided","paths/~1portals~1{portalID}~1bookmarks/post/requestBody/content/application~1json/examples/Bookmark Article Without Bookmark Name"],"pointer":"/paths/~1portals~1{portalID}~1bookmarks/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/portals/{portalID}/bookmarks","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"}],"query":[],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Content-Type","in":"header","required":true,"schemaId":"schema_525"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateBookmark","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/post/requestBody/content/application~1json/examples/Bookmark Topic With Bookmark Name Provided","paths/~1portals~1{portalID}~1bookmarks/post/requestBody/content/application~1json/examples/Bookmark Article Without Bookmark Name"]}},"responseCodes":["201","400","401","403","404","406","415","500"],"pointer":"/portals/{portalID}/bookmarks","href":"bookmark/addbookmark","openApiOperationId":"addbookmark","summary":"Add a Bookmark","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"schemaId":"components/schemas/CreateBookmark","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/post/requestBody/content/application~1json/examples/Bookmark Topic With Bookmark Name Provided","paths/~1portals~1{portalID}~1bookmarks/post/requestBody/content/application~1json/examples/Bookmark Article Without Bookmark Name"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateBookmark","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/post/requestBody/content/application~1json/examples/Bookmark Topic With Bookmark Name Provided","paths/~1portals~1{portalID}~1bookmarks/post/requestBody/content/application~1json/examples/Bookmark Article Without Bookmark Name"]}},"examples":[{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Created"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1bookmarks/post/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1bookmarks/post/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/post/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/post/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/post/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/post/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/post/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/post/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/post/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/post/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"415","description":"Incorrect Content Type Header"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/post/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/post/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1bookmarks/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1bookmarks/post/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1bookmarks/post/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/post/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/post/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/post/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/post/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/post/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/post/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/post/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/post/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"415"},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/post/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/post/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bookmark/addbookmark"}],"panels":[]}]},"httpPath":"/portals/{portalID}/bookmarks"},{"label":"Get All Bookmarks for a Portal","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/bookmark/getbookmark","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/bookmark/getbookmark","metadata":{"seo":{"title":"Get All Bookmarks for a Portal","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getbookmark","name":"Get All Bookmarks for a Portal","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1bookmarks/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get All Bookmarks for a Portal","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"bookmark/getbookmark/request/overview","deepLinkHash":"/bookmark/getbookmark#bookmark/getbookmark/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get All Bookmarks for a Portal API returns all bookmarks for a portal. Only the topic bookmarks that are available in the scope of the portal are returned."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"bookmark/getbookmark/request/permissions","deepLinkHash":"/bookmark/getbookmark#bookmark/getbookmark/request/permissions"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Permissions"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user must have the "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"__"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"View Author Portal"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" action to access the authoring view."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The user must have the "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"__"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"View Staging Portal"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" action to access the staging view."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1bookmarks/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1bookmarks/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/{portalID}/bookmarks","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"}],"query":[],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]}],"responseCodes":["200","204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/bookmarks","href":"bookmark/getbookmark","openApiOperationId":"getbookmark","summary":"Get All Bookmarks for a Portal","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BookmarkResult","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/get/responses/200/content/application~1json/examples/Summary Attributes"]}},"schemaId":"components/schemas/BookmarkResult","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/get/responses/200/content/application~1json/examples/Summary Attributes"]},{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1bookmarks/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1bookmarks/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1bookmarks/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/BookmarkResult","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/get/responses/200/content/application~1json/examples/Summary Attributes"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/BookmarkResult","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/get/responses/200/content/application~1json/examples/Summary Attributes"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1bookmarks/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1bookmarks/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bookmark/getbookmark"}],"panels":[]}]},"httpPath":"/portals/{portalID}/bookmarks"},{"label":"Delete a Bookmark","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/bookmark/deletebookmark","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/bookmark/deletebookmark","metadata":{"seo":{"title":"Delete a Bookmark","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deletebookmark","name":"Delete a Bookmark","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete a Bookmark","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"bookmark/deletebookmark/request/overview","deepLinkHash":"/bookmark/deletebookmark#bookmark/deletebookmark/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Delete a Bookmark API deletes a bookmark from a portal."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true},{"name":"bookmarkID","in":"path","schemaId":"schema_539","description":"The ID of the bookmark.","required":true}],"pointer":"/paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/portals/{portalID}/bookmarks/{bookmarkID}","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"},{"name":"bookmarkID","in":"path","required":true,"example":"4759","schemaId":"schema_539"}],"query":[],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]}],"responseCodes":["204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/bookmarks/{bookmarkID}","href":"bookmark/deletebookmark","openApiOperationId":"deletebookmark","summary":"Delete a Bookmark","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"Bookmark successfully deleted."},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/bookmark/deletebookmark"}],"panels":[]}]},"httpPath":"/portals/{portalID}/bookmarks/{bookmarkID}"}],"content":{"contentType":"group","meta":{"name":"Bookmark"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Bookmark","showPageActions":true},{"nodeType":"markdoc","content":"Bookmark APIs"}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/portals/{portalID}/bookmarks","summary":"Add a Bookmark","prefix":{"name":"post","color":"post"},"badges":[],"link":"/bookmark/addbookmark","deprecated":false},{"title":"/portals/{portalID}/bookmarks","summary":"Get All Bookmarks for a Portal","prefix":{"name":"get","color":"get"},"badges":[],"link":"/bookmark/getbookmark","deprecated":false},{"title":"/portals/{portalID}/bookmarks/{bookmarkID}","summary":"Delete a Bookmark","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/bookmark/deletebookmark","deprecated":false}]}]}]}]}},{"type":"group","label":"Guided Help","link":"/apis/v4/knowledge/portalmgr/api-bundled/guided-help","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/guided-help","items":[{"label":"Get Available Casebases Releases","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/guided-help/getallcasebasesreleases","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/guided-help/getallcasebasesreleases","metadata":{"seo":{"title":"Get Available Casebases Releases","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getAllCasebasesReleases","name":"Get Available Casebases Releases","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1gh~1casebasereleases/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Available Casebases Releases","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"guided-help/getallcasebasesreleases/request/overview","deepLinkHash":"/guided-help/getallcasebasesreleases#guided-help/getallcasebasesreleases/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get Available Casebases Releases API retrieves all Casebase Releases associated with a portal."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]},{"schemes":[{"name":"oAuthAnonymousCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as an anonymous customer.","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1gh~1casebasereleases/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"$lang","in":"query","schemaId":"schema_512","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language used for a resource. Resources available in different languages may differ from each other."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"$lang"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not passed, then the portal's default language is used."},"children":[]}]}]}]},{"name":"$pagenum","in":"query","schemaId":"schema_529","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the page number of results to be returned. Used in conjunction with $pagesize."},"children":[]}]}]}]},{"name":"$pagesize","in":"query","schemaId":"schema_530","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the number of results per page. Used in conjunction with $pagenum."},"children":[]}]}]}]}],"pointer":"/paths/~1portals~1{portalID}~1gh~1casebasereleases/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1gh~1casebasereleases/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/{portalID}/gh/casebasereleases","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"}],"query":[{"name":"$lang","in":"query","required":false,"example":"en-US","schemaId":"components/schemas/LegacyKBLanguageCodes"},{"name":"$pagenum","in":"query","required":false,"schemaId":"schema_529"},{"name":"$pagesize","in":"query","required":false,"schemaId":"schema_530"}],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthAnonymousCustomer","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}],"responseCodes":["200","204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/gh/casebasereleases","href":"guided-help/getallcasebasesreleases","openApiOperationId":"getAllCasebasesReleases","summary":"Get Available Casebases Releases","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthAnonymousCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CasebaseResult","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/CasebaseResult","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/200/content/application~1json/example"]},{"code":"204","description":"When no Casebase Release is associated with the portal."},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/CasebaseResult","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CasebaseResult","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/200/content/application~1json/example"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/guided-help/getallcasebasesreleases"}],"panels":[]}]},"httpPath":"/portals/{portalID}/gh/casebasereleases"},{"label":"Get Details of a Casebase Release","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/guided-help/getcasebasereleasebyid","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/guided-help/getcasebasereleasebyid","metadata":{"seo":{"title":"Get Details of a Casebase Release","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getCasebaseReleaseById","name":"Get Details of a Casebase Release","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Details of a Casebase Release","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"guided-help/getcasebasereleasebyid/request/overview","deepLinkHash":"/guided-help/getcasebasereleasebyid#guided-help/getcasebasereleasebyid/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get Details of a Casebase Release API retrieves details of Casebase Release."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]},{"schemes":[{"name":"oAuthAnonymousCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as an anonymous customer.","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true},{"name":"casebaseReleaseID","in":"path","schemaId":"schema_540","description":"The numerical ID of the Casebase Release for which details is to be fetched.","required":true}],"pointer":"/paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"$lang","in":"query","schemaId":"schema_512","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language used for a resource. Resources available in different languages may differ from each other."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"$lang"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not passed, then the portal's default language is used."},"children":[]}]}]}]},{"name":"languages","in":"query","schemaId":"schema_541","description":"Display langages of Casebase Releases."}],"pointer":"/paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}}],"pointer":"/paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/{portalID}/gh/casebasereleases/{casebaseReleaseID}","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"},{"name":"casebaseReleaseID","in":"path","required":true,"example":"202201000000002","schemaId":"schema_540"}],"query":[{"name":"$lang","in":"query","required":false,"example":"en-US","schemaId":"components/schemas/LegacyKBLanguageCodes"},{"name":"languages","in":"query","schemaId":"schema_541"}],"querystring":[],"header":[{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthAnonymousCustomer","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}],"responseCodes":["200","204","400","401","403","404","406","412","500"],"pointer":"/portals/{portalID}/gh/casebasereleases/{casebaseReleaseID}","href":"guided-help/getcasebasereleasebyid","openApiOperationId":"getCasebaseReleaseById","summary":"Get Details of a Casebase Release","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthAnonymousCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CasebaseResult","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/CasebaseResult","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/200/content/application~1json/example"]},{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"412","description":"Precondition Failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/412/content/application~1json/examples/Precondition Failed"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/412/content/application~1json/examples/Precondition Failed"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/CasebaseResult","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CasebaseResult","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/200/content/application~1json/example"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"412","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/412/content/application~1json/examples/Precondition Failed"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/412/content/application~1json/examples/Precondition Failed"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/guided-help/getcasebasereleasebyid"}],"panels":[]}]},"httpPath":"/portals/{portalID}/gh/casebasereleases/{casebaseReleaseID}"},{"label":"Get Cluster Details of a Casebase Release","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/guided-help/getclusterbycasebasereleaseid","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/guided-help/getclusterbycasebasereleaseid","metadata":{"seo":{"title":"Get Cluster Details of a Casebase Release","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getClusterByCasebaseReleaseId","name":"Get Cluster Details of a Casebase Release","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Cluster Details of a Casebase Release","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"guided-help/getclusterbycasebasereleaseid/request/overview","deepLinkHash":"/guided-help/getclusterbycasebasereleaseid#guided-help/getclusterbycasebasereleaseid/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get Cluster Details of a Casebase Release API retrieves cluster details of Casebase Release."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]},{"schemes":[{"name":"oAuthAnonymousCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as an anonymous customer.","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true},{"name":"casebaseReleaseID","in":"path","schemaId":"schema_540","description":"The numerical ID of the Casebase Release for which details is to be fetched.","required":true}],"pointer":"/paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"$lang","in":"query","schemaId":"schema_512","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language used for a resource. Resources available in different languages may differ from each other."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"$lang"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not passed, then the portal's default language is used."},"children":[]}]}]}]},{"name":"$pagenum","in":"query","schemaId":"schema_529","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the page number of results to be returned. Used in conjunction with $pagesize."},"children":[]}]}]}]},{"name":"$pagesize","in":"query","schemaId":"schema_530","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the number of results per page. Used in conjunction with $pagenum."},"children":[]}]}]}]}],"pointer":"/paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}}],"pointer":"/paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/{portalID}/gh/casebasereleases/{casebaseReleaseID}/clusters","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"},{"name":"casebaseReleaseID","in":"path","required":true,"example":"202201000000002","schemaId":"schema_540"}],"query":[{"name":"$lang","in":"query","required":false,"example":"en-US","schemaId":"components/schemas/LegacyKBLanguageCodes"},{"name":"$pagenum","in":"query","required":false,"schemaId":"schema_529"},{"name":"$pagesize","in":"query","required":false,"schemaId":"schema_530"}],"querystring":[],"header":[{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthAnonymousCustomer","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}],"responseCodes":["200","204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/gh/casebasereleases/{casebaseReleaseID}/clusters","href":"guided-help/getclusterbycasebasereleaseid","openApiOperationId":"getClusterByCasebaseReleaseId","summary":"Get Cluster Details of a Casebase Release","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthAnonymousCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ClusterResults","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/ClusterResults","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/200/content/application~1json/example"]},{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ClusterResults","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ClusterResults","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/200/content/application~1json/example"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/guided-help/getclusterbycasebasereleaseid"}],"panels":[]}]},"httpPath":"/portals/{portalID}/gh/casebasereleases/{casebaseReleaseID}/clusters"},{"label":"Get All Profiles Available in Portal","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/guided-help/getallprofilesinportal","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/guided-help/getallprofilesinportal","metadata":{"seo":{"title":"Get All Profiles Available in Portal","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getAllProfilesInPortal","name":"Get All Profiles Available in Portal","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1gh~1profiles/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get All Profiles Available in Portal","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"guided-help/getallprofilesinportal/request/overview","deepLinkHash":"/guided-help/getallprofilesinportal#guided-help/getallprofilesinportal/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get All Profiles Available in Portal API retrieves all Guided Help profiles associated with a portal."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]},{"schemes":[{"name":"oAuthAnonymousCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as an anonymous customer.","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1gh~1profiles/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"filter[casebaseRelease]","in":"query","schemaId":"schema_540","description":"Filter by Casebase Release"},{"name":"$pagenum","in":"query","schemaId":"schema_529","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the page number of results to be returned. Used in conjunction with $pagesize."},"children":[]}]}]}]},{"name":"$pagesize","in":"query","schemaId":"schema_530","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the number of results per page. Used in conjunction with $pagenum."},"children":[]}]}]}]}],"pointer":"/paths/~1portals~1{portalID}~1gh~1profiles/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}}],"pointer":"/paths/~1portals~1{portalID}~1gh~1profiles/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/{portalID}/gh/profiles","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"}],"query":[{"name":"filter[casebaseRelease]","in":"query","required":false,"example":"202201000000002","schemaId":"schema_540"},{"name":"$pagenum","in":"query","required":false,"schemaId":"schema_529"},{"name":"$pagesize","in":"query","required":false,"schemaId":"schema_530"}],"querystring":[],"header":[{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthAnonymousCustomer","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}],"responseCodes":["200","204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/gh/profiles","href":"guided-help/getallprofilesinportal","openApiOperationId":"getAllProfilesInPortal","summary":"Get All Profiles Available in Portal","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthAnonymousCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProfileResult","exampleIds":["paths/~1portals~1{portalID}~1gh~1profiles/get/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/ProfileResult","exampleIds":["paths/~1portals~1{portalID}~1gh~1profiles/get/responses/200/content/application~1json/example"]},{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1profiles/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1profiles/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1profiles/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1profiles/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1profiles/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1profiles/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1profiles/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1profiles/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1profiles/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1profiles/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1profiles/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1profiles/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1profiles/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1profiles/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1gh~1profiles/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ProfileResult","exampleIds":["paths/~1portals~1{portalID}~1gh~1profiles/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ProfileResult","exampleIds":["paths/~1portals~1{portalID}~1gh~1profiles/get/responses/200/content/application~1json/example"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1profiles/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1profiles/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1profiles/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1profiles/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1profiles/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1profiles/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1profiles/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1profiles/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1profiles/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1profiles/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1profiles/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1profiles/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1profiles/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1profiles/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/guided-help/getallprofilesinportal"}],"panels":[]}]},"httpPath":"/portals/{portalID}/gh/profiles"},{"label":"Start a Guided Help Search","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/guided-help/startghsearch","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/guided-help/startghsearch","metadata":{"seo":{"title":"Start a Guided Help Search","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"startGHSearch","name":"Start a Guided Help Search","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1gh~1search/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Start a Guided Help Search","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"guided-help/startghsearch/request/overview","deepLinkHash":"/guided-help/startghsearch#guided-help/startghsearch/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Start a Guided Help search can be used to start a search session in the Guided Help."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A Guided Help profile can also be specified while starting the session and it is used to filter the results of search."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If this is not passed in the request, the default profile of the portal is used. Questions can also be answered at time of starting the search session."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A Guided Help search session can be started in following ways:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Launch session for a specific Casebase Release."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Launch session for a Casebase and specify the release type."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use a Guided Help session Article and pass the required session parameters."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"guided-help/startghsearch/request/prerequisites","deepLinkHash":"/guided-help/startghsearch#guided-help/startghsearch/request/prerequisites"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Prerequisites"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A Guided Help profile must be assigned to the user."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Casebase Release passed in the request must be associated with the portal passed in URI."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]},{"schemes":[{"name":"oAuthAnonymousCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as an anonymous customer.","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1gh~1search/post/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"$lang","in":"query","schemaId":"schema_512","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language used for a resource. Resources available in different languages may differ from each other."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"$lang"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not passed, then the portal's default language is used."},"children":[]}]}]}]},{"name":"ghCustomAdditionalAttributes","in":"query","schemaId":"schema_542","examples":{"Single":{"description":"A user-defined custom attribute.","value":"question.custom.score"},"Multiple":{"description":"Multiple user-defined custom attributes.","value":"question.custom.score,question.custom.test"}}}],"pointer":"/paths/~1portals~1{portalID}~1gh~1search/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true},{"name":"Content-Type","in":"header","schemaId":"schema_525","description":"The media type sent by the client.","required":true}],"pointer":"/paths/~1portals~1{portalID}~1gh~1search/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/GHSearchRequest","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/requestBody/content/application~1json/examples/Start Search With Casebase","paths/~1portals~1{portalID}~1gh~1search/post/requestBody/content/application~1json/examples/Start Search With GHS ArticleId"]}},"schemaId":"components/schemas/GHSearchRequest","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/requestBody/content/application~1json/examples/Start Search With Casebase","paths/~1portals~1{portalID}~1gh~1search/post/requestBody/content/application~1json/examples/Start Search With GHS ArticleId"],"pointer":"/paths/~1portals~1{portalID}~1gh~1search/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/portals/{portalID}/gh/search","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"}],"query":[{"name":"$lang","in":"query","required":false,"example":"en-US","schemaId":"components/schemas/LegacyKBLanguageCodes"},{"name":"ghCustomAdditionalAttributes","in":"query","required":false,"example":"question.custom.score","schemaId":"schema_542"}],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"},{"name":"Content-Type","in":"header","required":true,"schemaId":"schema_525"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"schemes":[{"id":"oAuthAnonymousCustomer","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/GHSearchRequest","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/requestBody/content/application~1json/examples/Start Search With Casebase","paths/~1portals~1{portalID}~1gh~1search/post/requestBody/content/application~1json/examples/Start Search With GHS ArticleId"]}},"responseCodes":["200","400","401","403","404","406","415","429","500"],"pointer":"/portals/{portalID}/gh/search","href":"guided-help/startghsearch","openApiOperationId":"startGHSearch","summary":"Start a Guided Help Search","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"oAuthAnonymousCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"schemaId":"components/schemas/GHSearchRequest","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/requestBody/content/application~1json/examples/Start Search With Casebase","paths/~1portals~1{portalID}~1gh~1search/post/requestBody/content/application~1json/examples/Start Search With GHS ArticleId"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/GHSearchRequest","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/requestBody/content/application~1json/examples/Start Search With Casebase","paths/~1portals~1{portalID}~1gh~1search/post/requestBody/content/application~1json/examples/Start Search With GHS ArticleId"]}},"examples":[{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/GHSearchResult","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/GHSearchResult","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1search/post/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1search/post/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"415","description":"Incorrect Content Type Header"},{"code":"429","description":"Too Many Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/responses/429/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1search/post/responses/429/content/application~1json/examples/Too Many Request"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/responses/429/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1search/post/responses/429/content/application~1json/examples/Too Many Request"],"headers":{"X-RateLimit-Limit":{"schema":{"type":"integer","maxLength":3600},"description":"Request limit per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer","maxLength":3600},"description":"The number of requests left for the time window."},"X-RateLimit-Reset":{"schema":{"type":"string","format":"date-time"},"description":"The UTC date/time at which the current rate limit window resets."}},"headerSchemaId":"schema_543"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1gh~1search/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/GHSearchResult","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/GHSearchResult","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1search/post/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1search/post/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"415"},{"code":"429","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/responses/429/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1search/post/responses/429/content/application~1json/examples/Too Many Request"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/responses/429/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1search/post/responses/429/content/application~1json/examples/Too Many Request"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/post/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/guided-help/startghsearch"}],"panels":[]}]},"httpPath":"/portals/{portalID}/gh/search"},{"label":"Perform a Step in a Guided Help Search","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/guided-help/stepghsearch","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/guided-help/stepghsearch","metadata":{"seo":{"title":"Perform a Step in a Guided Help Search","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"stepGHSearch","name":"Perform a Step in a Guided Help Search","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1gh~1search/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Perform a Step in a Guided Help Search","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"guided-help/stepghsearch/request/overview","deepLinkHash":"/guided-help/stepghsearch#guided-help/stepghsearch/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Perform a Step in a Guided Help Search API can be used to answer one or more questions (perform a step) in Guided Help search."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"guided-help/stepghsearch/request/prerequisites","deepLinkHash":"/guided-help/stepghsearch#guided-help/stepghsearch/request/prerequisites"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Prerequisites"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A Guided Help session must be in progress before this API is invoked."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]},{"schemes":[{"name":"oAuthAnonymousCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as an anonymous customer.","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1gh~1search/put/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"$lang","in":"query","schemaId":"schema_512","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language used for a resource. Resources available in different languages may differ from each other."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"$lang"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not passed, then the portal's default language is used."},"children":[]}]}]}]},{"name":"ghCustomAdditionalAttributes","in":"query","schemaId":"schema_542","examples":{"Single":{"description":"A user-defined custom attribute.","value":"question.custom.score"},"Multiple":{"description":"Multiple user-defined custom attributes.","value":"question.custom.score,question.custom.test"}}}],"pointer":"/paths/~1portals~1{portalID}~1gh~1search/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Content-Type","in":"header","schemaId":"schema_525","description":"The media type sent by the client.","required":true},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1gh~1search/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/GHStepSearchRequest","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/put/requestBody/content/application~1json/examples/PerformStepWithGHSearch"]}},"schemaId":"components/schemas/GHStepSearchRequest","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/put/requestBody/content/application~1json/examples/PerformStepWithGHSearch"],"pointer":"/paths/~1portals~1{portalID}~1gh~1search/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/portals/{portalID}/gh/search","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"}],"query":[{"name":"$lang","in":"query","required":false,"example":"en-US","schemaId":"components/schemas/LegacyKBLanguageCodes"},{"name":"ghCustomAdditionalAttributes","in":"query","required":false,"example":"question.custom.score","schemaId":"schema_542"}],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Content-Type","in":"header","required":true,"schemaId":"schema_525"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"schemes":[{"id":"oAuthAnonymousCustomer","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/GHStepSearchRequest","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/put/requestBody/content/application~1json/examples/PerformStepWithGHSearch"]}},"responseCodes":["200","400","401","403","404","406","415","500"],"pointer":"/portals/{portalID}/gh/search","href":"guided-help/stepghsearch","openApiOperationId":"stepGHSearch","summary":"Perform a Step in a Guided Help Search","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"oAuthAnonymousCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"schemaId":"components/schemas/GHStepSearchRequest","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/put/requestBody/content/application~1json/examples/PerformStepWithGHSearch"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/GHStepSearchRequest","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/put/requestBody/content/application~1json/examples/PerformStepWithGHSearch"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/GHSearchResult","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/put/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/GHSearchResult","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/put/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1search/put/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1search/put/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/put/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/put/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/put/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/put/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/put/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/put/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/put/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/put/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"415","description":"Incorrect Content Type Header"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/put/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/put/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1gh~1search/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/GHSearchResult","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/put/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/GHSearchResult","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/put/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1search/put/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1search/put/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/put/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/put/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/put/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/put/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/put/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/put/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/put/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/put/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"415"},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/put/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1search/put/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/guided-help/stepghsearch"}],"panels":[]}]},"httpPath":"/portals/{portalID}/gh/search"},{"label":"Get All Cases of a Cluster in Release","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/guided-help/getallcases","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/guided-help/getallcases","metadata":{"seo":{"title":"Get All Cases of a Cluster in Release","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getAllCases","name":"Get All Cases of a Cluster in Release","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get All Cases of a Cluster in Release","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"guided-help/getallcases/request/overview","deepLinkHash":"/guided-help/getallcases#guided-help/getallcases/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get All Cases of a Cluster in Release API retrieves all cases in cluster of a Casebase Release. A Case is a group of Questions, Articles, and control actions that work together to guide users through a series of questions and scenarios in a Guided Help session."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"guided-help/getallcases/request/prerequisites","deepLinkHash":"/guided-help/getallcases#guided-help/getallcases/request/prerequisites"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Prerequisites"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A Guided Help search session for the provided Casebase Release must be in progress before this API is invoked."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]},{"schemes":[{"name":"oAuthAnonymousCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as an anonymous customer.","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true},{"name":"casebaseReleaseID","in":"path","schemaId":"schema_540","description":"The numerical ID of the Casebase Release for which details is to be fetched.","required":true},{"name":"clusterID","in":"path","schemaId":"schema_544","description":"ID of Cluster.","required":true}],"pointer":"/paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"$lang","in":"query","schemaId":"schema_512","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language used for a resource. Resources available in different languages may differ from each other."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"$lang"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not passed, then the portal's default language is used."},"children":[]}]}]}]},{"name":"$pagenum","in":"query","schemaId":"schema_529","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the page number of results to be returned. Used in conjunction with $pagesize."},"children":[]}]}]}]},{"name":"$pagesize","in":"query","schemaId":"schema_530","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the number of results per page. Used in conjunction with $pagenum."},"children":[]}]}]}]}],"pointer":"/paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}}],"pointer":"/paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/{portalID}/gh/casebasereleases/{casebaseReleaseID}/clusters/{clusterID}/cases","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"},{"name":"casebaseReleaseID","in":"path","required":true,"example":"202201000000002","schemaId":"schema_540"},{"name":"clusterID","in":"path","required":true,"example":"1000000402","schemaId":"schema_544"}],"query":[{"name":"$lang","in":"query","required":false,"example":"en-US","schemaId":"components/schemas/LegacyKBLanguageCodes"},{"name":"$pagenum","in":"query","required":false,"schemaId":"schema_529"},{"name":"$pagesize","in":"query","required":false,"schemaId":"schema_530"}],"querystring":[],"header":[{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthAnonymousCustomer","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}],"responseCodes":["200","204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/gh/casebasereleases/{casebaseReleaseID}/clusters/{clusterID}/cases","href":"guided-help/getallcases","openApiOperationId":"getAllCases","summary":"Get All Cases of a Cluster in Release","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthAnonymousCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CaseListResults","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/CaseListResults","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/200/content/application~1json/example"]},{"code":"204","description":"When no cases are present in cluster."},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/CaseListResults","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/CaseListResults","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/200/content/application~1json/example"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/guided-help/getallcases"}],"panels":[]}]},"httpPath":"/portals/{portalID}/gh/casebasereleases/{casebaseReleaseID}/clusters/{clusterID}/cases"},{"label":"Get Details of a Case","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/guided-help/getcasebyid","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/guided-help/getcasebyid","metadata":{"seo":{"title":"Get Details of a Case","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getCaseById","name":"Get Details of a Case","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Details of a Case","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"guided-help/getcasebyid/request/overview","deepLinkHash":"/guided-help/getcasebyid#guided-help/getcasebyid/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get Details of a Case API retrieves details of a case in a release."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"guided-help/getcasebyid/request/prerequisites","deepLinkHash":"/guided-help/getcasebyid#guided-help/getcasebyid/request/prerequisites"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Prerequisites"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A Guided Help search session for the provided Casebase Release must be in progress before this API is invoked."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]},{"schemes":[{"name":"oAuthAnonymousCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as an anonymous customer.","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true},{"name":"casebaseReleaseID","in":"path","schemaId":"schema_540","description":"The numerical ID of the Casebase Release for which details is to be fetched.","required":true},{"name":"caseID","in":"path","schemaId":"schema_545","description":"The numerical ID of the Case for which details is to be fetched.","required":true}],"pointer":"/paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"$lang","in":"query","schemaId":"schema_512","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language used for a resource. Resources available in different languages may differ from each other."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"$lang"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not passed, then the portal's default language is used."},"children":[]}]}]}]},{"name":"caseAdditionalAttributes","in":"query","schemaId":"schema_546","description":"Additional case attributes to be fetched.","examples":{"Single":{"description":"An additional attributes to be returned.","value":"[\"actions\"]"},"Multiple":{"description":"Additional attributes to be returned.","value":"[\"questionDetail\",\"actions\"]"},"All":{"description":"All additional attributes to be returned.","value":"[\"all\"]"}}}],"pointer":"/paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/{portalID}/gh/casebasereleases/{casebaseReleaseID}/cases/{caseID}","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"},{"name":"casebaseReleaseID","in":"path","required":true,"example":"202201000000002","schemaId":"schema_540"},{"name":"caseID","in":"path","required":true,"example":"1000001085","schemaId":"schema_545"}],"query":[{"name":"$lang","in":"query","required":false,"example":"en-US","schemaId":"components/schemas/LegacyKBLanguageCodes"},{"name":"caseAdditionalAttributes","in":"query","required":false,"example":["actions"],"schemaId":"schema_546","style":"form","explode":false}],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthAnonymousCustomer","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}],"responseCodes":["200","204","400","401","403","404","406","412","500"],"pointer":"/portals/{portalID}/gh/casebasereleases/{casebaseReleaseID}/cases/{caseID}","href":"guided-help/getcasebyid","openApiOperationId":"getCaseById","summary":"Get Details of a Case","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthAnonymousCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Case","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/200/content/application~1json/examples/Summary Attribute","paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/200/content/application~1json/examples/All Attributes"]}},"schemaId":"components/schemas/Case","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/200/content/application~1json/examples/Summary Attribute","paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/200/content/application~1json/examples/All Attributes"]},{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"412","description":"Precondition Failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/412/content/application~1json/examples/Precondition Failed"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/412/content/application~1json/examples/Precondition Failed"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/Case","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/200/content/application~1json/examples/Summary Attribute","paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/200/content/application~1json/examples/All Attributes"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Case","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/200/content/application~1json/examples/Summary Attribute","paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/200/content/application~1json/examples/All Attributes"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"412","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/412/content/application~1json/examples/Precondition Failed"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/412/content/application~1json/examples/Precondition Failed"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/guided-help/getcasebyid"}],"panels":[]}]},"httpPath":"/portals/{portalID}/gh/casebasereleases/{casebaseReleaseID}/cases/{caseID}"},{"label":"Accept Solution","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/guided-help/acceptghsolution","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/guided-help/acceptghsolution","metadata":{"seo":{"title":"Accept Solution","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"acceptGHSolution","name":"Accept Solution","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Accept Solution","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"guided-help/acceptghsolution/request/overview","deepLinkHash":"/guided-help/acceptghsolution#guided-help/acceptghsolution/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Accept Solution API can be used to accept and add positive score to a solution of a Guided Help case."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"guided-help/acceptghsolution/request/prerequisites","deepLinkHash":"/guided-help/acceptghsolution#guided-help/acceptghsolution/request/prerequisites"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Prerequisites"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A Guided Help search session must be started before invoking this API."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]},{"schemes":[{"name":"oAuthAnonymousCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as an anonymous customer.","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true},{"name":"caseID","in":"path","schemaId":"schema_545","description":"The numerical ID of the Case for which details is to be fetched.","required":true}],"pointer":"/paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/QuickpickRating","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/QuickpickRating","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/portals/{portalID}/gh/cases/{caseID}/accept","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"},{"name":"caseID","in":"path","required":true,"example":"1000001085","schemaId":"schema_545"}],"query":[],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"schemes":[{"id":"oAuthAnonymousCustomer","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/QuickpickRating","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/requestBody/content/application~1json/example"]}},"responseCodes":["201","400","401","403","404","406","412","415","500"],"pointer":"/portals/{portalID}/gh/cases/{caseID}/accept","href":"guided-help/acceptghsolution","openApiOperationId":"acceptGHSolution","summary":"Accept Solution","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"oAuthAnonymousCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"schemaId":"components/schemas/QuickpickRating","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/QuickpickRating","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Rating accepted"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"412","description":"Precondition Failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/412/content/application~1json/examples/Precondition Failed"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/412/content/application~1json/examples/Precondition Failed"]},{"code":"415","description":"Incorrect Content Type Header"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"412","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/412/content/application~1json/examples/Precondition Failed"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/412/content/application~1json/examples/Precondition Failed"]}}},{"code":"415"},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/guided-help/acceptghsolution"}],"panels":[]}]},"httpPath":"/portals/{portalID}/gh/cases/{caseID}/accept"},{"label":"Reject Solution","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/guided-help/rejectghsolution","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/guided-help/rejectghsolution","metadata":{"seo":{"title":"Reject Solution","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"rejectGHSolution","name":"Reject Solution","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Reject Solution","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"guided-help/rejectghsolution/request/overview","deepLinkHash":"/guided-help/rejectghsolution#guided-help/rejectghsolution/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Reject Solution API can be used to reject and add negative score to a solution of a Guided Help case."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"guided-help/rejectghsolution/request/prerequisites","deepLinkHash":"/guided-help/rejectghsolution#guided-help/rejectghsolution/request/prerequisites"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Prerequisites"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A Guided Help search session must be started before invoking this API."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]},{"schemes":[{"name":"oAuthAnonymousCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as an anonymous customer.","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true},{"name":"caseID","in":"path","schemaId":"schema_545","description":"The numerical ID of the Case for which details is to be fetched.","required":true}],"pointer":"/paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/QuickpickRating","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/requestBody/content/application~1json/example"]}},"schemaId":"components/schemas/QuickpickRating","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/requestBody/content/application~1json/example"],"pointer":"/paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/portals/{portalID}/gh/cases/{caseID}/reject","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"},{"name":"caseID","in":"path","required":true,"example":"1000001085","schemaId":"schema_545"}],"query":[],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"schemes":[{"id":"oAuthAnonymousCustomer","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/QuickpickRating","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/requestBody/content/application~1json/example"]}},"responseCodes":["201","400","401","403","404","406","412","415","500"],"pointer":"/portals/{portalID}/gh/cases/{caseID}/reject","href":"guided-help/rejectghsolution","openApiOperationId":"rejectGHSolution","summary":"Reject Solution","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"oAuthAnonymousCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"schemaId":"components/schemas/QuickpickRating","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/requestBody/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/QuickpickRating","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/requestBody/content/application~1json/example"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Rating accepted"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"412","description":"Precondition Failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/412/content/application~1json/examples/Precondition Failed"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/412/content/application~1json/examples/Precondition Failed"]},{"code":"415","description":"Incorrect Content Type Header"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"412","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/412/content/application~1json/examples/Precondition Failed"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/412/content/application~1json/examples/Precondition Failed"]}}},{"code":"415"},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/guided-help/rejectghsolution"}],"panels":[]}]},"httpPath":"/portals/{portalID}/gh/cases/{caseID}/reject"},{"label":"Create Quickpick","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/guided-help/createquickpick","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/guided-help/createquickpick","metadata":{"seo":{"title":"Create Quickpick","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createQuickpick","name":"Create Quickpick","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1gh~1quickpicks/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Create Quickpick","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"guided-help/createquickpick/request/overview","deepLinkHash":"/guided-help/createquickpick#guided-help/createquickpick/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Create Quickpick API can be used to create a new quickpick(bookmark) for current Guided Help search session."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: If \"linkToActivity\" attribute is passed as true in request body then one of below must be passed in header"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"XEgainTenantId"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"xEgainActivityId"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"XInteractionId"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"guided-help/createquickpick/request/prerequisites","deepLinkHash":"/guided-help/createquickpick#guided-help/createquickpick/request/prerequisites"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Prerequisites"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A Guided Help search session must be in progress before this API is invoked."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"QuickPick can only be created for a live release of a Casebase."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1gh~1quickpicks/post/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"$lang","in":"query","schemaId":"schema_512","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language used for a resource. Resources available in different languages may differ from each other."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"$lang"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not passed, then the portal's default language is used."},"children":[]}]}]}]}],"pointer":"/paths/~1portals~1{portalID}~1gh~1quickpicks/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}}],"pointer":"/paths/~1portals~1{portalID}~1gh~1quickpicks/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateQuickpick","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/post/requestBody/content/application~1json/examples/Create Quickpick","paths/~1portals~1{portalID}~1gh~1quickpicks/post/requestBody/content/application~1json/examples/Create Quickpick And Link With Activity"]}},"schemaId":"components/schemas/CreateQuickpick","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/post/requestBody/content/application~1json/examples/Create Quickpick","paths/~1portals~1{portalID}~1gh~1quickpicks/post/requestBody/content/application~1json/examples/Create Quickpick And Link With Activity"],"pointer":"/paths/~1portals~1{portalID}~1gh~1quickpicks/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/portals/{portalID}/gh/quickpicks","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"}],"query":[{"name":"$lang","in":"query","required":false,"example":"en-US","schemaId":"components/schemas/LegacyKBLanguageCodes"}],"querystring":[],"header":[{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateQuickpick","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/post/requestBody/content/application~1json/examples/Create Quickpick","paths/~1portals~1{portalID}~1gh~1quickpicks/post/requestBody/content/application~1json/examples/Create Quickpick And Link With Activity"]}},"responseCodes":["201","400","401","403","404","406","415","500"],"pointer":"/portals/{portalID}/gh/quickpicks","href":"guided-help/createquickpick","openApiOperationId":"createQuickpick","summary":"Create Quickpick","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"schemaId":"components/schemas/CreateQuickpick","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/post/requestBody/content/application~1json/examples/Create Quickpick","paths/~1portals~1{portalID}~1gh~1quickpicks/post/requestBody/content/application~1json/examples/Create Quickpick And Link With Activity"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateQuickpick","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/post/requestBody/content/application~1json/examples/Create Quickpick","paths/~1portals~1{portalID}~1gh~1quickpicks/post/requestBody/content/application~1json/examples/Create Quickpick And Link With Activity"]}},"examples":[{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Quickpick Created Successfully."},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"415","description":"Incorrect Content Type Header"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"415"},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/guided-help/createquickpick"}],"panels":[]}]},"httpPath":"/portals/{portalID}/gh/quickpicks"},{"label":"Get All Quickpicks for a Portal","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/guided-help/getallquickpicks","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/guided-help/getallquickpicks","metadata":{"seo":{"title":"Get All Quickpicks for a Portal","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getAllQuickPicks","name":"Get All Quickpicks for a Portal","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1gh~1quickpicks/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get All Quickpicks for a Portal","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"guided-help/getallquickpicks/request/overview","deepLinkHash":"/guided-help/getallquickpicks#guided-help/getallquickpicks/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get All Quickpicks for a Portal API retrieves details of quickpicks created for the Casebase."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"guided-help/getallquickpicks/request/conditions","deepLinkHash":"/guided-help/getallquickpicks#guided-help/getallquickpicks/request/conditions"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Conditions"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If \"getLastSavedQuickPickForInteraction\" query parameter is passed as \"Yes\" then one of below must be passed in request header."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"X-ext-integration-id"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"X-egain-activity-id"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"X-ext-interaction-id"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Either casebaseID or getLastSavedQuickPickForInteraction must be passed in request."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1gh~1quickpicks/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"casebaseReleaseID","in":"query","schemaId":"schema_540","description":"The numerical ID of the Casebase Release for which details is to be fetched.","required":true},{"name":"$lang","in":"query","schemaId":"schema_512","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language used for a resource. Resources available in different languages may differ from each other."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"$lang"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not passed, then the portal's default language is used."},"children":[]}]}]}]},{"name":"$pagenum","in":"query","schemaId":"schema_529","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the page number of results to be returned. Used in conjunction with $pagesize."},"children":[]}]}]}]},{"name":"$pagesize","in":"query","schemaId":"schema_530","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the number of results per page. Used in conjunction with $pagenum."},"children":[]}]}]}]},{"name":"getLastSavedQuickPickForInteraction","in":"query","schemaId":"schema_547","description":"To be passed retrieve quickpick associated with interaction."}],"pointer":"/paths/~1portals~1{portalID}~1gh~1quickpicks/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}}],"pointer":"/paths/~1portals~1{portalID}~1gh~1quickpicks/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/{portalID}/gh/quickpicks","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"}],"query":[{"name":"casebaseReleaseID","in":"query","required":true,"example":"202201000000002","schemaId":"schema_540"},{"name":"$lang","in":"query","required":false,"example":"en-US","schemaId":"components/schemas/LegacyKBLanguageCodes"},{"name":"$pagenum","in":"query","required":false,"schemaId":"schema_529"},{"name":"$pagesize","in":"query","required":false,"schemaId":"schema_530"},{"name":"getLastSavedQuickPickForInteraction","in":"query","required":false,"schemaId":"schema_547"}],"querystring":[],"header":[{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]}],"responseCodes":["200","204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/gh/quickpicks","href":"guided-help/getallquickpicks","openApiOperationId":"getAllQuickPicks","summary":"Get All Quickpicks for a Portal","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/QuickpickResults","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/200/content/application~1json/examples/Singular Quickpick","paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/200/content/application~1json/examples/Multiple Quickpick"]}},"schemaId":"components/schemas/QuickpickResults","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/200/content/application~1json/examples/Singular Quickpick","paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/200/content/application~1json/examples/Multiple Quickpick"]},{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/QuickpickResults","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/200/content/application~1json/examples/Singular Quickpick","paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/200/content/application~1json/examples/Multiple Quickpick"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/QuickpickResults","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/200/content/application~1json/examples/Singular Quickpick","paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/200/content/application~1json/examples/Multiple Quickpick"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/guided-help/getallquickpicks"}],"panels":[]}]},"httpPath":"/portals/{portalID}/gh/quickpicks"},{"label":"Resume a Quickpick","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/guided-help/restorequickpick","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/guided-help/restorequickpick","metadata":{"seo":{"title":"Resume a Quickpick","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"restoreQuickpick","name":"Resume a Quickpick","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Resume a Quickpick","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"guided-help/restorequickpick/request/overview","deepLinkHash":"/guided-help/restorequickpick#guided-help/restorequickpick/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Resume a Quickpick API can be used to restore (resume) a specific quickpick."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"guided-help/restorequickpick/request/prerequisites","deepLinkHash":"/guided-help/restorequickpick#guided-help/restorequickpick/request/prerequisites"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Prerequisites"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A Guided Help session for the Casebase must be started before invoking this API."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true},{"name":"quickpickID","in":"path","schemaId":"schema_548","description":"The ID of the quickpick.","required":true}],"pointer":"/paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"$lang","in":"query","schemaId":"schema_512","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language used for a resource. Resources available in different languages may differ from each other."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"$lang"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not passed, then the portal's default language is used."},"children":[]}]}]}]},{"name":"ghCustomAdditionalAttributes","in":"query","schemaId":"schema_542","examples":{"Single":{"description":"A user-defined custom attribute.","value":"question.custom.score"},"Multiple":{"description":"Multiple user-defined custom attributes.","value":"question.custom.score,question.custom.test"}}}],"pointer":"/paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/portals/{portalID}/gh/quickpicks/{quickpickID}","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"},{"name":"quickpickID","in":"path","required":true,"example":"11","schemaId":"schema_548"}],"query":[{"name":"$lang","in":"query","required":false,"example":"en-US","schemaId":"components/schemas/LegacyKBLanguageCodes"},{"name":"ghCustomAdditionalAttributes","in":"query","required":false,"example":"question.custom.score","schemaId":"schema_542"}],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]}],"responseCodes":["200","400","401","403","404","406","415","500"],"pointer":"/portals/{portalID}/gh/quickpicks/{quickpickID}","href":"guided-help/restorequickpick","openApiOperationId":"restoreQuickpick","summary":"Resume a Quickpick","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/GHSearchResult","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/GHSearchResult","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"415","description":"Incorrect Content Type Header"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/GHSearchResult","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/GHSearchResult","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"415"},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/guided-help/restorequickpick"}],"panels":[]}]},"httpPath":"/portals/{portalID}/gh/quickpicks/{quickpickID}"}],"content":{"contentType":"group","meta":{"name":"Guided Help"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Guided Help","showPageActions":true},{"nodeType":"markdoc","content":"Guided Help APIs"}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/portals/{portalID}/gh/casebasereleases","summary":"Get Available Casebases Releases","prefix":{"name":"get","color":"get"},"badges":[],"link":"/guided-help/getallcasebasesreleases","deprecated":false},{"title":"/portals/{portalID}/gh/casebasereleases/{casebaseReleaseID}","summary":"Get Details of a Casebase Release","prefix":{"name":"get","color":"get"},"badges":[],"link":"/guided-help/getcasebasereleasebyid","deprecated":false},{"title":"/portals/{portalID}/gh/casebasereleases/{casebaseReleaseID}/clusters","summary":"Get Cluster Details of a Casebase Release","prefix":{"name":"get","color":"get"},"badges":[],"link":"/guided-help/getclusterbycasebasereleaseid","deprecated":false},{"title":"/portals/{portalID}/gh/profiles","summary":"Get All Profiles Available in Portal","prefix":{"name":"get","color":"get"},"badges":[],"link":"/guided-help/getallprofilesinportal","deprecated":false},{"title":"/portals/{portalID}/gh/search","summary":"Start a Guided Help Search","prefix":{"name":"post","color":"post"},"badges":[],"link":"/guided-help/startghsearch","deprecated":false},{"title":"/portals/{portalID}/gh/search","summary":"Perform a Step in a Guided Help Search","prefix":{"name":"put","color":"put"},"badges":[],"link":"/guided-help/stepghsearch","deprecated":false},{"title":"/portals/{portalID}/gh/casebasereleases/{casebaseReleaseID}/clusters/{clusterID}/cases","summary":"Get All Cases of a Cluster in Release","prefix":{"name":"get","color":"get"},"badges":[],"link":"/guided-help/getallcases","deprecated":false},{"title":"/portals/{portalID}/gh/casebasereleases/{casebaseReleaseID}/cases/{caseID}","summary":"Get Details of a Case","prefix":{"name":"get","color":"get"},"badges":[],"link":"/guided-help/getcasebyid","deprecated":false},{"title":"/portals/{portalID}/gh/cases/{caseID}/accept","summary":"Accept Solution","prefix":{"name":"post","color":"post"},"badges":[],"link":"/guided-help/acceptghsolution","deprecated":false},{"title":"/portals/{portalID}/gh/cases/{caseID}/reject","summary":"Reject Solution","prefix":{"name":"post","color":"post"},"badges":[],"link":"/guided-help/rejectghsolution","deprecated":false},{"title":"/portals/{portalID}/gh/quickpicks","summary":"Create Quickpick","prefix":{"name":"post","color":"post"},"badges":[],"link":"/guided-help/createquickpick","deprecated":false},{"title":"/portals/{portalID}/gh/quickpicks","summary":"Get All Quickpicks for a Portal","prefix":{"name":"get","color":"get"},"badges":[],"link":"/guided-help/getallquickpicks","deprecated":false},{"title":"/portals/{portalID}/gh/quickpicks/{quickpickID}","summary":"Resume a Quickpick","prefix":{"name":"post","color":"post"},"badges":[],"link":"/guided-help/restorequickpick","deprecated":false}]}]}]}]}},{"type":"group","label":"Popular Articles","link":"/apis/v4/knowledge/portalmgr/api-bundled/popular-articles","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/popular-articles","items":[{"label":"Get Popular Articles","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/popular-articles/getpopulararticles","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/popular-articles/getpopulararticles","metadata":{"seo":{"title":"Get Popular Articles","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getpopulararticles","name":"Get Popular Articles","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1populararticles/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Popular Articles","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"popular-articles/getpopulararticles/request/overview","deepLinkHash":"/popular-articles/getpopulararticles#popular-articles/getpopulararticles/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Popular Articles API allows a user to retrieve popular articles."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"popular-articles/getpopulararticles/request/prerequisites","deepLinkHash":"/popular-articles/getpopulararticles#popular-articles/getpopulararticles/request/prerequisites"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Prerequisites"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Only displayable articles are returned. An Article is displayable when \"Include in browse on portals\" property is enable for the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"popular-articles/getpopulararticles/request/permissions","deepLinkHash":"/popular-articles/getpopulararticles#popular-articles/getpopulararticles/request/permissions"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Permissions"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Agent permissions: The following permissions are required if user is an Agent:"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If Article has Access Tags, Article must be available for agent's current user profile."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If Article has Publish Views, at least one edition of Article must be available for agent's current user profile."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If Article has filters and tags query parameter provided, Article filters must match provided tags or tag groups."},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Customer permissions: The following permissions are required if user is a Customer:"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If Article has Access tags:"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Portal must have default user profile, and;"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Article must be available for portal's default user profile."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If Article has Publish Views:"},"children":[]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Portal must have default user profile, and;"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"At least one edition must be available for portal's default user profile."},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If Article has filters and tags query parameter provided, Article filters must match provided tags or tag groups."},"children":[]}]}]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]},{"schemes":[{"name":"oAuthAnonymousCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as an anonymous customer.","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1populararticles/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"$filter[topicId]","in":"query","schemaId":"schema_516","description":"The ID of the topic. It is used to restrict to a specific topic.","example":"PROD-1067"},{"name":"$lang","in":"query","schemaId":"schema_512","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language used for a resource. Resources available in different languages may differ from each other."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"$lang"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not passed, then the portal's default language is used."},"children":[]}]}]}]},{"name":"$filter[tags]","in":"query","schemaId":"schema_528","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A comma separated list of Tag / Tag Group IDs. The query results will be filtered by the tags that are specified."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Tag IDs and Tag Group IDs can be mixed together."},"children":[]}]}]}]},{"name":"$pagenum","in":"query","schemaId":"schema_529","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the page number of results to be returned. Used in conjunction with $pagesize."},"children":[]}]}]}]},{"name":"$pagesize","in":"query","schemaId":"schema_530","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the number of results per page. Used in conjunction with $pagenum."},"children":[]}]}]}]},{"name":"articleResultAdditionalAttributes","in":"query","schemaId":"schema_527","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The attributes of an Article to be returned "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"in addition to"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" the default list of attributes, listed below. Multiple additional attributes can be specified using a comma-separated list. Passing 'all' will return all attributes."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":4},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Default Attributes"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"These Article attributes are always returned:"},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Name"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"id"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"name"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name of the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"articleType"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Article Type and its attributes."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"createdBy"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID, first name, middle name and last name of the user that created the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"createdDate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date that the Article was created."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"hasAttachments"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"True: The Article has one or more attachments."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"False: The Article does not have any attachments."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"languageCode"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language code of the Article language."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"modifiedBy"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID, first name, middle name and last name of the user that last modified the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"modifiedDate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date that the Article was last modified on."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"link"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The link object, used to retrieve the details of the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"versionId"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article version that is returned."},"children":[]}]}]}]}]}]}],"examples":{"Single":{"description":"An additional attribute to be returned.","value":"[\"averageRating\"]"},"Multiple":{"description":"Additional attributes to be returned.","value":"[\"ownedBy\",\"ownedBy.userName\"]"},"All":{"description":"All additional attributes to be returned.","value":"[\"all\"]"}}}],"pointer":"/paths/~1portals~1{portalID}~1populararticles/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}}],"pointer":"/paths/~1portals~1{portalID}~1populararticles/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/{portalID}/populararticles","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"}],"query":[{"name":"$filter[topicId]","in":"query","required":false,"example":"PROD-1067","schemaId":"schema_516"},{"name":"$lang","in":"query","required":false,"example":"en-US","schemaId":"components/schemas/LegacyKBLanguageCodes"},{"name":"$filter[tags]","in":"query","required":false,"example":"PROD-5381","schemaId":"schema_528"},{"name":"$pagenum","in":"query","required":false,"schemaId":"schema_529"},{"name":"$pagesize","in":"query","required":false,"schemaId":"schema_530"},{"name":"articleResultAdditionalAttributes","in":"query","required":false,"example":["averageRating"],"schemaId":"schema_527","style":"form","explode":false}],"querystring":[],"header":[{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthAnonymousCustomer","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}],"responseCodes":["200","204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/populararticles","href":"popular-articles/getpopulararticles","openApiOperationId":"getpopulararticles","summary":"Get Popular Articles","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthAnonymousCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ArticleResults","exampleIds":["paths/~1portals~1{portalID}~1populararticles/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1populararticles/get/responses/200/content/application~1json/examples/All Attributes"]}},"schemaId":"components/schemas/ArticleResults","exampleIds":["paths/~1portals~1{portalID}~1populararticles/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1populararticles/get/responses/200/content/application~1json/examples/All Attributes"]},{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1populararticles/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1populararticles/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1populararticles/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1populararticles/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1populararticles/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1populararticles/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1populararticles/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1populararticles/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1populararticles/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1populararticles/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1populararticles/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1populararticles/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1populararticles/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1populararticles/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1populararticles/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ArticleResults","exampleIds":["paths/~1portals~1{portalID}~1populararticles/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1populararticles/get/responses/200/content/application~1json/examples/All Attributes"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ArticleResults","exampleIds":["paths/~1portals~1{portalID}~1populararticles/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1populararticles/get/responses/200/content/application~1json/examples/All Attributes"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1populararticles/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1populararticles/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1populararticles/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1populararticles/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1populararticles/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1populararticles/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1populararticles/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1populararticles/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1populararticles/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1populararticles/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1populararticles/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1populararticles/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1populararticles/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1populararticles/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/popular-articles/getpopulararticles"}],"panels":[]}]},"httpPath":"/portals/{portalID}/populararticles"}],"content":{"contentType":"group","meta":{"name":"Popular Articles"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Popular Articles","showPageActions":true},{"nodeType":"markdoc","content":"Popular Articles API"}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/portals/{portalID}/populararticles","summary":"Get Popular Articles","prefix":{"name":"get","color":"get"},"badges":[],"link":"/popular-articles/getpopulararticles","deprecated":false}]}]}]}]}},{"type":"group","label":"Portal","link":"/apis/v4/knowledge/portalmgr/api-bundled/portal","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/portal","items":[{"label":"Get All Portals","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/portal/getallportals","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/portal/getallportals","metadata":{"seo":{"title":"Get All Portals","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getAllPortals","name":"Get All Portals","isWebhook":false,"pointer":"/paths/~1portals/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get All Portals","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"portal/getallportals/request/overview","deepLinkHash":"/portal/getallportals#portal/getallportals/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get All Portals API returns all portals in a partition or department."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]},{"schemes":[{"name":"oAuthAnonymousCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as an anonymous customer.","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"departmentID","in":"query","schemaId":"schema_523","description":"The ID of the department."},{"name":"$lang","in":"query","schemaId":"schema_512","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language used for a resource. Resources available in different languages may differ from each other."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"$lang"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not passed, then the portal's default language is used."},"children":[]}]}]}]},{"name":"$pagenum","in":"query","schemaId":"schema_529","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the page number of results to be returned. Used in conjunction with $pagesize."},"children":[]}]}]}]},{"name":"$pagesize","in":"query","schemaId":"schema_530","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the number of results per page. Used in conjunction with $pagenum."},"children":[]}]}]}]}],"pointer":"/paths/~1portals/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[],"query":[{"name":"departmentID","in":"query","required":false,"example":"999","schemaId":"schema_523"},{"name":"$lang","in":"query","required":false,"example":"en-US","schemaId":"components/schemas/LegacyKBLanguageCodes"},{"name":"$pagenum","in":"query","required":false,"schemaId":"schema_529"},{"name":"$pagesize","in":"query","required":false,"schemaId":"schema_530"}],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthAnonymousCustomer","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}],"responseCodes":["200","204","400","401","403","404","406","500"],"pointer":"/portals","href":"portal/getallportals","openApiOperationId":"getAllPortals","summary":"Get All Portals","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthAnonymousCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PortalResult","exampleIds":["paths/~1portals/get/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/PortalResult","exampleIds":["paths/~1portals/get/responses/200/content/application~1json/example"]},{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/PortalResult","exampleIds":["paths/~1portals/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/PortalResult","exampleIds":["paths/~1portals/get/responses/200/content/application~1json/example"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/portal/getallportals"}],"panels":[]}]},"httpPath":"/portals"},{"label":"Get All Portals Accessible To User","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/portal/getmyportals","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/portal/getmyportals","metadata":{"seo":{"title":"Get All Portals Accessible To User","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getMyPortals","name":"Get All Portals Accessible To User","isWebhook":false,"pointer":"/paths/~1myportals/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get All Portals Accessible To User","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"portal/getmyportals/request/overview","deepLinkHash":"/portal/getmyportals#portal/getmyportals/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get All Portals Accessible to User API allows a user to fetch all portals accessible to user across all department."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If no access tags are specified for a portal, then any user can access the portal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If access tags are specified for a portal, users with a user profile that allows access have access to the portal. For users with multiple user profiles, the user profile that allows access does not need to be the active user profile."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"All the global users(partition) cannot be assigned user profiles; their access is limited to portals without access restrictions."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The only articles returned are associated to an Article type when the parameter, “Include in browse on portals” is set to \"Yes\"."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When the \"shortUrlTemplate\" query parameter is provided, the API filters accessible portals according to the specified language and template name. Portal Short URL specific to to the \"shortUrlTemplate\" query parameter value is returned in the response."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"When there is no short URL available for a specific language, the API returns a portal object with an empty \"shortURL\" field."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"$lang","in":"query","schemaId":"schema_512","description":"The language used for a resource. Resources available in different languages may differ from each other.","required":true},{"name":"department","in":"query","schemaId":"schema_549","description":"The Name of the department for which portals are to be fetched"},{"name":"filterText","in":"query","schemaId":"schema_550","description":"Portal name starting with a specific character are considered to filter the result."},{"name":"shortUrlTemplate","in":"query","schemaId":"schema_551","description":"The Name of the template used while creating Short URL."},{"name":"$sort","in":"query","schemaId":"schema_552","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Objects returned in server response are sorted based on the attribute supplied under $sort. "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"_"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Default value"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": name."},"children":[]}]}]}]},{"name":"$order","in":"query","schemaId":"schema_553","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Common query parameter $order."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"_"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Default value"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": asc"},"children":[]}]}]}]},{"name":"$pagenum","in":"query","schemaId":"schema_529","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the page number of results to be returned. Used in conjunction with $pagesize."},"children":[]}]}]}]},{"name":"$pagesize","in":"query","schemaId":"schema_554","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the number of results per page. Used in conjunction with $pagenum."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Valid range of 5-75"},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"_"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Default value"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": 25"},"children":[]}]}]}]}],"pointer":"/paths/~1myportals/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1myportals/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/myportals","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[],"query":[{"name":"$lang","in":"query","required":true,"example":"en-US","schemaId":"components/schemas/LegacyKBLanguageCodes"},{"name":"department","in":"query","required":false,"example":"service","schemaId":"schema_549"},{"name":"filterText","in":"query","required":false,"example":"master","schemaId":"schema_550"},{"name":"shortUrlTemplate","in":"query","required":false,"example":"silver","schemaId":"schema_551"},{"name":"$sort","in":"query","required":false,"schemaId":"schema_552"},{"name":"$order","in":"query","required":false,"example":"asc","schemaId":"schema_553","style":"form","explode":true},{"name":"$pagenum","in":"query","required":false,"schemaId":"schema_529"},{"name":"$pagesize","in":"query","required":false,"schemaId":"schema_554"}],"querystring":[],"header":[{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]}],"responseCodes":["200","204","400","401","403","404","406","500"],"pointer":"/myportals","href":"portal/getmyportals","openApiOperationId":"getMyPortals","summary":"Get All Portals Accessible To User","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AllAccessiblePortals","exampleIds":["paths/~1myportals/get/responses/200/content/application~1json/examples/All Portal with only default Short URL","paths/~1myportals/get/responses/200/content/application~1json/examples/All Portal with default~1non-default Short URL"]}},"schemaId":"components/schemas/AllAccessiblePortals","exampleIds":["paths/~1myportals/get/responses/200/content/application~1json/examples/All Portal with only default Short URL","paths/~1myportals/get/responses/200/content/application~1json/examples/All Portal with default~1non-default Short URL"]},{"code":"204","description":"No Content If all the portals are personalized and user does not have any profile assigned"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1myportals/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1myportals/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1myportals/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1myportals/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1myportals/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1myportals/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1myportals/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1myportals/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1myportals/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1myportals/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1myportals/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1myportals/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1myportals/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1myportals/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1myportals/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/AllAccessiblePortals","exampleIds":["paths/~1myportals/get/responses/200/content/application~1json/examples/All Portal with only default Short URL","paths/~1myportals/get/responses/200/content/application~1json/examples/All Portal with default~1non-default Short URL"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AllAccessiblePortals","exampleIds":["paths/~1myportals/get/responses/200/content/application~1json/examples/All Portal with only default Short URL","paths/~1myportals/get/responses/200/content/application~1json/examples/All Portal with default~1non-default Short URL"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1myportals/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1myportals/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1myportals/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1myportals/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1myportals/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1myportals/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1myportals/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1myportals/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1myportals/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1myportals/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1myportals/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1myportals/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1myportals/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1myportals/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/portal/getmyportals"}],"panels":[]}]},"httpPath":"/myportals"},{"label":"Get Portal Details By ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/portal/getportaldetailsbyid","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/portal/getportaldetailsbyid","metadata":{"seo":{"title":"Get Portal Details By ID","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getPortalDetailsById","name":"Get Portal Details By ID","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Portal Details By ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"portal/getportaldetailsbyid/request/overview","deepLinkHash":"/portal/getportaldetailsbyid#portal/getportaldetailsbyid/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get Portal Details By ID API allows a user to fetch details of a portal by the ID."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]},{"schemes":[{"name":"oAuthAnonymousCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as an anonymous customer.","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}}}]},{"schemes":[{"name":"oAuthClient","scopes":["https://api.egain.cloud/auth/.default"],"type":"oauth2","description":"Authenticate as a client (Server to Server).","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/global/f51302dd-7036-41b5-b619-e1a52a67c780/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/.default":"Default scope"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"$lang","in":"query","schemaId":"schema_512","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language used for a resource. Resources available in different languages may differ from each other."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"$lang"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not passed, then the portal's default language is used."},"children":[]}]}]}]}],"pointer":"/paths/~1portals~1{portalID}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/{portalID}","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"}],"query":[{"name":"$lang","in":"query","required":false,"example":"en-US","schemaId":"components/schemas/LegacyKBLanguageCodes"}],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthAnonymousCustomer","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthClient","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/global/f51302dd-7036-41b5-b619-e1a52a67c780/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/.default":"Default scope"}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/.default"]}],"responseCodes":["200","204","400","401","403","404","406","412","500"],"pointer":"/portals/{portalID}","href":"portal/getportaldetailsbyid","openApiOperationId":"getPortalDetailsById","summary":"Get Portal Details By ID","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthAnonymousCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthClient":["https://api.egain.cloud/auth/.default"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Portal","exampleIds":["paths/~1portals~1{portalID}/get/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/Portal","exampleIds":["paths/~1portals~1{portalID}/get/responses/200/content/application~1json/example"]},{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"412","description":"Precondition Failed","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}/get/responses/412/content/application~1json/examples/Precondition Failed"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}/get/responses/412/content/application~1json/examples/Precondition Failed"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/Portal","exampleIds":["paths/~1portals~1{portalID}/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Portal","exampleIds":["paths/~1portals~1{portalID}/get/responses/200/content/application~1json/example"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"412","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}/get/responses/412/content/application~1json/examples/Precondition Failed"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}/get/responses/412/content/application~1json/examples/Precondition Failed"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/portal/getportaldetailsbyid"}],"panels":[]}]},"httpPath":"/portals/{portalID}"},{"label":"Get Tag Categories for Interest for a Portal","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/portal/gettagcategoriesforinterestforportal","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/portal/gettagcategoriesforinterestforportal","metadata":{"seo":{"title":"Get Tag Categories for Interest for a Portal","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getTagCategoriesForInterestForPortal","name":"Get Tag Categories for Interest for a Portal","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1tagcategoriesforinterest/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Tag Categories for Interest for a Portal","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"portal/gettagcategoriesforinterestforportal/request/overview","deepLinkHash":"/portal/gettagcategoriesforinterestforportal#portal/gettagcategoriesforinterestforportal/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get Tag Categories for Interest for a Portal API retrieves the Tag Categories for Interest configured for a portal."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Tag Categories are ordered in order of their addition in the \"Tag Categories for Interest\" in the Portal configuration."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Tags are ordered as per their order defined in their Tag Category."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Tag Groups are sorted by their name, in ascending order."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]},{"schemes":[{"name":"oAuthAnonymousCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as an anonymous customer.","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"$lang","in":"query","schemaId":"schema_512","description":"The language used for a resource. Resources available in different languages may differ from each other.","required":true}],"pointer":"/paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/{portalID}/tagcategoriesforinterest","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"}],"query":[{"name":"$lang","in":"query","required":true,"example":"en-US","schemaId":"components/schemas/LegacyKBLanguageCodes"}],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthAnonymousCustomer","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}],"responseCodes":["200","204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/tagcategoriesforinterest","href":"portal/gettagcategoriesforinterestforportal","openApiOperationId":"getTagCategoriesForInterestForPortal","summary":"Get Tag Categories for Interest for a Portal","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthAnonymousCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TagCategoriesForInterest","exampleIds":["paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/TagCategoriesForInterest","exampleIds":["paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/200/content/application~1json/example"]},{"code":"204","description":"When no Tag Categories for Interest are configured for a Portal."},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/TagCategoriesForInterest","exampleIds":["paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TagCategoriesForInterest","exampleIds":["paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/200/content/application~1json/example"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/portal/gettagcategoriesforinterestforportal"}],"panels":[]}]},"httpPath":"/portals/{portalID}/tagcategoriesforinterest"}],"content":{"contentType":"group","meta":{"name":"Portal"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Portal","showPageActions":true},{"nodeType":"markdoc","content":"Portal API"}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/portals","summary":"Get All Portals","prefix":{"name":"get","color":"get"},"badges":[],"link":"/portal/getallportals","deprecated":false},{"title":"/myportals","summary":"Get All Portals Accessible To User","prefix":{"name":"get","color":"get"},"badges":[],"link":"/portal/getmyportals","deprecated":false},{"title":"/portals/{portalID}","summary":"Get Portal Details By ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/portal/getportaldetailsbyid","deprecated":false},{"title":"/portals/{portalID}/tagcategoriesforinterest","summary":"Get Tag Categories for Interest for a Portal","prefix":{"name":"get","color":"get"},"badges":[],"link":"/portal/gettagcategoriesforinterestforportal","deprecated":false}]}]}]}]}},{"type":"group","label":"Search","link":"/apis/v4/knowledge/portalmgr/api-bundled/search","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/search","items":[{"label":"Hybrid Search","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/search/aisearch","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/search/aisearch","metadata":{"seo":{"title":"Hybrid Search","description":"The Search API is a hybrid search service that combines semantic understanding with keyword precision to deliver fast, contextual, and relevant results from your enterprise knowledge base. It enables secure, role-aware access to articles, FAQs, and documentation across customer, agent, and employee interfaces. Each query returns a ranked list of results with snippets, metadata, and relevance scores."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"aiSearch","name":"Hybrid Search","isWebhook":false,"pointer":"/paths/~1{portalID}~1search/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Hybrid Search","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":"The Search API is a hybrid search service that combines semantic understanding with keyword precision to deliver fast, contextual, and relevant results from your enterprise knowledge base. It enables secure, role-aware access to articles, FAQs, and documentation across customer, agent, and employee interfaces. Each query returns a ranked list of results with snippets, metadata, and relevance scores.\n"},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthAnonymousCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as an anonymous customer.","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1{portalID}~1search/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"q","in":"query","schemaId":"schema_555","description":"The search query string. The string must be escaped as required by the URL syntax rules.","required":true},{"name":"$filter[userProfileID]","in":"query","schemaId":"schema_556","description":"The ID of the user profile. \n"},{"name":"$lang","in":"query","schemaId":"schema_512","description":"The language used for a resource. Resources available in different languages may differ from each other.","required":true},{"name":"$filter[tags]","in":"query","schemaId":"schema_557","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An object where each key is a "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Category Tag ID"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (numeric string),"},"children":[]},{"$$mdtype":"Node","type":"hardbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and each value is an array of "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Tag IDs"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" for that category."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":":"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The '$filter[tags]' query parameter JSON value should be url encoded."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Some developer tools for invoking APIs may not url encode the '$filter[tags]' query parameter JSON value by default. Ensure that only url encoded values are used."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example of JSON value: {\"BASE-40845\":[\"BASE-40849\",\"BASE-40853\"]}"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example of URL encoded value: %7B%22BASE-40845%22%3A%5B%22BASE-40849%22%2C%22BASE-40853%22%5D%7D"},"children":[]}]}]}]}],"example":{"PROD-1234":["PROD-2000","PROD-2003"],"PROD-2005":["PROD-2007"]}},{"name":"$filter[topicIds]","in":"query","schemaId":"schema_558","description":"An array of topic IDs. It is used to restrict search results to specific topics."},{"name":"articleCustomAdditionalAttributes","in":"query","schemaId":"schema_559","description":"One or more comma-separated names for article custom attributes defined by the user to be returned."},{"name":"$pagenum","in":"query","schemaId":"schema_560","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the page number of results to be returned. Used in conjunction with $pagesize."},"children":[]}]}]}]},{"name":"$pagesize","in":"query","schemaId":"schema_561","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the number of results per page. Used in conjunction with $pagenum."},"children":[]}]}]}]}],"pointer":"/paths/~1{portalID}~1search/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/{portalID}/search","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"}],"query":[{"name":"q","in":"query","required":true,"example":"What is a loan?","schemaId":"schema_555"},{"name":"$filter[userProfileID]","in":"query","required":false,"example":"PROD-1030","schemaId":"schema_556"},{"name":"$lang","in":"query","required":true,"example":"en-US","schemaId":"components/schemas/LegacyKBLanguageCodes"},{"name":"$filter[tags]","in":"query","required":false,"example":{"PROD-1234":["PROD-2000","PROD-2003"],"PROD-2005":["PROD-2007"]},"schemaId":"schema_557"},{"name":"$filter[topicIds]","in":"query","schemaId":"schema_558"},{"name":"articleCustomAdditionalAttributes","in":"query","schemaId":"schema_559"},{"name":"$pagenum","in":"query","required":false,"schemaId":"schema_560"},{"name":"$pagesize","in":"query","required":false,"schemaId":"schema_561"}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthAnonymousCustomer","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}],"responseCodes":["200","204","400","401","403","404","406","500"],"pointer":"/{portalID}/search","href":"search/aisearch","openApiOperationId":"aiSearch","summary":"Hybrid Search","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthAnonymousCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Successful response","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AISearchResponse","exampleIds":["paths/~1{portalID}~1search/get/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/AISearchResponse","exampleIds":["paths/~1{portalID}~1search/get/responses/200/content/application~1json/example"]},{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1{portalID}~1search/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1{portalID}~1search/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1{portalID}~1search/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1{portalID}~1search/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1{portalID}~1search/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1{portalID}~1search/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1{portalID}~1search/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1{portalID}~1search/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1{portalID}~1search/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1{portalID}~1search/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1{portalID}~1search/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1{portalID}~1search/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1{portalID}~1search/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1{portalID}~1search/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1{portalID}~1search/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/AISearchResponse","exampleIds":["paths/~1{portalID}~1search/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/AISearchResponse","exampleIds":["paths/~1{portalID}~1search/get/responses/200/content/application~1json/example"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1{portalID}~1search/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1{portalID}~1search/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1{portalID}~1search/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1{portalID}~1search/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1{portalID}~1search/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1{portalID}~1search/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1{portalID}~1search/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1{portalID}~1search/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1{portalID}~1search/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1{portalID}~1search/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1{portalID}~1search/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1{portalID}~1search/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1{portalID}~1search/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1{portalID}~1search/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/search/aisearch"}],"panels":[]}]},"httpPath":"/{portalID}/search"}],"content":{"contentType":"group","meta":{"name":"Search"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Search","showPageActions":true},{"nodeType":"markdoc","content":"Search APIs"}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/{portalID}/search","summary":"Hybrid Search","prefix":{"name":"get","color":"get"},"badges":[],"link":"/search/aisearch","deprecated":false}]}]}]}]}},{"type":"group","label":"Suggestion","link":"/apis/v4/knowledge/portalmgr/api-bundled/suggestion","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/suggestion","items":[{"label":"Make a Suggestion","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/suggestion/makesuggestion","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/suggestion/makesuggestion","metadata":{"seo":{"title":"Make a Suggestion","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"makeSuggestion","name":"Make a Suggestion","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1suggestions/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Make a Suggestion","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"suggestion/makesuggestion/request/overview","deepLinkHash":"/suggestion/makesuggestion#suggestion/makesuggestion/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Make a Suggestion API allows users to create an Article Suggestion from within a knowledge portal."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"suggestion/makesuggestion/request/prerequisites","deepLinkHash":"/suggestion/makesuggestion#suggestion/makesuggestion/request/prerequisites"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Prerequisites"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Enable the setting \"Manage a Suggestion\" for the portal specified in the URL."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the user is a Customer, enable the setting \"Allow Customer Access\" for the portal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If you want to add an attachment to a Suggestion, first call the Generate Signed URL to Upload API to add an attachment using the provided returned altID in attachment request."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]},{"schemes":[{"name":"oAuthAnonymousCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as an anonymous customer.","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1suggestions/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Content-Type","in":"header","schemaId":"schema_525","description":"The media type sent by the client.","required":true},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1suggestions/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateSuggestion","exampleIds":["paths/~1portals~1{portalID}~1suggestions/post/requestBody/content/application~1json/examples/Mandatory Attributes Only","paths/~1portals~1{portalID}~1suggestions/post/requestBody/content/application~1json/examples/Feedback Suggestion","paths/~1portals~1{portalID}~1suggestions/post/requestBody/content/application~1json/examples/All Attributes"]}},"schemaId":"components/schemas/CreateSuggestion","exampleIds":["paths/~1portals~1{portalID}~1suggestions/post/requestBody/content/application~1json/examples/Mandatory Attributes Only","paths/~1portals~1{portalID}~1suggestions/post/requestBody/content/application~1json/examples/Feedback Suggestion","paths/~1portals~1{portalID}~1suggestions/post/requestBody/content/application~1json/examples/All Attributes"],"pointer":"/paths/~1portals~1{portalID}~1suggestions/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/portals/{portalID}/suggestions","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"}],"query":[],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Content-Type","in":"header","required":true,"schemaId":"schema_525"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"schemes":[{"id":"oAuthAnonymousCustomer","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateSuggestion","exampleIds":["paths/~1portals~1{portalID}~1suggestions/post/requestBody/content/application~1json/examples/Mandatory Attributes Only","paths/~1portals~1{portalID}~1suggestions/post/requestBody/content/application~1json/examples/Feedback Suggestion","paths/~1portals~1{portalID}~1suggestions/post/requestBody/content/application~1json/examples/All Attributes"]}},"responseCodes":["201","400","401","403","404","406","415","500"],"pointer":"/portals/{portalID}/suggestions","href":"suggestion/makesuggestion","openApiOperationId":"makeSuggestion","summary":"Make a Suggestion","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"oAuthAnonymousCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"schemaId":"components/schemas/CreateSuggestion","exampleIds":["paths/~1portals~1{portalID}~1suggestions/post/requestBody/content/application~1json/examples/Mandatory Attributes Only","paths/~1portals~1{portalID}~1suggestions/post/requestBody/content/application~1json/examples/Feedback Suggestion","paths/~1portals~1{portalID}~1suggestions/post/requestBody/content/application~1json/examples/All Attributes"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateSuggestion","exampleIds":["paths/~1portals~1{portalID}~1suggestions/post/requestBody/content/application~1json/examples/Mandatory Attributes Only","paths/~1portals~1{portalID}~1suggestions/post/requestBody/content/application~1json/examples/Feedback Suggestion","paths/~1portals~1{portalID}~1suggestions/post/requestBody/content/application~1json/examples/All Attributes"]}},"examples":[{},{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Created"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions/post/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions/post/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/post/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/post/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/post/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/post/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/post/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/post/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/post/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/post/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"415","description":"Incorrect Content Type Header"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/post/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/post/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1suggestions/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions/post/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions/post/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/post/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/post/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/post/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/post/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/post/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/post/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/post/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/post/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"415"},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/post/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/post/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/suggestion/makesuggestion"}],"panels":[]}]},"httpPath":"/portals/{portalID}/suggestions"},{"label":"Modify Suggestion","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/suggestion/modifysuggestions","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/suggestion/modifysuggestions","metadata":{"seo":{"title":"Modify Suggestion","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"modifySuggestions","name":"Modify Suggestion","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1suggestions/put","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Modify Suggestion","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"suggestion/modifysuggestions/request/overview","deepLinkHash":"/suggestion/modifysuggestions#suggestion/modifysuggestions/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Modify Suggestion API allows authenticated users to modify their own Suggestion."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"suggestion/modifysuggestions/request/prerequisites","deepLinkHash":"/suggestion/modifysuggestions#suggestion/modifysuggestions/request/prerequisites"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Prerequisites"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Enable the setting \"Manage a Suggestion\" for the portal specified in the URL."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the user is a Customer, enable the setting \"Allow Customer Access\" for the portal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The \"Suggestion ID\" specified in the request body must exist and belong to the user."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The status of this Suggestion as returned by the Get Suggestion by ID API must be \"pending\"."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"At least one of the optional request body attributes must be provided."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1suggestions/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Content-Type","in":"header","schemaId":"schema_525","description":"The media type sent by the client.","required":true},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1suggestions/put/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ModifySuggestion","exampleIds":["paths/~1portals~1{portalID}~1suggestions/put/requestBody/content/application~1json/examples/Modify One Attribute (Name)","paths/~1portals~1{portalID}~1suggestions/put/requestBody/content/application~1json/examples/Modify All Attributes"]}},"schemaId":"components/schemas/ModifySuggestion","exampleIds":["paths/~1portals~1{portalID}~1suggestions/put/requestBody/content/application~1json/examples/Modify One Attribute (Name)","paths/~1portals~1{portalID}~1suggestions/put/requestBody/content/application~1json/examples/Modify All Attributes"],"pointer":"/paths/~1portals~1{portalID}~1suggestions/put/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/portals/{portalID}/suggestions","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"}],"query":[],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Content-Type","in":"header","required":true,"schemaId":"schema_525"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/ModifySuggestion","exampleIds":["paths/~1portals~1{portalID}~1suggestions/put/requestBody/content/application~1json/examples/Modify One Attribute (Name)","paths/~1portals~1{portalID}~1suggestions/put/requestBody/content/application~1json/examples/Modify All Attributes"]}},"responseCodes":["204","400","401","403","404","406","415","500"],"pointer":"/portals/{portalID}/suggestions","href":"suggestion/modifysuggestions","openApiOperationId":"modifySuggestions","summary":"Modify Suggestion","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"schemaId":"components/schemas/ModifySuggestion","exampleIds":["paths/~1portals~1{portalID}~1suggestions/put/requestBody/content/application~1json/examples/Modify One Attribute (Name)","paths/~1portals~1{portalID}~1suggestions/put/requestBody/content/application~1json/examples/Modify All Attributes"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/ModifySuggestion","exampleIds":["paths/~1portals~1{portalID}~1suggestions/put/requestBody/content/application~1json/examples/Modify One Attribute (Name)","paths/~1portals~1{portalID}~1suggestions/put/requestBody/content/application~1json/examples/Modify All Attributes"]}},"examples":[{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions/put/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions/put/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/put/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/put/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/put/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/put/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/put/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/put/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/put/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/put/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"415","description":"Incorrect Content Type Header"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/put/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/put/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1suggestions/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions/put/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions/put/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/put/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/put/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/put/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/put/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/put/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/put/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/put/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/put/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"415"},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/put/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/put/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/suggestion/modifysuggestions"}],"panels":[]}]},"httpPath":"/portals/{portalID}/suggestions"},{"label":"Get Suggestion by Status","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/suggestion/searchsuggestion","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/suggestion/searchsuggestion","metadata":{"seo":{"title":"Get Suggestion by Status","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"searchSuggestion","name":"Get Suggestion by Status","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1suggestions/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Suggestion by Status","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"suggestion/searchsuggestion/request/overview","deepLinkHash":"/suggestion/searchsuggestion#suggestion/searchsuggestion/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get Suggestion by Status API allows authenticated users to retrieve their own suggestions based on Suggestion status."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"suggestion/searchsuggestion/request/prerequisites","deepLinkHash":"/suggestion/searchsuggestion#suggestion/searchsuggestion/request/prerequisites"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Prerequisites"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Enable the setting \"My Suggestions\" for the portal specified in the URL."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the user is a customer, enable the setting \"Allow Customer Access\" for the portal."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1suggestions/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"filter[status]","in":"query","schemaId":"schema_562","description":"The search filter applied to the list of suggestions by a user.","required":true},{"name":"$sort","in":"query","schemaId":"schema_563","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Objects returned in server response are sorted based on the attribute supplied under $sort."},"children":[]}]}]}]},{"name":"$order","in":"query","schemaId":"schema_553","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Common query parameter $order."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"_"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Default value"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": asc"},"children":[]}]}]}]},{"name":"$pagenum","in":"query","schemaId":"schema_529","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the page number of results to be returned. Used in conjunction with $pagesize."},"children":[]}]}]}]},{"name":"$pagesize","in":"query","schemaId":"schema_554","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the number of results per page. Used in conjunction with $pagenum."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Valid range of 5-75"},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"_"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Default value"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": 25"},"children":[]}]}]}]}],"pointer":"/paths/~1portals~1{portalID}~1suggestions/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1suggestions/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/{portalID}/suggestions","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"}],"query":[{"name":"filter[status]","in":"query","required":true,"example":"suggested","schemaId":"schema_562"},{"name":"$sort","in":"query","required":false,"example":"id","schemaId":"schema_563"},{"name":"$order","in":"query","required":false,"example":"asc","schemaId":"schema_553","style":"form","explode":true},{"name":"$pagenum","in":"query","required":false,"schemaId":"schema_529"},{"name":"$pagesize","in":"query","required":false,"schemaId":"schema_554"}],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]}],"responseCodes":["200","204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/suggestions","href":"suggestion/searchsuggestion","openApiOperationId":"searchSuggestion","summary":"Get Suggestion by Status","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Suggestions","exampleIds":["paths/~1portals~1{portalID}~1suggestions/get/responses/200/content/application~1json/examples/Summary Attributes"]}},"schemaId":"components/schemas/Suggestions","exampleIds":["paths/~1portals~1{portalID}~1suggestions/get/responses/200/content/application~1json/examples/Summary Attributes"]},{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1suggestions/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/Suggestions","exampleIds":["paths/~1portals~1{portalID}~1suggestions/get/responses/200/content/application~1json/examples/Summary Attributes"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Suggestions","exampleIds":["paths/~1portals~1{portalID}~1suggestions/get/responses/200/content/application~1json/examples/Summary Attributes"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/suggestion/searchsuggestion"}],"panels":[]}]},"httpPath":"/portals/{portalID}/suggestions"},{"label":"Get Suggestion by ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/suggestion/getsuggestion","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/suggestion/getsuggestion","metadata":{"seo":{"title":"Get Suggestion by ID","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getSuggestion","name":"Get Suggestion by ID","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Suggestion by ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"suggestion/getsuggestion/request/overview","deepLinkHash":"/suggestion/getsuggestion#suggestion/getsuggestion/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get Suggestion by ID API allows authenticated users to retrieve their own suggestions."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"suggestion/getsuggestion/request/prerequisites","deepLinkHash":"/suggestion/getsuggestion#suggestion/getsuggestion/request/prerequisites"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Prerequisites"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Enable the setting \"My Suggestions\" for the portal specified in the URL."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the user is a customer, enable the setting \"Allow Customer Access\" for the portal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The \"Suggestion for the ID\" specified in the URL must belong to the user."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true},{"name":"suggestionID","in":"path","schemaId":"schema_516","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Suggestion."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A Suggestion ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true,"example":"PROD-11829"}],"pointer":"/paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"suggestionAdditionalAttributes","in":"query","schemaId":"schema_564","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The attributes of a Suggestion to be returned "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"in addition to"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" the default list of attributes, listed below. Multiple additional attributes can be specified using a comma-separated list. Passing 'all' returns all attributes."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":4},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Default Attributes"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"These Suggestion attributes are always returned:"},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Name"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"id"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Suggestion."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"name"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name of the Suggestion."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"status"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The status of the Suggestion."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"description"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The description of the Suggestion."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"language"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Details about the language of the Suggestion."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"modifiedBy.id"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the user that last modified the Suggestion."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"modifiedBy.firstName"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Suggestion's last modified user's first name."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"modifiedBy.middleName"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Suggestion's last modified user's middle name."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"modifiedBy.lastName"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Suggestion's last modified user's last name."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"modifiedDate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Suggestion's last modified date "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"u","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" information about the user that last modified the Suggestion."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"link"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The link object, used to retrieve the details of the Suggestion."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"hasComments"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Suggestion has one or more comments"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"hasAttachments"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Suggestion has one or more attachments"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"hasRelatedArticles"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Suggestion has related articles"},"children":[]}]}]}]}]}]}],"examples":{"Single":{"description":"An additional attribute to be returned.","value":"[\"content\"]"},"Multiple":{"description":"Additional attributes to be returned.","value":"[\"content\",\"modifiedBy.userName\"]"},"All":{"description":"All additional attributes to be returned.","value":"[\"all\"]"}}},{"name":"$customAdditionalAttributes","in":"query","schemaId":"schema_514","examples":{"Single":{"description":"A user-defined custom attribute.","value":"country_name"},"Multiple":{"description":"Multiple user-defined custom attributes.","value":"internalScore,performance-rating_dept_923"}}}],"pointer":"/paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/{portalID}/suggestions/{suggestionID}","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"},{"name":"suggestionID","in":"path","required":true,"example":"PROD-11829","schemaId":"schema_516"}],"query":[{"name":"suggestionAdditionalAttributes","in":"query","required":false,"example":["content"],"schemaId":"schema_564","style":"form","explode":false},{"name":"$customAdditionalAttributes","in":"query","required":false,"example":"country_name","schemaId":"schema_514"}],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]}],"responseCodes":["200","204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/suggestions/{suggestionID}","href":"suggestion/getsuggestion","openApiOperationId":"getSuggestion","summary":"Get Suggestion by ID","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Suggestion","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/200/content/application~1json/examples/Summary Attributes"]}},"schemaId":"components/schemas/Suggestion","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/200/content/application~1json/examples/Summary Attributes"]},{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/Suggestion","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/200/content/application~1json/examples/Summary Attributes"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Suggestion","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/200/content/application~1json/examples/Summary Attributes"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/suggestion/getsuggestion"}],"panels":[]}]},"httpPath":"/portals/{portalID}/suggestions/{suggestionID}"},{"label":"Delete a Suggestion","deprecated":false,"httpVerb":"delete","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/suggestion/deletesuggestion","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/suggestion/deletesuggestion","metadata":{"seo":{"title":"Delete a Suggestion","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"deleteSuggestion","name":"Delete a Suggestion","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/delete","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Delete a Suggestion","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"suggestion/deletesuggestion/request/overview","deepLinkHash":"/suggestion/deletesuggestion#suggestion/deletesuggestion/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Delete a Suggestion API allows authenticated users to delete their own Suggestion."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"suggestion/deletesuggestion/request/prerequisites","deepLinkHash":"/suggestion/deletesuggestion#suggestion/deletesuggestion/request/prerequisites"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Prerequisites"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Enable the setting \"Manage a Suggestion\" for the portal specified in the URL."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the user is a customer, enable the setting \"Allow Customer Access\" for the portal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Suggestion must belong to the user."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The status of the Suggestion must not be \"approved\"."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true},{"name":"suggestionID","in":"path","schemaId":"schema_516","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Suggestion."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A Suggestion ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true,"example":"PROD-11829"}],"pointer":"/paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/delete/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/delete/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"DELETE","path":"/portals/{portalID}/suggestions/{suggestionID}","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"},{"name":"suggestionID","in":"path","required":true,"example":"PROD-11829","schemaId":"schema_516"}],"query":[],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]}],"responseCodes":["204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/suggestions/{suggestionID}","href":"suggestion/deletesuggestion","openApiOperationId":"deleteSuggestion","summary":"Delete a Suggestion","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request"},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/delete/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/delete/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/delete/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/delete/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/delete/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/delete/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/delete/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/delete/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/delete/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/delete/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/delete/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"204"},{"code":"400"},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/delete/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/delete/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/delete/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/delete/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/delete/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/delete/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/delete/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/delete/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/delete/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/delete/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/suggestion/deletesuggestion"}],"panels":[]}]},"httpPath":"/portals/{portalID}/suggestions/{suggestionID}"},{"label":"Get Related Articles for Suggestion","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/suggestion/getrelatedarticlesforsuggestion","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/suggestion/getrelatedarticlesforsuggestion","metadata":{"seo":{"title":"Get Related Articles for Suggestion","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getRelatedArticlesForSuggestion","name":"Get Related Articles for Suggestion","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Related Articles for Suggestion","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"suggestion/getrelatedarticlesforsuggestion/request/overview","deepLinkHash":"/suggestion/getrelatedarticlesforsuggestion#suggestion/getrelatedarticlesforsuggestion/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get Related Articles for Suggestion API allows authenticated users to retrieve related articles for a Suggestion."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"suggestion/getrelatedarticlesforsuggestion/request/prerequisites","deepLinkHash":"/suggestion/getrelatedarticlesforsuggestion#suggestion/getrelatedarticlesforsuggestion/request/prerequisites"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Prerequisites"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Enable the setting \"My Suggestions\" for the portal specified in the URL."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the user is a customer, enable the setting \"Allow Customer Access\" for the portal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Suggestion specified in the URL must belong to the user."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true},{"name":"suggestionID","in":"path","schemaId":"schema_516","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Suggestion."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A Suggestion ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true,"example":"PROD-11829"}],"pointer":"/paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"articleResultAdditionalAttributes","in":"query","schemaId":"schema_527","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The attributes of an Article to be returned "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"in addition to"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" the default list of attributes, listed below. Multiple additional attributes can be specified using a comma-separated list. Passing 'all' will return all attributes."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":4},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Default Attributes"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"These Article attributes are always returned:"},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Name"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"id"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"name"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name of the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"articleType"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Article Type and its attributes."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"createdBy"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID, first name, middle name and last name of the user that created the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"createdDate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date that the Article was created."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"hasAttachments"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"True: The Article has one or more attachments."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"False: The Article does not have any attachments."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"languageCode"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language code of the Article language."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"modifiedBy"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID, first name, middle name and last name of the user that last modified the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"modifiedDate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date that the Article was last modified on."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"link"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The link object, used to retrieve the details of the Article."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"versionId"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article version that is returned."},"children":[]}]}]}]}]}]}],"examples":{"Single":{"description":"An additional attribute to be returned.","value":"[\"averageRating\"]"},"Multiple":{"description":"Additional attributes to be returned.","value":"[\"ownedBy\",\"ownedBy.userName\"]"},"All":{"description":"All additional attributes to be returned.","value":"[\"all\"]"}}}],"pointer":"/paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/{portalID}/suggestions/{suggestionID}/relatedArticles","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"},{"name":"suggestionID","in":"path","required":true,"example":"PROD-11829","schemaId":"schema_516"}],"query":[{"name":"articleResultAdditionalAttributes","in":"query","required":false,"example":["averageRating"],"schemaId":"schema_527","style":"form","explode":false}],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]}],"responseCodes":["200","204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/suggestions/{suggestionID}/relatedArticles","href":"suggestion/getrelatedarticlesforsuggestion","openApiOperationId":"getRelatedArticlesForSuggestion","summary":"Get Related Articles for Suggestion","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/FeedbackArticleForSuggestion","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/200/content/application~1json/examples/All Attributes"]}},"schemaId":"components/schemas/FeedbackArticleForSuggestion","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/200/content/application~1json/examples/All Attributes"]},{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/FeedbackArticleForSuggestion","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/200/content/application~1json/examples/All Attributes"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/FeedbackArticleForSuggestion","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/200/content/application~1json/examples/All Attributes"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/suggestion/getrelatedarticlesforsuggestion"}],"panels":[]}]},"httpPath":"/portals/{portalID}/suggestions/{suggestionID}/relatedArticles"},{"label":"Get Suggestion Comments","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/suggestion/getsuggestioncomments","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/suggestion/getsuggestioncomments","metadata":{"seo":{"title":"Get Suggestion Comments","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getSuggestionComments","name":"Get Suggestion Comments","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Suggestion Comments","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"suggestion/getsuggestioncomments/request/overview","deepLinkHash":"/suggestion/getsuggestioncomments#suggestion/getsuggestioncomments/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get Suggestion Comments API allows authenticated users to retrieve all comments for a Suggestion."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"suggestion/getsuggestioncomments/request/prerequisites","deepLinkHash":"/suggestion/getsuggestioncomments#suggestion/getsuggestioncomments/request/prerequisites"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Prerequisites"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Enable the setting \"My Suggestions\" for the portal specified in the URL."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the user is a customer, enable the setting \"Allow Customer Access\" for the portal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Suggestion specified in the URL must belong to the user."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true},{"name":"suggestionID","in":"path","schemaId":"schema_516","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Suggestion."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A Suggestion ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true,"example":"PROD-11829"}],"pointer":"/paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/{portalID}/suggestions/{suggestionID}/comments","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"},{"name":"suggestionID","in":"path","required":true,"example":"PROD-11829","schemaId":"schema_516"}],"query":[],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]}],"responseCodes":["200","204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/suggestions/{suggestionID}/comments","href":"suggestion/getsuggestioncomments","openApiOperationId":"getSuggestionComments","summary":"Get Suggestion Comments","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Comments","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/200/content/application~1json/examples/Summary Attributes"]}},"schemaId":"components/schemas/Comments","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/200/content/application~1json/examples/Summary Attributes"]},{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/Comments","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/200/content/application~1json/examples/Summary Attributes"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Comments","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/200/content/application~1json/examples/Summary Attributes"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/suggestion/getsuggestioncomments"}],"panels":[]}]},"httpPath":"/portals/{portalID}/suggestions/{suggestionID}/comments"},{"label":"Add a Suggestion Comment","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/suggestion/addsuggestioncomment","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/suggestion/addsuggestioncomment","metadata":{"seo":{"title":"Add a Suggestion Comment","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"addSuggestionComment","name":"Add a Suggestion Comment","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Add a Suggestion Comment","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"suggestion/addsuggestioncomment/request/overview","deepLinkHash":"/suggestion/addsuggestioncomment#suggestion/addsuggestioncomment/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Add Suggestion Comment API allows authenticated users and agents to add a new comment to a Suggestion."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"suggestion/addsuggestioncomment/request/prerequisites","deepLinkHash":"/suggestion/addsuggestioncomment#suggestion/addsuggestioncomment/request/prerequisites"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Prerequisites"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Enable the setting \"My Suggestions\" for the portal specified in the URL."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the user is a customer, enable the setting \"Allow Customer Access\" for the portal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Suggestion specified in the URL must belong to the user, or the user must have appropriate administrative permissions to comment on it."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Suggestion must be in "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Suggested"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pending"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" status, otherwise no comments can be added."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true},{"name":"suggestionID","in":"path","schemaId":"schema_516","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Suggestion."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A Suggestion ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true,"example":"PROD-11829"}],"pointer":"/paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Content-Type","in":"header","schemaId":"schema_525","description":"The media type sent by the client.","required":true},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateComment","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/requestBody/content/application~1json/examples/New Comment"]}},"schemaId":"components/schemas/CreateComment","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/requestBody/content/application~1json/examples/New Comment"],"pointer":"/paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/portals/{portalID}/suggestions/{suggestionID}/comments","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"},{"name":"suggestionID","in":"path","required":true,"example":"PROD-11829","schemaId":"schema_516"}],"query":[],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Content-Type","in":"header","required":true,"schemaId":"schema_525"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateComment","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/requestBody/content/application~1json/examples/New Comment"]}},"responseCodes":["201","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/suggestions/{suggestionID}/comments","href":"suggestion/addsuggestioncomment","openApiOperationId":"addSuggestionComment","summary":"Add a Suggestion Comment","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"schemaId":"components/schemas/CreateComment","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/requestBody/content/application~1json/examples/New Comment"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateComment","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/requestBody/content/application~1json/examples/New Comment"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"201","description":"Created. The comment was successfully added."},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"201"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/suggestion/addsuggestioncomment"}],"panels":[]}]},"httpPath":"/portals/{portalID}/suggestions/{suggestionID}/comments"},{"label":"Get Suggestion Attachments","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/suggestion/getsuggestionattachments","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/suggestion/getsuggestionattachments","metadata":{"seo":{"title":"Get Suggestion Attachments","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getSuggestionAttachments","name":"Get Suggestion Attachments","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Suggestion Attachments","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"suggestion/getsuggestionattachments/request/overview","deepLinkHash":"/suggestion/getsuggestionattachments#suggestion/getsuggestionattachments/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get Suggestion Attachments API allows authenticated users to retrieve attachments for a Suggestion."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"suggestion/getsuggestionattachments/request/prerequisites","deepLinkHash":"/suggestion/getsuggestionattachments#suggestion/getsuggestionattachments/request/prerequisites"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Prerequisites"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Enable the setting \"My Suggestions\" for the portal specified in the URL"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the user is a customer, enable the setting \"Allow Customer Access\" for the portal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Suggestion specified in the URL must belong to the user."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true},{"name":"suggestionID","in":"path","schemaId":"schema_516","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Suggestion."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A Suggestion ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true,"example":"PROD-11829"}],"pointer":"/paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/{portalID}/suggestions/{suggestionID}/attachments","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"},{"name":"suggestionID","in":"path","required":true,"example":"PROD-11829","schemaId":"schema_516"}],"query":[],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]}],"responseCodes":["200","204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/suggestions/{suggestionID}/attachments","href":"suggestion/getsuggestionattachments","openApiOperationId":"getSuggestionAttachments","summary":"Get Suggestion Attachments","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Attachments","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/200/content/application~1json/examples/Summary Attributes"]}},"schemaId":"components/schemas/Attachments","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/200/content/application~1json/examples/Summary Attributes"]},{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/Attachments","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/200/content/application~1json/examples/Summary Attributes"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Attachments","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/200/content/application~1json/examples/Summary Attributes"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/suggestion/getsuggestionattachments"}],"panels":[]}]},"httpPath":"/portals/{portalID}/suggestions/{suggestionID}/attachments"},{"label":"Get Suggestion Attachment by ID","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/suggestion/getsuggestionattachmentbyid","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/suggestion/getsuggestionattachmentbyid","metadata":{"seo":{"title":"Get Suggestion Attachment by ID","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getSuggestionAttachmentById","name":"Get Suggestion Attachment by ID","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Suggestion Attachment by ID","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"suggestion/getsuggestionattachmentbyid/request/overview","deepLinkHash":"/suggestion/getsuggestionattachmentbyid#suggestion/getsuggestionattachmentbyid/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get Suggestion Attachment by ID API allows authenticated users to get the details of an attachment that belongs to their own Suggestion. It also allows the download of attachment content."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"suggestion/getsuggestionattachmentbyid/request/prerequisites","deepLinkHash":"/suggestion/getsuggestionattachmentbyid#suggestion/getsuggestionattachmentbyid/request/prerequisites"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Prerequisites"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Enable the setting \"My Suggestions\" for the portal specified in the URL"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the user is a customer, enable the setting \"Allow Customer Access\" for the portal."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Suggestion specified in the URL must belong to the user."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true},{"name":"attachmentID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the attachment."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An attachment ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"attachmentAdditionalAttributes","in":"query","schemaId":"schema_565","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The attributes of an attachment to be returned, along with the default attachment details."},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Attribute"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"id"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Unique identifier for the attachment"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"fileName"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Name of the file"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"contentType"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Content type of the file"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"size"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Size of the file in bytes"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"link"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Link to the attachment"},"children":[]}]}]}]}]}]}],"examples":{"Single":{"description":"An additional attribute to be returned.","value":"[\"contentUrl\"]"}}}],"pointer":"/paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/{portalID}/suggestions/attachments/{attachmentID}","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"},{"name":"attachmentID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"}],"query":[{"name":"attachmentAdditionalAttributes","in":"query","required":false,"example":["contentUrl"],"schemaId":"schema_565","style":"form","explode":false}],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]}],"responseCodes":["200","204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/suggestions/attachments/{attachmentID}","href":"suggestion/getsuggestionattachmentbyid","openApiOperationId":"getSuggestionAttachmentById","summary":"Get Suggestion Attachment by ID","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SuggestionAttachment","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/200/content/application~1json/examples/All Attributes"]}},"schemaId":"components/schemas/SuggestionAttachment","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/200/content/application~1json/examples/All Attributes"]},{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/SuggestionAttachment","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/200/content/application~1json/examples/All Attributes"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/SuggestionAttachment","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/200/content/application~1json/examples/All Attributes"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/suggestion/getsuggestionattachmentbyid"}],"panels":[]}]},"httpPath":"/portals/{portalID}/suggestions/attachments/{attachmentID}"}],"content":{"contentType":"group","meta":{"name":"Suggestion"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Suggestion","showPageActions":true},{"nodeType":"markdoc","content":"Suggestion APIs"}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/portals/{portalID}/suggestions","summary":"Make a Suggestion","prefix":{"name":"post","color":"post"},"badges":[],"link":"/suggestion/makesuggestion","deprecated":false},{"title":"/portals/{portalID}/suggestions","summary":"Modify Suggestion","prefix":{"name":"put","color":"put"},"badges":[],"link":"/suggestion/modifysuggestions","deprecated":false},{"title":"/portals/{portalID}/suggestions","summary":"Get Suggestion by Status","prefix":{"name":"get","color":"get"},"badges":[],"link":"/suggestion/searchsuggestion","deprecated":false},{"title":"/portals/{portalID}/suggestions/{suggestionID}","summary":"Get Suggestion by ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/suggestion/getsuggestion","deprecated":false},{"title":"/portals/{portalID}/suggestions/{suggestionID}","summary":"Delete a Suggestion","prefix":{"name":"delete","color":"delete"},"badges":[],"link":"/suggestion/deletesuggestion","deprecated":false},{"title":"/portals/{portalID}/suggestions/{suggestionID}/relatedArticles","summary":"Get Related Articles for Suggestion","prefix":{"name":"get","color":"get"},"badges":[],"link":"/suggestion/getrelatedarticlesforsuggestion","deprecated":false},{"title":"/portals/{portalID}/suggestions/{suggestionID}/comments","summary":"Get Suggestion Comments","prefix":{"name":"get","color":"get"},"badges":[],"link":"/suggestion/getsuggestioncomments","deprecated":false},{"title":"/portals/{portalID}/suggestions/{suggestionID}/comments","summary":"Add a Suggestion Comment","prefix":{"name":"post","color":"post"},"badges":[],"link":"/suggestion/addsuggestioncomment","deprecated":false},{"title":"/portals/{portalID}/suggestions/{suggestionID}/attachments","summary":"Get Suggestion Attachments","prefix":{"name":"get","color":"get"},"badges":[],"link":"/suggestion/getsuggestionattachments","deprecated":false},{"title":"/portals/{portalID}/suggestions/attachments/{attachmentID}","summary":"Get Suggestion Attachment by ID","prefix":{"name":"get","color":"get"},"badges":[],"link":"/suggestion/getsuggestionattachmentbyid","deprecated":false}]}]}]}]}},{"type":"group","label":"Topic","link":"/apis/v4/knowledge/portalmgr/api-bundled/topic","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/topic","items":[{"label":"Get Topic Breadcrumb for Article","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/topic/gettopicbreadcrumbforarticle","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/topic/gettopicbreadcrumbforarticle","metadata":{"seo":{"title":"Get Topic Breadcrumb for Article","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getTopicBreadcrumbForArticle","name":"Get Topic Breadcrumb for Article","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Topic Breadcrumb for Article","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"topic/gettopicbreadcrumbforarticle/request/overview","deepLinkHash":"/topic/gettopicbreadcrumbforarticle#topic/gettopicbreadcrumbforarticle/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Use this API to retrieve the topic breadcrumb for an article in a portal. A breadcrumb shows the hierarchical path from the root topic to the article's primary topic."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthClient","scopes":["https://api.egain.cloud/auth/.default"],"type":"oauth2","description":"Authenticate as a client (Server to Server).","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/global/f51302dd-7036-41b5-b619-e1a52a67c780/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/.default":"Default scope"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true},{"name":"articleID","in":"path","schemaId":"schema_511","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An Article ID is composed of a 2-4 letter prefix followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"$lang","in":"query","schemaId":"schema_512","description":"The language used for a resource. Resources available in different languages may differ from each other.","required":true}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true},{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/{portalID}/articles/{articleID}/breadcrumb","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"},{"name":"articleID","in":"path","required":true,"example":"PROD-2996","schemaId":"schema_511"}],"query":[{"name":"$lang","in":"query","required":true,"example":"en-US","schemaId":"components/schemas/LegacyKBLanguageCodes"}],"querystring":[],"header":[{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"},{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthClient","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/global/f51302dd-7036-41b5-b619-e1a52a67c780/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/.default":"Default scope"}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/.default"]}],"responseCodes":["200","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/articles/{articleID}/breadcrumb","href":"topic/gettopicbreadcrumbforarticle","openApiOperationId":"getTopicBreadcrumbForArticle","summary":"Get Topic Breadcrumb for Article"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TopicBreadcrumbsList","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/TopicBreadcrumbsList","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/200/content/application~1json/example"]},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/TopicBreadcrumbsList","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TopicBreadcrumbsList","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/200/content/application~1json/example"]}}},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/topic/gettopicbreadcrumbforarticle"}],"panels":[]}]},"httpPath":"/portals/{portalID}/articles/{articleID}/breadcrumb"},{"label":"Get Immediate Child Topics","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/topic/getchildtopics","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/topic/getchildtopics","metadata":{"seo":{"title":"Get Immediate Child Topics","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getchildtopics","name":"Get Immediate Child Topics","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1topics~1{topicID}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Immediate Child Topics","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"topic/getchildtopics/request/overview","deepLinkHash":"/topic/getchildtopics#topic/getchildtopics/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get Immediate Child Topics API retrieves details about a topic and it's immediate child topics. The "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"$level"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" attribute determines how deep the topic hierarchy should go, or how many child topics of a topic are returned in the response."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]},{"schemes":[{"name":"oAuthAnonymousCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as an anonymous customer.","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}}}]},{"schemes":[{"name":"oAuthClient","scopes":["https://api.egain.cloud/auth/.default"],"type":"oauth2","description":"Authenticate as a client (Server to Server).","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/global/f51302dd-7036-41b5-b619-e1a52a67c780/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/.default":"Default scope"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true},{"name":"topicID","in":"path","schemaId":"schema_566","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of a topic."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A topic ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1topics~1{topicID}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"searchProfileId","in":"query","schemaId":"schema_526","description":"Search Profile ID"},{"name":"level","in":"query","schemaId":"schema_567","description":"Depth of the topic hierarchy to be returned in the response.","examples":{"AllLevels":{"description":"All levels are returned","value":"-1"},"Parent":{"description":"Only parent topic is returned","value":"0"},"Immediate":{"description":"Parent and immediate children topics are returned","value":"1"},"Grand Children":{"description":"Immediate children and grand children are returned","value":"2"}}},{"name":"$lang","in":"query","schemaId":"schema_512","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language used for a resource. Resources available in different languages may differ from each other."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"$lang"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not passed, then the portal's default language is used."},"children":[]}]}]}]},{"name":"topicAdditionalAttributes","in":"query","schemaId":"schema_568","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The attributes of a topic to be returned "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"in addition to"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" the default list of attributes, listed below. Multiple additional attributes can be specified using a comma-separated list. Passing 'all' returns all attributes."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":4},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Default Attributes"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"These topic attributes are always returned:"},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Name"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"id"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the topic."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"name"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name of the topic."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"articleCountInTopic"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Number of articles in this topic."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"articleCountInTopicTree"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Number of articles in this topic and all sub-topics."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"createdBy.id"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the user that created the topic."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"createdDate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date when the topic was created."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"departmentId"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ID of the department for which this topic belongs to."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"topicHomeArticleId"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the article used as the home page of this topic."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"modifiedBy.id"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the user that last modified the topic."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"modifiedDate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date when the topic was last modified on."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"childCount"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Total number of children sub-topis below the current topic"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"subTopicIds"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Array with the list of sub-topics"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"parentTopicId"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ID of the parent topic. -1 if it is the root topic."},"children":[]}]}]}]}]}]}],"examples":{"Single":{"description":"An additional attribute to be returned.","value":"[\"modifiedBy.userName\"]"},"Multiple":{"description":"Additional attributes to be returned.","value":"[\"description\",\"imageUrl\"]"},"All":{"description":"All additional attributes to be returned.","value":"[\"all\"]"}}},{"name":"$customAdditionalAttributes","in":"query","schemaId":"schema_514","examples":{"Single":{"description":"A user-defined custom attribute.","value":"country_name"},"Multiple":{"description":"Multiple user-defined custom attributes.","value":"internalScore,performance-rating_dept_923"}}},{"name":"$pagenum","in":"query","schemaId":"schema_569","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the page number of results to be returned. Used in conjunction with $pagesize."},"children":[]}]}]}]},{"name":"$pagesize","in":"query","schemaId":"schema_570","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the number of results per page. Used in conjunction with $pagenum."},"children":[]}]}]}]}],"pointer":"/paths/~1portals~1{portalID}~1topics~1{topicID}/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}}],"pointer":"/paths/~1portals~1{portalID}~1topics~1{topicID}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/{portalID}/topics/{topicID}","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"},{"name":"topicID","in":"path","required":true,"example":"PROD-1069","schemaId":"schema_566"}],"query":[{"name":"searchProfileId","in":"query","example":"959500000204621","schemaId":"schema_526"},{"name":"level","in":"query","required":false,"example":-1,"schemaId":"schema_567"},{"name":"$lang","in":"query","required":false,"example":"en-US","schemaId":"components/schemas/LegacyKBLanguageCodes"},{"name":"topicAdditionalAttributes","in":"query","required":false,"example":["modifiedBy.userName"],"schemaId":"schema_568","style":"form","explode":false},{"name":"$customAdditionalAttributes","in":"query","required":false,"example":"country_name","schemaId":"schema_514"},{"name":"$pagenum","in":"query","required":false,"schemaId":"schema_569"},{"name":"$pagesize","in":"query","required":false,"schemaId":"schema_570"}],"querystring":[],"header":[{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthAnonymousCustomer","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthClient","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/global/f51302dd-7036-41b5-b619-e1a52a67c780/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/.default":"Default scope"}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/.default"]}],"responseCodes":["200","204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/topics/{topicID}","href":"topic/getchildtopics","openApiOperationId":"getchildtopics","summary":"Get Immediate Child Topics","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthAnonymousCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthClient":["https://api.egain.cloud/auth/.default"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TopicTreeResult","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/200/content/application~1json/examples/Get topic tree with $level value 0","paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/200/content/application~1json/examples/Get topic tree with $level value 1","paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/200/content/application~1json/examples/Topic tree with additional attributes with $level value 0","paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/200/content/application~1json/examples/Topic tree with custom attributes and $level value 0"]}},"schemaId":"components/schemas/TopicTreeResult","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/200/content/application~1json/examples/Get topic tree with $level value 0","paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/200/content/application~1json/examples/Get topic tree with $level value 1","paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/200/content/application~1json/examples/Topic tree with additional attributes with $level value 0","paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/200/content/application~1json/examples/Topic tree with custom attributes and $level value 0"]},{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/TopicTreeResult","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/200/content/application~1json/examples/Get topic tree with $level value 0","paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/200/content/application~1json/examples/Get topic tree with $level value 1","paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/200/content/application~1json/examples/Topic tree with additional attributes with $level value 0","paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/200/content/application~1json/examples/Topic tree with custom attributes and $level value 0"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TopicTreeResult","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/200/content/application~1json/examples/Get topic tree with $level value 0","paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/200/content/application~1json/examples/Get topic tree with $level value 1","paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/200/content/application~1json/examples/Topic tree with additional attributes with $level value 0","paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/200/content/application~1json/examples/Topic tree with custom attributes and $level value 0"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/topic/getchildtopics"}],"panels":[]}]},"httpPath":"/portals/{portalID}/topics/{topicID}"},{"label":"Get All Ancestor Topics","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/topic/getancestortopics","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/topic/getancestortopics","metadata":{"seo":{"title":"Get All Ancestor Topics","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getancestortopics","name":"Get All Ancestor Topics","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get All Ancestor Topics","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"topic/getancestortopics/request/overview","deepLinkHash":"/topic/getancestortopics#topic/getancestortopics/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get All Ancestor Topics API retrieves the hierarchy from the root topic down to the given topic."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]},{"schemes":[{"name":"oAuthAnonymousCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as an anonymous customer.","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true},{"name":"topicID","in":"path","schemaId":"schema_566","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of a topic."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A topic ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"$lang","in":"query","schemaId":"schema_512","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language used for a resource. Resources available in different languages may differ from each other."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"$lang"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not passed, then the portal's default language is used."},"children":[]}]}]}]},{"name":"topicAdditionalAttributes","in":"query","schemaId":"schema_568","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The attributes of a topic to be returned "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"in addition to"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" the default list of attributes, listed below. Multiple additional attributes can be specified using a comma-separated list. Passing 'all' returns all attributes."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":4},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Default Attributes"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"These topic attributes are always returned:"},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Name"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"id"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the topic."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"name"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name of the topic."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"articleCountInTopic"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Number of articles in this topic."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"articleCountInTopicTree"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Number of articles in this topic and all sub-topics."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"createdBy.id"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the user that created the topic."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"createdDate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date when the topic was created."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"departmentId"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ID of the department for which this topic belongs to."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"topicHomeArticleId"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the article used as the home page of this topic."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"modifiedBy.id"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the user that last modified the topic."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"modifiedDate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date when the topic was last modified on."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"childCount"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Total number of children sub-topis below the current topic"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"subTopicIds"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Array with the list of sub-topics"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"parentTopicId"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ID of the parent topic. -1 if it is the root topic."},"children":[]}]}]}]}]}]}],"examples":{"Single":{"description":"An additional attribute to be returned.","value":"[\"modifiedBy.userName\"]"},"Multiple":{"description":"Additional attributes to be returned.","value":"[\"description\",\"imageUrl\"]"},"All":{"description":"All additional attributes to be returned.","value":"[\"all\"]"}}},{"name":"$customAdditionalAttributes","in":"query","schemaId":"schema_514","examples":{"Single":{"description":"A user-defined custom attribute.","value":"country_name"},"Multiple":{"description":"Multiple user-defined custom attributes.","value":"internalScore,performance-rating_dept_923"}}},{"name":"$pagenum","in":"query","schemaId":"schema_569","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the page number of results to be returned. Used in conjunction with $pagesize."},"children":[]}]}]}]},{"name":"$pagesize","in":"query","schemaId":"schema_570","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the number of results per page. Used in conjunction with $pagenum."},"children":[]}]}]}]}],"pointer":"/paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}}],"pointer":"/paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/{portalID}/topics/{topicID}/parents","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"},{"name":"topicID","in":"path","required":true,"example":"PROD-1069","schemaId":"schema_566"}],"query":[{"name":"$lang","in":"query","required":false,"example":"en-US","schemaId":"components/schemas/LegacyKBLanguageCodes"},{"name":"topicAdditionalAttributes","in":"query","required":false,"example":["modifiedBy.userName"],"schemaId":"schema_568","style":"form","explode":false},{"name":"$customAdditionalAttributes","in":"query","required":false,"example":"country_name","schemaId":"schema_514"},{"name":"$pagenum","in":"query","required":false,"schemaId":"schema_569"},{"name":"$pagesize","in":"query","required":false,"schemaId":"schema_570"}],"querystring":[],"header":[{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthAnonymousCustomer","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}],"responseCodes":["200","204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/topics/{topicID}/parents","href":"topic/getancestortopics","openApiOperationId":"getancestortopics","summary":"Get All Ancestor Topics","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthAnonymousCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TopicResult","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/200/content/application~1json/examples/With Additional Attributes"]}},"schemaId":"components/schemas/TopicResult","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/200/content/application~1json/examples/With Additional Attributes"]},{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/TopicResult","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/200/content/application~1json/examples/With Additional Attributes"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TopicResult","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/200/content/application~1json/examples/Summary Attributes","paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/200/content/application~1json/examples/With Additional Attributes"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/topic/getancestortopics"}],"panels":[]}]},"httpPath":"/portals/{portalID}/topics/{topicID}/parents"},{"label":"Get All Topics","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/topic/getalltopics","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/topic/getalltopics","metadata":{"seo":{"title":"Get All Topics","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getalltopics","name":"Get All Topics","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1topics/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get All Topics","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"topic/getalltopics/request/overview","deepLinkHash":"/topic/getalltopics#topic/getalltopics/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get All Topics API retrieves the topic tree for a portal. The "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"$level"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" attribute determines how deep the topic hierarchy should go, or how many child topics of a topic are returned in the response."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthClient","scopes":["https://api.egain.cloud/auth/.default"],"type":"oauth2","description":"Authenticate as a client (Server to Server).","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/global/f51302dd-7036-41b5-b619-e1a52a67c780/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/.default":"Default scope"}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]},{"schemes":[{"name":"oAuthAnonymousCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as an anonymous customer.","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1topics/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"searchProfileId","in":"query","schemaId":"schema_526","description":"Search Profile ID"},{"name":"level","in":"query","schemaId":"schema_567","description":"Depth of the topic hierarchy to be returned in the response.","examples":{"AllLevels":{"description":"All levels are returned","value":"-1"},"Parent":{"description":"Only parent topic is returned","value":"0"},"Immediate":{"description":"Parent and immediate children topics are returned","value":"1"},"Grand Children":{"description":"Immediate children and grand children are returned","value":"2"}}},{"name":"$lang","in":"query","schemaId":"schema_512","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language used for a resource. Resources available in different languages may differ from each other."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"$lang"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not passed, then the portal's default language is used."},"children":[]}]}]}]},{"name":"topicAdditionalAttributes","in":"query","schemaId":"schema_568","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The attributes of a topic to be returned "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"in addition to"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" the default list of attributes, listed below. Multiple additional attributes can be specified using a comma-separated list. Passing 'all' returns all attributes."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":4},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Default Attributes"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"These topic attributes are always returned:"},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Name"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"id"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the topic."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"name"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name of the topic."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"articleCountInTopic"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Number of articles in this topic."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"articleCountInTopicTree"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Number of articles in this topic and all sub-topics."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"createdBy.id"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the user that created the topic."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"createdDate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date when the topic was created."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"departmentId"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ID of the department for which this topic belongs to."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"topicHomeArticleId"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the article used as the home page of this topic."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"modifiedBy.id"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the user that last modified the topic."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"modifiedDate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date when the topic was last modified on."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"childCount"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Total number of children sub-topis below the current topic"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"subTopicIds"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Array with the list of sub-topics"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"parentTopicId"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ID of the parent topic. -1 if it is the root topic."},"children":[]}]}]}]}]}]}],"examples":{"Single":{"description":"An additional attribute to be returned.","value":"[\"modifiedBy.userName\"]"},"Multiple":{"description":"Additional attributes to be returned.","value":"[\"description\",\"imageUrl\"]"},"All":{"description":"All additional attributes to be returned.","value":"[\"all\"]"}}},{"name":"$customAdditionalAttributes","in":"query","schemaId":"schema_514","examples":{"Single":{"description":"A user-defined custom attribute.","value":"country_name"},"Multiple":{"description":"Multiple user-defined custom attributes.","value":"internalScore,performance-rating_dept_923"}}},{"name":"$pagenum","in":"query","schemaId":"schema_569","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the page number of results to be returned. Used in conjunction with $pagesize."},"children":[]}]}]}]},{"name":"$pagesize","in":"query","schemaId":"schema_570","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pagination parameter that specifies the number of results per page. Used in conjunction with $pagenum."},"children":[]}]}]}]}],"pointer":"/paths/~1portals~1{portalID}~1topics/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}}],"pointer":"/paths/~1portals~1{portalID}~1topics/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/{portalID}/topics","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"}],"query":[{"name":"searchProfileId","in":"query","example":"959500000204621","schemaId":"schema_526"},{"name":"level","in":"query","required":false,"example":-1,"schemaId":"schema_567"},{"name":"$lang","in":"query","required":false,"example":"en-US","schemaId":"components/schemas/LegacyKBLanguageCodes"},{"name":"topicAdditionalAttributes","in":"query","required":false,"example":["modifiedBy.userName"],"schemaId":"schema_568","style":"form","explode":false},{"name":"$customAdditionalAttributes","in":"query","required":false,"example":"country_name","schemaId":"schema_514"},{"name":"$pagenum","in":"query","required":false,"schemaId":"schema_569"},{"name":"$pagesize","in":"query","required":false,"schemaId":"schema_570"}],"querystring":[],"header":[{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthClient","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/global/f51302dd-7036-41b5-b619-e1a52a67c780/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/.default":"Default scope"}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/.default"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"schemes":[{"id":"oAuthAnonymousCustomer","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}],"responseCodes":["200","204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/topics","href":"topic/getalltopics","openApiOperationId":"getalltopics","summary":"Get All Topics","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthClient":["https://api.egain.cloud/auth/.default"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]},{"oAuthAnonymousCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TopicTreeResult","exampleIds":["paths/~1portals~1{portalID}~1topics/get/responses/200/content/application~1json/examples/Summary Attributes"]}},"schemaId":"components/schemas/TopicTreeResult","exampleIds":["paths/~1portals~1{portalID}~1topics/get/responses/200/content/application~1json/examples/Summary Attributes"]},{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1topics/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1topics/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1topics/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/TopicTreeResult","exampleIds":["paths/~1portals~1{portalID}~1topics/get/responses/200/content/application~1json/examples/Summary Attributes"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/TopicTreeResult","exampleIds":["paths/~1portals~1{portalID}~1topics/get/responses/200/content/application~1json/examples/Summary Attributes"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1topics/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1topics/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1topics/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/topic/getalltopics"}],"panels":[]}]},"httpPath":"/portals/{portalID}/topics"}],"content":{"contentType":"group","meta":{"name":"Topic"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Topic","showPageActions":true},{"nodeType":"markdoc","content":"Topic APIs"}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/portals/{portalID}/articles/{articleID}/breadcrumb","summary":"Get Topic Breadcrumb for Article","prefix":{"name":"get","color":"get"},"badges":[],"link":"/topic/gettopicbreadcrumbforarticle","deprecated":false},{"title":"/portals/{portalID}/topics/{topicID}","summary":"Get Immediate Child Topics","prefix":{"name":"get","color":"get"},"badges":[],"link":"/topic/getchildtopics","deprecated":false},{"title":"/portals/{portalID}/topics/{topicID}/parents","summary":"Get All Ancestor Topics","prefix":{"name":"get","color":"get"},"badges":[],"link":"/topic/getancestortopics","deprecated":false},{"title":"/portals/{portalID}/topics","summary":"Get All Topics","prefix":{"name":"get","color":"get"},"badges":[],"link":"/topic/getalltopics","deprecated":false}]}]}]}]}},{"type":"group","label":"User Details","link":"/apis/v4/knowledge/portalmgr/api-bundled/user-details","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/user-details","items":[{"label":"Get User Details","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/user-details/getuserdetails","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/user-details/getuserdetails","metadata":{"seo":{"title":"Get User Details","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getUserDetails","name":"Get User Details","isWebhook":false,"pointer":"/paths/~1portals~1user/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get User Details","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"user-details/getuserdetails/request/overview","deepLinkHash":"/user-details/getuserdetails#user-details/getuserdetails/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get User Details API retrieves details of a knowledge user."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1user/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/user","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]}],"responseCodes":["200","204","400","401","403","406","500"],"pointer":"/portals/user","href":"user-details/getuserdetails","openApiOperationId":"getUserDetails","summary":"Get User Details","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/UserDetails","exampleIds":["paths/~1portals~1user/get/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/UserDetails","exampleIds":["paths/~1portals~1user/get/responses/200/content/application~1json/example"]},{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1user/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1user/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1user/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/UserDetails","exampleIds":["paths/~1portals~1user/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/UserDetails","exampleIds":["paths/~1portals~1user/get/responses/200/content/application~1json/example"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1user/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1user/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/user-details/getuserdetails"}],"panels":[]}]},"httpPath":"/portals/user"}],"content":{"contentType":"group","meta":{"name":"User Details"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"User Details","showPageActions":true},{"nodeType":"markdoc","content":"User Details APIs"}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/portals/user","summary":"Get User Details","prefix":{"name":"get","color":"get"},"badges":[],"link":"/user-details/getuserdetails","deprecated":false}]}]}]}]}},{"type":"group","label":"User Milestones","link":"/apis/v4/knowledge/portalmgr/api-bundled/user-milestones","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/user-milestones","items":[{"label":"Get User Milestones","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/user-milestones/getusermilestones","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/user-milestones/getusermilestones","metadata":{"seo":{"title":"Get User Milestones","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getUserMilestones","name":"Get User Milestones","isWebhook":false,"pointer":"/paths/~1portals~1user~1milestones/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get User Milestones","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"user-milestones/getusermilestones/request/overview","deepLinkHash":"/user-milestones/getusermilestones#user-milestones/getusermilestones/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The User Milestones API provides information about the milestones of an agent within the article workflow."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This API helps track the progress of articles by grouping them into relevant milestones based on their current stage."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For example, an article might go through Knowledge Workflow Stages like Draft, Initial Review, Staging, Final Review and Publish."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Articles in the Draft and Initial Review stages are part of the \"authoring milestone\", while articles in the Staging and Final Review stages are part of the \"staging milestone\"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1user~1milestones/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/user/milestones","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]}],"responseCodes":["200","204","400","401","403","406","500"],"pointer":"/portals/user/milestones","href":"user-milestones/getusermilestones","openApiOperationId":"getUserMilestones","summary":"Get User Milestones","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Milestones","exampleIds":["paths/~1portals~1user~1milestones/get/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/Milestones","exampleIds":["paths/~1portals~1user~1milestones/get/responses/200/content/application~1json/example"]},{"code":"204","description":"No Milestones configured for the user"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user~1milestones/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1user~1milestones/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user~1milestones/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1user~1milestones/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user~1milestones/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user~1milestones/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user~1milestones/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user~1milestones/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user~1milestones/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user~1milestones/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user~1milestones/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user~1milestones/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1user~1milestones/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/Milestones","exampleIds":["paths/~1portals~1user~1milestones/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Milestones","exampleIds":["paths/~1portals~1user~1milestones/get/responses/200/content/application~1json/example"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user~1milestones/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1user~1milestones/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user~1milestones/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1user~1milestones/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user~1milestones/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user~1milestones/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user~1milestones/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user~1milestones/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user~1milestones/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user~1milestones/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user~1milestones/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1user~1milestones/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/user-milestones/getusermilestones"}],"panels":[]}]},"httpPath":"/portals/user/milestones"}],"content":{"contentType":"group","meta":{"name":"User Milestones"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"User Milestones","showPageActions":true},{"nodeType":"markdoc","content":"User Milestones APIs"}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/portals/user/milestones","summary":"Get User Milestones","prefix":{"name":"get","color":"get"},"badges":[],"link":"/user-milestones/getusermilestones","deprecated":false}]}]}]}]}},{"type":"group","label":"User Profile","link":"/apis/v4/knowledge/portalmgr/api-bundled/user-profile","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/user-profile","items":[{"label":"Get All User Profiles Assigned to User","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/user-profile/getalluserprofiles","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/user-profile/getalluserprofiles","metadata":{"seo":{"title":"Get All User Profiles Assigned to User","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getAllUserProfiles","name":"Get All User Profiles Assigned to User","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1userprofiles/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get All User Profiles Assigned to User","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"user-profile/getalluserprofiles/request/overview","deepLinkHash":"/user-profile/getalluserprofiles#user-profile/getalluserprofiles/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Get All User Profiles Assigned to User API retrieves all user profiles in the portal that are assigned to the user, displayed in ascending order of name."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1userprofiles/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"$lang","in":"query","schemaId":"schema_512","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The language used for a resource. Resources available in different languages may differ from each other."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"$lang"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is not passed, then the portal's default language is used."},"children":[]}]}]}]}],"pointer":"/paths/~1portals~1{portalID}~1userprofiles/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}}],"pointer":"/paths/~1portals~1{portalID}~1userprofiles/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/portals/{portalID}/userprofiles","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"}],"query":[{"name":"$lang","in":"query","required":false,"example":"en-US","schemaId":"components/schemas/LegacyKBLanguageCodes"}],"querystring":[],"header":[{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]}],"responseCodes":["200","204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/userprofiles","href":"user-profile/getalluserprofiles","openApiOperationId":"getAllUserProfiles","summary":"Get All User Profiles Assigned to User","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.read"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/UserProfiles","exampleIds":["paths/~1portals~1{portalID}~1userprofiles/get/responses/200/content/application~1json/example"]}},"schemaId":"components/schemas/UserProfiles","exampleIds":["paths/~1portals~1{portalID}~1userprofiles/get/responses/200/content/application~1json/example"]},{"code":"204","description":"When no profiles are assigned to user."},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1userprofiles/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1userprofiles/get/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles/get/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles/get/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles/get/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles/get/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles/get/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles/get/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles/get/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles/get/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1userprofiles/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/UserProfiles","exampleIds":["paths/~1portals~1{portalID}~1userprofiles/get/responses/200/content/application~1json/example"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/UserProfiles","exampleIds":["paths/~1portals~1{portalID}~1userprofiles/get/responses/200/content/application~1json/example"]}}},{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1userprofiles/get/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles/get/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1userprofiles/get/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles/get/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles/get/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles/get/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles/get/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles/get/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles/get/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles/get/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles/get/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/user-profile/getalluserprofiles"}],"panels":[]}]},"httpPath":"/portals/{portalID}/userprofiles"},{"label":"Select User Profile","deprecated":false,"httpVerb":"put","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/user-profile/selectuserprofile","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/user-profile/selectuserprofile","metadata":{"seo":{"title":"Select User Profile","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"selectUserProfile","name":"Select User Profile","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Select User Profile","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"user-profile/selectuserprofile/request/overview","deepLinkHash":"/user-profile/selectuserprofile#user-profile/selectuserprofile/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Select User Profile API allows a user to set the user profile for a portal."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true},{"name":"userProfileID","in":"path","schemaId":"schema_571","description":"The ID of the user profile. \n","required":true}],"pointer":"/paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}}],"pointer":"/paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"PUT","path":"/portals/{portalID}/userprofiles/{userProfileID}/select","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"},{"name":"userProfileID","in":"path","required":true,"example":"PROD-3210","schemaId":"schema_571"}],"query":[],"querystring":[],"header":[{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]}],"responseCodes":["204","400","401","403","404","406","500"],"pointer":"/portals/{portalID}/userprofiles/{userProfileID}/select","href":"user-profile/selectuserprofile","openApiOperationId":"selectUserProfile","summary":"Select User Profile","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/user-profile/selectuserprofile"}],"panels":[]}]},"httpPath":"/portals/{portalID}/userprofiles/{userProfileID}/select"}],"content":{"contentType":"group","meta":{"name":"User Profile"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"User Profile","showPageActions":true},{"nodeType":"markdoc","content":"UserProfile APIs"}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/portals/{portalID}/userprofiles","summary":"Get All User Profiles Assigned to User","prefix":{"name":"get","color":"get"},"badges":[],"link":"/user-profile/getalluserprofiles","deprecated":false},{"title":"/portals/{portalID}/userprofiles/{userProfileID}/select","summary":"Select User Profile","prefix":{"name":"put","color":"put"},"badges":[],"link":"/user-profile/selectuserprofile","deprecated":false}]}]}]}]}},{"type":"group","label":"Federated Search Event","link":"/apis/v4/knowledge/portalmgr/api-bundled/federated-search-event","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/federated-search-event","items":[{"label":"Event For Viewed Federated Search Result","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/federated-search-event/createfederatedsearchresultevent","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/federated-search-event/createfederatedsearchresultevent","metadata":{"seo":{"title":"Event For Viewed Federated Search Result","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createFederatedSearchResultEvent","name":"Event For Viewed Federated Search Result","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1search~1federated~1event/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Event For Viewed Federated Search Result","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"federated-search-event/createfederatedsearchresultevent/request/overview","deepLinkHash":"/federated-search-event/createfederatedsearchresultevent#federated-search-event/createfederatedsearchresultevent/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Federated Search Event API creates an event for federated search results that have been viewed."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An event for viewing an:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"External web page cannot be created for a portal where the value for the \"Include Web Search Section in Search Results\" attribute is \"Yes\"."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Internal web page cannot be created for a portal where the value for the \"Include Intranet Search Section in Search Results\" attribute is \"Yes\"."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]},{"schemes":[{"name":"oAuthAnonymousCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as an anonymous customer.","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1search~1federated~1event/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"Content-Type","in":"header","schemaId":"schema_525","description":"The media type sent by the client.","required":true},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1portals~1{portalID}~1search~1federated~1event/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateFederatedSearchEvent","exampleIds":["paths/~1portals~1{portalID}~1search~1federated~1event/post/requestBody/content/application~1json/examples/All attributes present"]}},"schemaId":"components/schemas/CreateFederatedSearchEvent","exampleIds":["paths/~1portals~1{portalID}~1search~1federated~1event/post/requestBody/content/application~1json/examples/All attributes present"],"pointer":"/paths/~1portals~1{portalID}~1search~1federated~1event/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/portals/{portalID}/search/federated/event","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"}],"query":[],"querystring":[],"header":[{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"Content-Type","in":"header","required":true,"schemaId":"schema_525"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"schemes":[{"id":"oAuthAnonymousCustomer","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/CreateFederatedSearchEvent","exampleIds":["paths/~1portals~1{portalID}~1search~1federated~1event/post/requestBody/content/application~1json/examples/All attributes present"]}},"responseCodes":["204","400","401","403","404","406","415","500"],"pointer":"/portals/{portalID}/search/federated/event","href":"federated-search-event/createfederatedsearchresultevent","openApiOperationId":"createFederatedSearchResultEvent","summary":"Event For Viewed Federated Search Result","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"oAuthAnonymousCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"schemaId":"components/schemas/CreateFederatedSearchEvent","exampleIds":["paths/~1portals~1{portalID}~1search~1federated~1event/post/requestBody/content/application~1json/examples/All attributes present"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/CreateFederatedSearchEvent","exampleIds":["paths/~1portals~1{portalID}~1search~1federated~1event/post/requestBody/content/application~1json/examples/All attributes present"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"415","description":"Incorrect Content Type Header"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1search~1federated~1event/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"415"},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/federated-search-event/createfederatedsearchresultevent"}],"panels":[]}]},"httpPath":"/portals/{portalID}/search/federated/event"}],"content":{"contentType":"group","meta":{"name":"Federated Search Event"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Federated Search Event","showPageActions":true},{"nodeType":"markdoc","content":"Federated Search Event API"}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/portals/{portalID}/search/federated/event","summary":"Event For Viewed Federated Search Result","prefix":{"name":"post","color":"post"},"badges":[],"link":"/federated-search-event/createfederatedsearchresultevent","deprecated":false}]}]}]}]}},{"type":"group","label":"Connectors Search Events","link":"/apis/v4/knowledge/portalmgr/api-bundled/connectors-search-events","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/connectors-search-events","items":[{"label":"Event for Search Using Connectors","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/connectors-search-events/createsearchresulteventforconnectors","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/connectors-search-events/createsearchresulteventforconnectors","metadata":{"seo":{"title":"Event for Search Using Connectors","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createSearchResultEventForConnectors","name":"Event for Search Using Connectors","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1search~1connectors~1event/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Event for Search Using Connectors","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"connectors-search-events/createsearchresulteventforconnectors/request/overview","deepLinkHash":"/connectors-search-events/createsearchresulteventforconnectors#connectors-search-events/createsearchresulteventforconnectors/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Event for Search Using Connectors API creates an event to initiate a search operation for retrieving content from external sources or integrations within the portal."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It allows users to set up search events based on specified criteria."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]},{"schemes":[{"name":"oAuthAnonymousCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as an anonymous customer.","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1search~1connectors~1event/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Content-Type","in":"header","schemaId":"schema_525","description":"The media type sent by the client.","required":true},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}}],"pointer":"/paths/~1portals~1{portalID}~1search~1connectors~1event/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/createSearchResultEventForConnectors","exampleIds":["paths/~1portals~1{portalID}~1search~1connectors~1event/post/requestBody/content/application~1json/examples/All attributes present"]}},"schemaId":"components/schemas/createSearchResultEventForConnectors","exampleIds":["paths/~1portals~1{portalID}~1search~1connectors~1event/post/requestBody/content/application~1json/examples/All attributes present"],"pointer":"/paths/~1portals~1{portalID}~1search~1connectors~1event/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/portals/{portalID}/search/connectors/event","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"}],"query":[],"querystring":[],"header":[{"name":"Content-Type","in":"header","required":true,"schemaId":"schema_525"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"schemes":[{"id":"oAuthAnonymousCustomer","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/createSearchResultEventForConnectors","exampleIds":["paths/~1portals~1{portalID}~1search~1connectors~1event/post/requestBody/content/application~1json/examples/All attributes present"]}},"responseCodes":["204","400","401","403","404","406","415","500"],"pointer":"/portals/{portalID}/search/connectors/event","href":"connectors-search-events/createsearchresulteventforconnectors","openApiOperationId":"createSearchResultEventForConnectors","summary":"Event for Search Using Connectors","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"oAuthAnonymousCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"schemaId":"components/schemas/createSearchResultEventForConnectors","exampleIds":["paths/~1portals~1{portalID}~1search~1connectors~1event/post/requestBody/content/application~1json/examples/All attributes present"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/createSearchResultEventForConnectors","exampleIds":["paths/~1portals~1{portalID}~1search~1connectors~1event/post/requestBody/content/application~1json/examples/All attributes present"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"415","description":"Incorrect Content Type Header"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"415"},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/connectors-search-events/createsearchresulteventforconnectors"}],"panels":[]}]},"httpPath":"/portals/{portalID}/search/connectors/event"},{"label":"Event for Viewed Search Results Using Connectors","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/connectors-search-events/createviewedsearchresultseventforconnectors","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/connectors-search-events/createviewedsearchresultseventforconnectors","metadata":{"seo":{"title":"Event for Viewed Search Results Using Connectors","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createViewedSearchResultsEventForConnectors","name":"Event for Viewed Search Results Using Connectors","isWebhook":false,"pointer":"/paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Event for Viewed Search Results Using Connectors","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"connectors-search-events/createviewedsearchresultseventforconnectors/request/overview","deepLinkHash":"/connectors-search-events/createviewedsearchresultseventforconnectors#connectors-search-events/createviewedsearchresultseventforconnectors/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Event for Viewed Search Results Using Connectors API creates an event to log when search results from external content are viewed."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This helps in tracking and analyzing user interactions with search results retrieved from various external sources."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]},{"schemes":[{"name":"oAuthAnonymousCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as an anonymous customer.","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"portalID","in":"path","schemaId":"schema_510","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Content-Type","in":"header","schemaId":"schema_525","description":"The media type sent by the client.","required":true},{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true},{"name":"x-ext-integration-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The unique numeric identifier for a tenant, used in self-service functionality as well as third-party integrations."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}},{"name":"x-egain-activity-id","in":"header","schemaId":"schema_518","description":"A unique numeric interaction identifier from eGain.","example":"59237"},{"name":"x-ext-interaction-id","in":"header","schemaId":"schema_519","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A unique interaction identifier from other CRM applications."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note: The x-ext-integration-id and x-ext-interaction-id headers must always be provided together and cannot be supplied independently."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The x-egain-activity-id may be provided on its own, or it may be provided along with both x-ext-integration-id and x-ext-interaction-id."},"children":[]}]}]}]}],"examples":{"uuid":{"value":"3155180e-0c13-43e9-9c38-e9045bcbf176"},"hex":{"value":"00Dbn00000IxGnx"}}}],"pointer":"/paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/createViewedSearchResultEventForConnectors","exampleIds":["paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/requestBody/content/application~1json/examples/All attributes present"]}},"schemaId":"components/schemas/createViewedSearchResultEventForConnectors","exampleIds":["paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/requestBody/content/application~1json/examples/All attributes present"],"pointer":"/paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/portals/{portalID}/view/searchresults/connectors/event","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"portalID","in":"path","required":true,"example":"PROD-1000","schemaId":"schema_510"}],"query":[],"querystring":[],"header":[{"name":"Content-Type","in":"header","required":true,"schemaId":"schema_525"},{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"},{"name":"x-ext-integration-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"},{"name":"x-egain-activity-id","in":"header","required":false,"example":"59237","schemaId":"schema_518"},{"name":"x-ext-interaction-id","in":"header","required":false,"example":"3155180e-0c13-43e9-9c38-e9045bcbf176","schemaId":"schema_519"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"schemes":[{"id":"oAuthAnonymousCustomer","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/createViewedSearchResultEventForConnectors","exampleIds":["paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/requestBody/content/application~1json/examples/All attributes present"]}},"responseCodes":["204","400","401","403","404","406","415","500"],"pointer":"/portals/{portalID}/view/searchresults/connectors/event","href":"connectors-search-events/createviewedsearchresultseventforconnectors","openApiOperationId":"createViewedSearchResultsEventForConnectors","summary":"Event for Viewed Search Results Using Connectors","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"oAuthAnonymousCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"schemaId":"components/schemas/createViewedSearchResultEventForConnectors","exampleIds":["paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/requestBody/content/application~1json/examples/All attributes present"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/createViewedSearchResultEventForConnectors","exampleIds":["paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/requestBody/content/application~1json/examples/All attributes present"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"204","description":"No Content"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"415","description":"Incorrect Content Type Header"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"204"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"415"},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/connectors-search-events/createviewedsearchresultseventforconnectors"}],"panels":[]}]},"httpPath":"/portals/{portalID}/view/searchresults/connectors/event"}],"content":{"contentType":"group","meta":{"name":"Connectors Search Events"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Connectors Search Events","showPageActions":true},{"nodeType":"markdoc","content":"Connectors Search Event APIs"}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/portals/{portalID}/search/connectors/event","summary":"Event for Search Using Connectors","prefix":{"name":"post","color":"post"},"badges":[],"link":"/connectors-search-events/createsearchresulteventforconnectors","deprecated":false},{"title":"/portals/{portalID}/view/searchresults/connectors/event","summary":"Event for Viewed Search Results Using Connectors","prefix":{"name":"post","color":"post"},"badges":[],"link":"/connectors-search-events/createviewedsearchresultseventforconnectors","deprecated":false}]}]}]}]}},{"type":"group","label":"Attachment","link":"/apis/v4/knowledge/portalmgr/api-bundled/attachment","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/attachment","items":[{"label":"Generate Signed URL to Upload API","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/attachment/createsignedurl","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/attachment/createsignedurl","metadata":{"seo":{"title":"Generate Signed URL to Upload API","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"createSignedURL","name":"Generate Signed URL to Upload API","isWebhook":false,"pointer":"/paths/~1attachment~1preupload/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Generate Signed URL to Upload API","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"attachment/createsignedurl/request/overview","deepLinkHash":"/attachment/createsignedurl#attachment/createsignedurl/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Generate Signed URL to Upload API produces a signature that is used to upload an attachment."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfUser","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}]},{"schemes":[{"name":"oAuthCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}}}]},{"schemes":[{"name":"oAuthOnBehalfOfCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"],"type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}]},{"schemes":[{"name":"oAuthAnonymousCustomer","scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"],"type":"oauth2","description":"Authenticate as an anonymous customer.","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1attachment~1preupload/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AttachmentUpload","exampleIds":["paths/~1attachment~1preupload/post/requestBody/content/application~1json/examples/All attributes present"]}},"schemaId":"components/schemas/AttachmentUpload","exampleIds":["paths/~1attachment~1preupload/post/requestBody/content/application~1json/examples/All attributes present"],"pointer":"/paths/~1attachment~1preupload/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/attachment/preupload","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthUser","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfUser","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"schemes":[{"id":"oAuthCustomer","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"schemes":[{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"schemes":[{"id":"oAuthAnonymousCustomer","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/AttachmentUpload","exampleIds":["paths/~1attachment~1preupload/post/requestBody/content/application~1json/examples/All attributes present"]}},"responseCodes":["200","400","401","403","404","406","415","500"],"pointer":"/attachment/preupload","href":"attachment/createsignedurl","openApiOperationId":"createSignedURL","summary":"Generate Signed URL to Upload API","securityGroups":[{"oAuthUser":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfUser":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"oAuthCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]},{"oAuthOnBehalfOfCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage"]},{"oAuthAnonymousCustomer":["https://api.egain.cloud/auth/knowledge.portalmgr.manage"]}]},"isWebhook":false,"hideReplay":false,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"schemaId":"components/schemas/AttachmentUpload","exampleIds":["paths/~1attachment~1preupload/post/requestBody/content/application~1json/examples/All attributes present"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/AttachmentUpload","exampleIds":["paths/~1attachment~1preupload/post/requestBody/content/application~1json/examples/All attributes present"]}},"examples":[{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"Success","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Attachment","exampleIds":["paths/~1attachment~1preupload/post/responses/200/content/application~1json/examples/All Attributes"]}},"schemaId":"components/schemas/Attachment","exampleIds":["paths/~1attachment~1preupload/post/responses/200/content/application~1json/examples/All Attributes"]},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1attachment~1preupload/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1attachment~1preupload/post/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1attachment~1preupload/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1attachment~1preupload/post/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1attachment~1preupload/post/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1attachment~1preupload/post/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1attachment~1preupload/post/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1attachment~1preupload/post/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1attachment~1preupload/post/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1attachment~1preupload/post/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1attachment~1preupload/post/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1attachment~1preupload/post/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"415","description":"Incorrect Content Type Header"},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1attachment~1preupload/post/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1attachment~1preupload/post/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1attachment~1preupload/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/Attachment","exampleIds":["paths/~1attachment~1preupload/post/responses/200/content/application~1json/examples/All Attributes"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Attachment","exampleIds":["paths/~1attachment~1preupload/post/responses/200/content/application~1json/examples/All Attributes"]}}},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1attachment~1preupload/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1attachment~1preupload/post/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1attachment~1preupload/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1attachment~1preupload/post/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1attachment~1preupload/post/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1attachment~1preupload/post/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1attachment~1preupload/post/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1attachment~1preupload/post/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1attachment~1preupload/post/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1attachment~1preupload/post/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1attachment~1preupload/post/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1attachment~1preupload/post/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"415"},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1attachment~1preupload/post/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1attachment~1preupload/post/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/attachment/createsignedurl"}],"panels":[]}]},"httpPath":"/attachment/preupload"}],"content":{"contentType":"group","meta":{"name":"Attachment"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Attachment","showPageActions":true},{"nodeType":"markdoc","content":"Attachment Upload API"}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/attachment/preupload","summary":"Generate Signed URL to Upload API","prefix":{"name":"post","color":"post"},"badges":[],"link":"/attachment/createsignedurl","deprecated":false}]}]}]}]}},{"type":"group","label":"Export","link":"/apis/v4/knowledge/portalmgr/api-bundled/export","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/export","items":[{"label":"Export Knowledge","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/export/exportcontent","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/export/exportcontent","metadata":{"seo":{"title":"Export Knowledge","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"exportContent","name":"Export Knowledge","isWebhook":false,"pointer":"/paths/~1content~1export/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Export Knowledge","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"export/exportcontent/request/overview","deepLinkHash":"/export/exportcontent#export/exportcontent/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Content Export API initiates a bulk export of the Knowledge Hub to a client-provided Amazon S3 bucket or SFTP server path."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"It returns a URL with a Job ID to enable tracking the status of this asynchronous operation."},"children":[]},{"$$mdtype":"Node","type":"hardbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Each export job can send multiple JSON files, depending on the total number of items to process."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"More than one bulk export can take place, as needed, one per portal."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"export/exportcontent/request/permission","deepLinkHash":"/export/exportcontent#export/exportcontent/request/permission"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Permission"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Only a client application can invoke this API."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"export/exportcontent/request/license","deepLinkHash":"/export/exportcontent#export/exportcontent/request/license"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"License"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This API requires a site license (SKU: EG-CL-RTKA-PT)."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthClient","scopes":["https://api.egain.cloud/auth/.default"],"type":"oauth2","description":"Authenticate as a client (Server to Server).","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/global/f51302dd-7036-41b5-b619-e1a52a67c780/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/.default":"Default scope"}}}}]}]},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1content~1export/post/parameters"},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/KnowledgeExport","exampleIds":["paths/~1content~1export/post/requestBody/content/application~1json/examples/sftpDestination","paths/~1content~1export/post/requestBody/content/application~1json/examples/s3Destination"]}},"schemaId":"components/schemas/KnowledgeExport","exampleIds":["paths/~1content~1export/post/requestBody/content/application~1json/examples/sftpDestination","paths/~1content~1export/post/requestBody/content/application~1json/examples/s3Destination"],"pointer":"/paths/~1content~1export/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/content/export","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthClient","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/global/f51302dd-7036-41b5-b619-e1a52a67c780/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/.default":"Default scope"}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/.default"]}],"requestBody":{"application/json":{"schemaId":"components/schemas/KnowledgeExport","exampleIds":["paths/~1content~1export/post/requestBody/content/application~1json/examples/sftpDestination","paths/~1content~1export/post/requestBody/content/application~1json/examples/s3Destination"]}},"responseCodes":["202","400","401","403","404","406","500"],"pointer":"/content/export","href":"export/exportcontent","openApiOperationId":"exportContent","summary":"Export Knowledge"},"isWebhook":false,"hideReplay":true,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"schemaId":"components/schemas/KnowledgeExport","exampleIds":["paths/~1content~1export/post/requestBody/content/application~1json/examples/sftpDestination","paths/~1content~1export/post/requestBody/content/application~1json/examples/s3Destination"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/KnowledgeExport","exampleIds":["paths/~1content~1export/post/requestBody/content/application~1json/examples/sftpDestination","paths/~1content~1export/post/requestBody/content/application~1json/examples/s3Destination"]}},"examples":[{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"202","description":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"export/exportcontent/responses/202/a-request-was-accepted-and-is-being-processed.","deepLinkHash":"/export/exportcontent#export/exportcontent/responses/202/a-request-was-accepted-and-is-being-processed."},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A request was accepted and is being processed."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"export/exportcontent/responses/202/expected-processing-time:","deepLinkHash":"/export/exportcontent#export/exportcontent/responses/202/expected-processing-time:"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Expected Processing Time:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Small jobs (< 1,000 items): 5-15 minutes"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Medium jobs (1,000-10,000 items): 15-60 minutes"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Large jobs (> 10,000 items): 1-4 hours (depending on content complexity)"},"children":[]}]}]}]}],"headers":{"location":{"schema":{"type":"string","example":"/knowledge/portalmgr/v4/content/export/7A84B875-6F75-4C7B-B137-0632B62DB0BD"},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Location Header"},"children":[]}]},{"$$mdtype":"Node","type":"hardbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This header contains the URL to check the status of your validation job. The jobID (as in this example) is the unique identifier for tracking this operation.               ```"},"children":[]}]}]}]}},"headerSchemaId":"schema_572"},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1content~1export/post/responses/400/content/application~1json/examples/Unallowed attribute value"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1content~1export/post/responses/400/content/application~1json/examples/Unallowed attribute value"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export/post/responses/401/content/application~1json/examples/Invalid Authorization"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export/post/responses/401/content/application~1json/examples/Invalid Authorization"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export/post/responses/403/content/application~1json/examples/Required Scope Missing"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export/post/responses/403/content/application~1json/examples/Required Scope Missing"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export/post/responses/404/content/application~1json/examples/Resource Not Found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export/post/responses/404/content/application~1json/examples/Resource Not Found"]},{"code":"406","description":"Not acceptable","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export/post/responses/406/content/application~1json/examples/Not Acceptable"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export/post/responses/406/content/application~1json/examples/Not Acceptable"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export/post/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export/post/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1content~1export/post/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"202"},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1content~1export/post/responses/400/content/application~1json/examples/Unallowed attribute value"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export/post/responses/400/content/application~1json/examples/Required Attribute missing","paths/~1content~1export/post/responses/400/content/application~1json/examples/Unallowed attribute value"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export/post/responses/401/content/application~1json/examples/Invalid Authorization"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export/post/responses/401/content/application~1json/examples/Invalid Authorization"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export/post/responses/403/content/application~1json/examples/Required Scope Missing"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export/post/responses/403/content/application~1json/examples/Required Scope Missing"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export/post/responses/404/content/application~1json/examples/Resource Not Found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export/post/responses/404/content/application~1json/examples/Resource Not Found"]}}},{"code":"406","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export/post/responses/406/content/application~1json/examples/Not Acceptable"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export/post/responses/406/content/application~1json/examples/Not Acceptable"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export/post/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export/post/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/export/exportcontent"}],"panels":[]}]},"httpPath":"/content/export"},{"label":"Get Export Job Status","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/apis/v4/knowledge/portalmgr/api-bundled/export/exportstatus","routeSlug":"/apis/v4/knowledge/portalmgr/api-bundled/export/exportstatus","metadata":{"seo":{"title":"Get Export Job Status","description":"Overview"}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"exportStatus","name":"Get Export Job Status","isWebhook":false,"pointer":"/paths/~1content~1export~1{jobID}~1status/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get Export Job Status","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"export/exportstatus/request/overview","deepLinkHash":"/export/exportstatus#export/exportstatus/request/overview"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Overview"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Content Export Status API provides real-time status information to monitor job progress and check completion status."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"export/exportstatus/request/status-values","deepLinkHash":"/export/exportstatus#export/exportstatus/request/status-values"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Status Values"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pending"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Job is pending start of processing"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"In Progress"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Job is actively processing content"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Completed"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Job finished successfully"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Failed"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Job encountered errors and could not complete"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"export/exportstatus/request/response-information","deepLinkHash":"/export/exportstatus#export/exportstatus/request/response-information"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Response Information"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Current Status"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Real-time job status"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Progress Metrics"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Items processed, total items"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Error Details"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Specific errors encountered during processing"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Timing Information"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Start time, estimated completion, actual completion"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"export/exportstatus/request/permission","deepLinkHash":"/export/exportstatus#export/exportstatus/request/permission"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Permission"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Only a client application can invoke this API."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"export/exportstatus/request/license","deepLinkHash":"/export/exportstatus#export/exportstatus/request/license"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"License"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This API requires a site license (SKU: EG-CL-RTKA-PT)."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"oAuthClient","scopes":["https://api.egain.cloud/auth/.default"],"type":"oauth2","description":"Authenticate as a client (Server to Server).","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/global/f51302dd-7036-41b5-b619-e1a52a67c780/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/.default":"Default scope"}}}}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"jobID","in":"path","schemaId":"schema_573","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Example Usage:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"fence","attributes":{"content":"GET /content/export/7A84B875-6F75-4C7B-B137-0632B62DB0BD/status\n","language":"bash"},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"GET /content/export/7A84B875-6F75-4C7B-B137-0632B62DB0BD/status\n"},"children":[]}]}],"required":true}],"pointer":"/paths/~1content~1export~1{jobID}~1status/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept-Language","in":"header","schemaId":"schema_520","description":"The Language locale accepted by the client (used for locale specific fields in resource representation and in error responses).","required":true}],"pointer":"/paths/~1content~1export~1{jobID}~1status/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/content/export/{jobID}/status","servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"parameters":{"path":[{"name":"jobID","in":"path","required":true,"example":"7A84B875-6F75-4C7B-B137-0632B62DB0BD","schemaId":"schema_573"}],"query":[],"querystring":[],"header":[{"name":"Accept-Language","in":"header","required":true,"example":"en-US","schemaId":"schema_520"}],"cookie":[]},"security":[{"schemes":[{"id":"oAuthClient","type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/global/f51302dd-7036-41b5-b619-e1a52a67c780/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/.default":"Default scope"}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"}],"scopes":["https://api.egain.cloud/auth/.default"]}],"responseCodes":["200","400","401","403","404","500"],"pointer":"/content/export/{jobID}/status","href":"export/exportstatus","openApiOperationId":"exportStatus","summary":"Get Export Job Status"},"isWebhook":false,"hideReplay":true,"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"export/exportstatus/responses/200/job-status-retrieved-successfully","deepLinkHash":"/export/exportstatus#export/exportstatus/responses/200/job-status-retrieved-successfully"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Job Status Retrieved Successfully"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The current status and progress information for the specified export job."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Response Details:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Status"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Current job state (Pending, In Progress, Successful, etc.)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Progress"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Number of items processed vs. total items"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Timing"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Start time and estimated completion time"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Errors"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Any validation or processing errors encountered"},"children":[]}]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ExportStatus","exampleIds":["paths/~1content~1export~1{jobID}~1status/get/responses/200/content/application~1json/examples/Job Not Started","paths/~1content~1export~1{jobID}~1status/get/responses/200/content/application~1json/examples/Job In Progress","paths/~1content~1export~1{jobID}~1status/get/responses/200/content/application~1json/examples/Completed Job","paths/~1content~1export~1{jobID}~1status/get/responses/200/content/application~1json/examples/Failed Job"]}},"schemaId":"components/schemas/ExportStatus","exampleIds":["paths/~1content~1export~1{jobID}~1status/get/responses/200/content/application~1json/examples/Job Not Started","paths/~1content~1export~1{jobID}~1status/get/responses/200/content/application~1json/examples/Job In Progress","paths/~1content~1export~1{jobID}~1status/get/responses/200/content/application~1json/examples/Completed Job","paths/~1content~1export~1{jobID}~1status/get/responses/200/content/application~1json/examples/Failed Job"]},{"code":"400","description":"Bad Request","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export~1{jobID}~1status/get/responses/400/content/application~1json/examples/Unsupported Parameters","paths/~1content~1export~1{jobID}~1status/get/responses/400/content/application~1json/examples/Invalid Value","paths/~1content~1export~1{jobID}~1status/get/responses/400/content/application~1json/examples/Missing required query parameter"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export~1{jobID}~1status/get/responses/400/content/application~1json/examples/Unsupported Parameters","paths/~1content~1export~1{jobID}~1status/get/responses/400/content/application~1json/examples/Invalid Value","paths/~1content~1export~1{jobID}~1status/get/responses/400/content/application~1json/examples/Missing required query parameter"]},{"code":"401","description":"Unauthorized","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export~1{jobID}~1status/get/responses/401/content/application~1json/examples/Unauthorized"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export~1{jobID}~1status/get/responses/401/content/application~1json/examples/Unauthorized"]},{"code":"403","description":"Forbidden","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export~1{jobID}~1status/get/responses/403/content/application~1json/examples/Forbidden"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export~1{jobID}~1status/get/responses/403/content/application~1json/examples/Forbidden"]},{"code":"404","description":"Not Found","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export~1{jobID}~1status/get/responses/404/content/application~1json/examples/Not found"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export~1{jobID}~1status/get/responses/404/content/application~1json/examples/Not found"]},{"code":"500","description":"Internal server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export~1{jobID}~1status/get/responses/500/content/application~1json/examples/Internal Server Error"]}},"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export~1{jobID}~1status/get/responses/500/content/application~1json/examples/Internal Server Error"]}],"pointer":"/paths/~1content~1export~1{jobID}~1status/get/responses"}],"panels":[{"children":[{"kind":"response","headerTitle":"Response","responseCodes":[{"code":"200","schemaId":"components/schemas/ExportStatus","exampleIds":["paths/~1content~1export~1{jobID}~1status/get/responses/200/content/application~1json/examples/Job Not Started","paths/~1content~1export~1{jobID}~1status/get/responses/200/content/application~1json/examples/Job In Progress","paths/~1content~1export~1{jobID}~1status/get/responses/200/content/application~1json/examples/Completed Job","paths/~1content~1export~1{jobID}~1status/get/responses/200/content/application~1json/examples/Failed Job"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/ExportStatus","exampleIds":["paths/~1content~1export~1{jobID}~1status/get/responses/200/content/application~1json/examples/Job Not Started","paths/~1content~1export~1{jobID}~1status/get/responses/200/content/application~1json/examples/Job In Progress","paths/~1content~1export~1{jobID}~1status/get/responses/200/content/application~1json/examples/Completed Job","paths/~1content~1export~1{jobID}~1status/get/responses/200/content/application~1json/examples/Failed Job"]}}},{"code":"400","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export~1{jobID}~1status/get/responses/400/content/application~1json/examples/Unsupported Parameters","paths/~1content~1export~1{jobID}~1status/get/responses/400/content/application~1json/examples/Invalid Value","paths/~1content~1export~1{jobID}~1status/get/responses/400/content/application~1json/examples/Missing required query parameter"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export~1{jobID}~1status/get/responses/400/content/application~1json/examples/Unsupported Parameters","paths/~1content~1export~1{jobID}~1status/get/responses/400/content/application~1json/examples/Invalid Value","paths/~1content~1export~1{jobID}~1status/get/responses/400/content/application~1json/examples/Missing required query parameter"]}}},{"code":"401","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export~1{jobID}~1status/get/responses/401/content/application~1json/examples/Unauthorized"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export~1{jobID}~1status/get/responses/401/content/application~1json/examples/Unauthorized"]}}},{"code":"403","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export~1{jobID}~1status/get/responses/403/content/application~1json/examples/Forbidden"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export~1{jobID}~1status/get/responses/403/content/application~1json/examples/Forbidden"]}}},{"code":"404","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export~1{jobID}~1status/get/responses/404/content/application~1json/examples/Not found"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export~1{jobID}~1status/get/responses/404/content/application~1json/examples/Not found"]}}},{"code":"500","schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export~1{jobID}~1status/get/responses/500/content/application~1json/examples/Internal Server Error"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/WSErrorCommon","exampleIds":["paths/~1content~1export~1{jobID}~1status/get/responses/500/content/application~1json/examples/Internal Server Error"]}}}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"feedback","pageSlug":"/export/exportstatus"}],"panels":[]}]},"httpPath":"/content/export/{jobID}/status"}],"content":{"contentType":"group","meta":{"name":"Export"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Export","showPageActions":true},{"nodeType":"markdoc","content":"Content Export APIs"}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/content/export","summary":"Export Knowledge","prefix":{"name":"post","color":"post"},"badges":[],"link":"/export/exportcontent","deprecated":false},{"title":"/content/export/{jobID}/status","summary":"Get Export Job Status","prefix":{"name":"get","color":"get"},"badges":[],"link":"/export/exportstatus","deprecated":false}]}]}]}]}}],"store":{"schemaStore":{"components/schemas/EditionWithContentForExport":{"id":"components/schemas/EditionWithContentForExport","kind":"json-schema","title":"Edition","data":{"type":"object","properties":{"id":{"description":"ID of the edition.","type":"string","minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$"},"name":{"description":"Name of the edition.","type":"string","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$"},"publishProfile":{"$ref":"#/components/schemas/PublishProfile"},"content":{"description":"The raw content of the article. The maximum allowed Article content size is 2 MB.","type":"string","pattern":"^[\\w\\W]*$","minLength":0,"maxLength":2000000},"contentText":{"description":"Plain text version of the content. The maximum allowed Article content size is 2 MB.","type":"string","pattern":"^[\\w\\W]*$","minLength":0,"maxLength":2000000},"accessTags":{"title":"accessTags","type":"object","properties":{"tagCategory":{"description":"An array of tag categories. Note that the total number of tag categories cannot exceed 20.","type":"array","items":{"$ref":"#/components/schemas/TagCategoryForExport"},"minItems":0,"maxItems":20}}},"link":{"$ref":"#/components/schemas/Link"}},"description":"This schema contains information about article edition.","title":"Edition"}},"components/schemas/LegacyKBLanguageCodes":{"id":"components/schemas/LegacyKBLanguageCodes","kind":"json-schema","title":"languageCode","data":{"type":"string","title":"languageCode","x-internal-note":"EGS-94064: Canonical list of legacy Knowledge Base locale codes used across Portal Manager and related APIs. Accepts both internal MLKB codes (e.g. ja-JA) and ISO BCP-47 alternates (e.g. ja-JP) where they refer to the same language. For all legacy APIs, this schema must be  referenced instead of duplicating the enum in individual API specs. NOTE: Do not use this schema for new APIs!! New APIs should use the standard ISO BCP-47 language codes instead.","description":"The language of a resource. Resources available in different languages may differ from each other.","example":"en-US","enum":["en-US","fr-FR","en-GB","es-ES","it-IT","nl-NL","da-DA","sv-SE","pt-PT","fi-FI","no-NB","no-NN","ja-JA","de-DE","pt-BR","zh-CN","zh-TW","ko-KO","ru-RU","el-EL","tr-TR","pl-PL","cs-CS","sk-SK","hu-HU","sr-SR","ar-SA","hr-HR","ro-RO","th-TH","de-AT","vi-VN","id-ID","ms-MY","fil-PH","fr-CA","hi-IN","uk-UA","bg-BG","sl-SI","da-DK","nb-NO","nn-NO","ja-JP","ko-KR","el-GR","cs-CZ","sr-RS","zh-Hans","zh-Hant","ar-AE","xx-XX"]}},"components/schemas/ArticleType":{"id":"components/schemas/ArticleType","kind":"json-schema","title":"ArticleType","data":{"title":"ArticleType","type":"object","description":"The type of the Article and its attributes.","properties":{"articleCategoryId":{"description":"Specifies the article category ID.","type":"integer","format":"int64","minimum":0,"maximum":7},"typeName":{"description":"Indicates the article type name.","type":"string","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$"},"useStructuredAuthoring":{"description":"Indicates whether structured authoring is enabled for this article type, requiring content to be created using predefined fields","type":"boolean"},"articleTypeId":{"description":"The ID of the Article Type.","type":"string","minLength":15,"maxLength":20,"pattern":"^[0-9]+$","example":"932100000002020"}}}},"components/schemas/Link":{"id":"components/schemas/Link","kind":"json-schema","title":"Link","data":{"type":"object","title":"Link","description":"Defines the relationship between this resource and another object.","properties":{"rel":{"title":"rel","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Defines the relationship between a linked resource and the current object."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For example: "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"self"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"prev"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"next"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or an object name such as "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"'user'"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"'folder'"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" etc."},"children":[]}]}]}],"type":"string","pattern":"^[a-zA-Z]+$","maxLength":50},"href":{"title":"href","description":"The URL that specifies the link's destination.","type":"string","pattern":"(\\/[^?#]*)","maxLength":1000}}}},"components/schemas/ArticleAttachment":{"id":"components/schemas/ArticleAttachment","kind":"json-schema","title":"Attachment","data":{"title":"Attachment","properties":{"id":{"description":"The ID of the attachment.","type":"string","minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","example":"PROD-1001"},"name":{"description":"The name of the attachment.","type":"string","minLength":1,"maxLength":4000,"pattern":"^[\\w\\W]+$"},"size":{"type":"integer","format":"int64","description":"The size of the attachment in bytes. The maximum size is limited to 25MB.","minimum":1,"maximum":26214400},"type":{"description":"The type of attachment.","type":"string","enum":["INTERNAL","EXTERNAL"]},"link":{"$ref":"#/components/schemas/Link"}}}},"components/schemas/Edition":{"id":"components/schemas/Edition","kind":"json-schema","title":"Edition","data":{"type":"object","properties":{"id":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the article edition."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An edition ID is composed of a 4-letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"type":"string","minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$"},"name":{"description":"The alphanumeric name of the edition.","type":"string","minLength":1,"maxLength":510,"pattern":"^[\\w\\W]+$"},"isContentEdition":{"description":[{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"The presence of this element indicates that this edition is the one corresponding to the returned content."},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"This can only be true for at most one "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"edition","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":" element in the list of editions."},"children":[]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"This parameter must only be returned if article content is returned as well."},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"The only allowed value is *true*. The absence of this parameter in the response indicates *false*."},"children":[]}]}],"type":"boolean"},"publishProfile":{"title":"Publish Profile","type":"object","properties":{"id":{"type":"string","minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Publish Profile."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An Publish Profile ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}]},"name":{"properties":{},"description":"The name of the profile.","type":"string","minLength":1,"maxLength":255,"pattern":"^[a-zA-Z0-9]+$"}},"required":["id","name"],"description":"The publish view associated with this edition."},"link":{"$ref":"#/components/schemas/Link"}},"description":"This schema contains information about an article edition.","title":"Edition"}},"components/schemas/createdBy":{"id":"components/schemas/createdBy","kind":"json-schema","title":"createdBy","data":{"type":"object","properties":{"id":{"description":"The ID of the user that created this resource.","type":"string","pattern":"^[1-9]\\d*$","minLength":1,"maxLength":8},"userName":{"type":"string","description":"The resource creator's username.","pattern":"^(?=(.*[a-zA-Z0-9_&@.\\-]){2,})[a-zA-Z0-9_&@.\\s\\-]+$","minLength":2,"maxLength":255},"firstName":{"type":"string","description":"The resource creator's first name.","pattern":"^(?!\\s*$)(?!.*[~`!#$%\\^*=\\[\\];\"|<>\\/?+\\{\\}]).*$","minLength":1,"maxLength":255},"middleName":{"type":"string","description":"The resource creator's middle name.","pattern":"^(?!.*[~`!#$%\\^*=\\[\\];\"|<>\\/?+\\{\\}])(\\s*\\S.*|)$","minLength":0,"maxLength":255},"lastName":{"type":"string","description":"The resource creator's last name.","pattern":"^(?!\\s*$)(?!.*[~`!#$%\\^*=\\[\\];\"|<>\\/?+\\{\\}]).*$","minLength":1,"maxLength":255}}}},"components/schemas/modifiedBy":{"id":"components/schemas/modifiedBy","kind":"json-schema","title":"modifiedBy","data":{"type":"object","properties":{"id":{"description":"The ID of the user that modified this resource.","type":"string","pattern":"^[1-9]\\d*$","minLength":1,"maxLength":8},"userName":{"type":"string","description":"The resource modifier's username.","pattern":"^(?=(.*[a-zA-Z0-9_&@.\\-]){2,})[a-zA-Z0-9_&@.\\s\\-]+$","minLength":2,"maxLength":255},"firstName":{"type":"string","description":"The resource modifier's first name.","pattern":"^(?!\\s*$)(?!.*[~`!#$%\\^*=\\[\\];\"|<>\\/?+\\{\\}]).*$","minLength":1,"maxLength":255},"middleName":{"type":"string","description":"The resource modifier's middle name.","pattern":"^(?!.*[~`!#$%\\^*=\\[\\];\"|<>\\/?+\\{\\}])(\\s*\\S.*|)$","minLength":0,"maxLength":255},"lastName":{"type":"string","description":"The resource modifier's last name.","pattern":"^(?!\\s*$)(?!.*[~`!#$%\\^*=\\[\\];\"|<>\\/?+\\{\\}]).*$","minLength":1,"maxLength":255}}}},"components/schemas/ownedBy":{"id":"components/schemas/ownedBy","kind":"json-schema","title":"ownedBy","data":{"type":"object","properties":{"id":{"description":"The ID of the user that owns this resource.","type":"string","pattern":"^[1-9]\\d*$","minLength":1,"maxLength":8},"userName":{"type":"string","description":"The resource owner's username.","pattern":"^(?=(.*[a-zA-Z0-9_&@.\\-]){2,})[a-zA-Z0-9_&@.\\s\\-]+$","minLength":2,"maxLength":255},"firstName":{"type":"string","description":"The resource owner's first name.","pattern":"^(?!\\s*$)(?!.*[~`!#$%\\^*=\\[\\];\"|<>\\/?+\\{\\}]).*$","minLength":1,"maxLength":255},"middleName":{"type":"string","description":"The resource owner's middle name.","pattern":"^(?!.*[~`!#$%\\^*=\\[\\];\"|<>\\/?+\\{\\}])(\\s*\\S.*|)$","minLength":0,"maxLength":255},"lastName":{"type":"string","description":"The resource owner's last name.","pattern":"^(?!\\s*$)(?!.*[~`!#$%\\^*=\\[\\];\"|<>\\/?+\\{\\}]).*$","minLength":1,"maxLength":255}}}},"components/schemas/CustomAttribute":{"id":"components/schemas/CustomAttribute","kind":"json-schema","title":"CustomAttribute","data":{"type":"object","properties":{"name":{"description":"The custom attribute's name.","type":"string","pattern":"^[\\w\\W]+$","minLength":1,"maxLength":4000},"value":{"description":"The custom attribute's values.","type":"array","items":{"type":"string","pattern":"^[\\w\\W]*$","minLength":0,"maxLength":4000}},"type":{"description":"The custom attribute's type.","type":"string","enum":["STRING","INTEGER","BOOLEAN","DATETIME"]}},"additionalProperties":false}},"components/schemas/languageCode":{"id":"components/schemas/languageCode","kind":"json-schema","title":"languageCode","data":{"type":"string","description":"Language code of the resource's language.","enum":["en-US","fr-FR","en-GB","es-ES","it-IT","nl-NL","da-DA","sv-SE","pt-PT","fi-FI","no-NB","no-NN","ja-JA","de-DE","pt-BR","zh-CN","zh-TW","ko-KO","ru-RU","el-EL","tr-TR","pl-PL","cs-CS","sk-SK","hu-HU","sr-SR","ar-SA","hr-HR","ro-RO","th-TH"]}},"components/schemas/L10NString":{"id":"components/schemas/L10NString","kind":"json-schema","title":"L10NString","data":{"type":"object","title":"L10NString","properties":{"value":{"title":"value","description":"A string that indicates the value.","type":"string","minLength":0,"maxLength":255,"pattern":"^[\\w\\W]*$"},"displayValue":{"title":"displayValue","description":"Localized string of the value element.","type":"string","minLength":0,"maxLength":255,"pattern":"^[\\w\\W]*$"}}}},"components/schemas/StructuredAuthoringFields":{"id":"components/schemas/StructuredAuthoringFields","kind":"json-schema","title":"StructuredAuthoringFields","data":{"type":"object","properties":{"confidenceLevel":{"$ref":"#/components/schemas/L10NString"},"issue":{"description":"Describes the problem, symptom, or question the article addresses.","type":"string"},"environment":{"description":"Specifies the relevant product(s), category, or business process tied to the issue.","type":"string"},"cause":{"description":"Identifies the underlying cause of the issue.","type":"string"}}}},"components/schemas/TopicSummary":{"id":"components/schemas/TopicSummary","kind":"json-schema","title":"Topic Summary","data":{"title":"Topic Summary","type":"object","description":"This schema contains the topic ID and name of the topics. This is used by TopicBreadcrumb.","properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The alphanumeric ID of the topic."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A topic ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"minLength":7,"maxLength":20,"example":"PROD-1921"},"name":{"type":"string","description":"The name of the topic.","pattern":"^[\\w\\W]*$","minLength":1,"maxLength":255},"link":{"$ref":"#/components/schemas/Link"}}}},"components/schemas/TopicBreadcrumb":{"id":"components/schemas/TopicBreadcrumb","kind":"json-schema","title":"Topic Breadcrumb","data":{"title":"Topic Breadcrumb","type":"object","description":"This schema contains one or more TopicSummary instances.","properties":{"topicSummary":{"items":{"$ref":"#/components/schemas/TopicSummary"},"description":"An instance of TopicSummary.","type":"array"}}}},"components/schemas/MilestoneName":{"id":"components/schemas/MilestoneName","kind":"json-schema","title":"Name","data":{"type":"object","title":"Name","description":"The identifiers of the milestone.","properties":{"value":{"type":"string","description":"The name of the milestone.","minLength":6,"maxLength":10,"pattern":"^[a-zA-Z]+$"},"displayValue":{"type":"string","description":"The readable name of the milestone.","minLength":1,"maxLength":35,"pattern":"^[\\w\\W]*$"}}}},"components/schemas/Milestone":{"id":"components/schemas/Milestone","kind":"json-schema","title":"Milestone","data":{"type":"object","title":"Milestone","description":"A resource's workflow milestone.","properties":{"name":{"$ref":"#/components/schemas/MilestoneName"}}}},"components/schemas/Stage":{"id":"components/schemas/Stage","kind":"json-schema","title":"stage","data":{"type":"object","title":"stage","description":"A stage in the Article's workflow.","properties":{"name":{"type":"string","description":"The name of the stage.","minLength":1,"maxLength":255,"pattern":"^[a-zA-Z0-9]+$"},"milestone":{"$ref":"#/components/schemas/Milestone"}}}},"components/schemas/Workflow":{"id":"components/schemas/Workflow","kind":"json-schema","title":"Workflow","data":{"title":"Workflow","description":"The Article's workflow.","type":"object","properties":{"stages":{"items":{"$ref":"#/components/schemas/Stage"},"type":"array","description":"An array of stages for the workflow."}}}},"components/schemas/ComplianceForArticle":{"id":"components/schemas/ComplianceForArticle","kind":"json-schema","title":"Compliance","data":{"title":"Compliance","description":"This schema contains the compliance details for an Article.","type":"object","properties":{"startDate":{"type":"object","title":"DateAndTime","required":["date"],"properties":{"date":{"title":"date","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date in the format "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"YYYY-MM-DDTHH:MM:SS"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"string","format":"date-time","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z$"}},"description":"The start date for the Article."},"dueDate":{"type":"object","title":"DateAndTime","required":["date"],"properties":{"date":{"title":"date","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date in the format "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"YYYY-MM-DDTHH:MM:SS"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"string","format":"date-time","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z$"}},"description":"The end date for the Article."}}}},"components/schemas/Tag":{"id":"components/schemas/Tag","kind":"json-schema","title":"Tag","data":{"title":"Tag","type":"object","properties":{"name":{"type":"string","example":"Blue","minLength":1,"maxLength":255,"pattern":"^[a-zA-Z0-9 ]+$"},"id":{"type":"string","example":"PROD-13206","minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$"}}}},"components/schemas/Tags":{"id":"components/schemas/Tags","kind":"json-schema","title":"Tags","data":{"title":"Tags","type":"object","properties":{"tag":{"description":"An array of tags.","type":"array","items":{"$ref":"#/components/schemas/Tag"},"minItems":0}}}},"components/schemas/TagGroup":{"id":"components/schemas/TagGroup","kind":"json-schema","title":"TagGroup","data":{"title":"TagGroup","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[a-zA-Z0-9 ]+$"},"id":{"type":"string","example":"PROD-14566","minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$"}}}},"components/schemas/TagGroups":{"id":"components/schemas/TagGroups","kind":"json-schema","title":"TagGroups","data":{"title":"TagGroups","type":"object","properties":{"tagGroup":{"description":"An array of tag groups.","type":"array","items":{"$ref":"#/components/schemas/TagGroup"},"minItems":0}}}},"components/schemas/TagCategory":{"id":"components/schemas/TagCategory","kind":"json-schema","title":"TagCategory","data":{"title":"TagCategory","description":"A tag category is a grouping of tags and tag groups.","type":"object","properties":{"name":{"description":"The name of the tag category.","type":"string","pattern":"^[a-zA-Z0-9 ]+$","minLength":1,"maxLength":255},"id":{"description":"The ID of the tag category. A tag category ID is composed of a 4-letter prefix, followed by a dash and 4-15 digits.","type":"string","pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","minLength":6,"maxLength":20},"tags":{"$ref":"#/components/schemas/Tags"},"tagGroups":{"$ref":"#/components/schemas/TagGroups"}}}},"components/schemas/PublishView":{"id":"components/schemas/PublishView","kind":"json-schema","title":"PublishView","data":{"title":"PublishView","type":"object","properties":{"name":{"type":"string","description":"name of the publish view","minLength":1,"maxLength":255,"pattern":"^[a-zA-Z0-9 ]+$"},"id":{"type":"string","example":"PROD-12446","minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$"},"tagCategories":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Tag categories are comprised of both tags and tag groups."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Note that the total number of tag and tag groups cannot exceed 20."},"children":[]}]}]}],"type":"array","items":{"properties":{"tagCategory":{"type":"array","maxItems":20,"items":{"$ref":"#/components/schemas/TagCategory"}}}}}}}},"components/schemas/Personalization":{"id":"components/schemas/Personalization","kind":"json-schema","title":"Personalization","data":{"type":"object","title":"Personalization","description":"Personalization allows the filtering of search results and controls the access to articles and article editions.","properties":{"accessTags":{"title":"accessTags","type":"object","properties":{"tagCategory":{"description":"An array of tag categories. Note that the total number of tag categories cannot exceed 20.","type":"array","items":{"$ref":"#/components/schemas/TagCategory"},"minItems":0,"maxItems":20}}},"filters":{"title":"filters","type":"object","properties":{"tagCategory":{"description":"An array of tag categories. Note that the total number of tag categories cannot exceed 20.","type":"array","items":{"$ref":"#/components/schemas/TagCategory"},"minItems":0,"maxItems":20}}},"publishViews":{"title":"publishViews","type":"object","properties":{"publishView":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Publish views allow authors to tailor the contents of an article to different audiences by controlling visibility of certain article content using tags."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The total number of publish views is limited to 20."},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/PublishView"},"minItems":0,"maxItems":20}}}}}},"components/schemas/schemas-Link":{"id":"components/schemas/schemas-Link","kind":"json-schema","title":"Link","data":{"type":"object","title":"Link","properties":{"rel":{"title":"rel","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Defines the relationship between a linked resource and the current document."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For example: self, prev, next or an object name such as 'user', 'folder' etc."},"children":[]}]}]}],"allOf":[{"type":"string","pattern":"^[a-zA-Z]+$","maxLength":50}]},"href":{"title":"href","description":"The URL that specifies the link's destination.","allOf":[{"type":"string","maxLength":1000}]},"_default":{"title":"_default","description":"Determines if this is a default link.","allOf":[{"type":"boolean"}]}}}},"components/schemas/FolderSummary":{"id":"components/schemas/FolderSummary","kind":"json-schema","title":"Folder Summary","data":{"title":"Folder Summary","type":"object","description":"This schema contains the topic ID and name of the Folder. This is used by FolderBreadcrumb.","properties":{"id":{"type":"integer","description":"ID of the folder."},"name":{"type":"string","description":"Name of the folder."},"link":{"$ref":"#/components/schemas/schemas-Link"}}}},"components/schemas/FolderBreadcrumb":{"id":"components/schemas/FolderBreadcrumb","kind":"json-schema","title":"Folder Breadcrumb","data":{"title":"Folder Breadcrumb","type":"object","description":"This schema contains one or more FolderSummary instances.","properties":{"folderSummary":{"items":{"$ref":"#/components/schemas/FolderSummary"},"description":"An instance of FolderSummary.","type":"array"}}}},"components/schemas/BookmarkStatus":{"id":"components/schemas/BookmarkStatus","kind":"json-schema","title":"BookmarkStatus","data":{"title":"BookmarkStatus","type":"object","description":"Article Bookmark Status","required":["isBookmarked"],"properties":{"isBookmarked":{"type":"boolean","description":"Indicates whether the Article is bookmarked"},"bookmarkID":{"type":"integer","format":"int64","nullable":true,"description":"The ID of the Bookmark, if Article is bookmarked."},"folderBreadcrumb":{"$ref":"#/components/schemas/FolderBreadcrumb"}}}},"components/schemas/Article":{"id":"components/schemas/Article","kind":"json-schema","title":"Article","data":{"title":"Article","type":"object","required":["id","name","createdBy","topicBreadcrumb"],"properties":{"id":{"type":"string","minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An Article ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}]},"additionalInfo":{"description":"Additional information about the Article. Max 1 KB.","type":"string","maxLength":1024,"pattern":"^[\\w\\W]*$"},"articleMacro":{"description":"The name of the macro associated with this Article.","type":"string","minLength":0,"maxLength":255,"pattern":"^[^\\s<>`,.?;&\"'!/+]*$"},"articleType":{"$ref":"#/components/schemas/ArticleType"},"articleKeywords":{"description":"A comma-separated list of keywords associated with this Article. 1 KB max size limit.","type":"string","minLength":0,"maxLength":1024,"pattern":"^[\\w\\W]*$"},"articleSummary":{"description":"A brief summary of the Article, provided as metadata. 1 KB max size limit.","type":"string","maxLength":1024,"pattern":"^[\\w\\W]*$"},"attachments":{"description":"The attachments of the Article.\n","items":{"$ref":"#/components/schemas/ArticleAttachment"},"type":"array","minItems":0,"maxItems":50},"availabilityDate":{"type":"string","description":"The date on which the Article version is available.","format":"DateAndTime","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z$","minLength":20,"maxLength":25},"availableEditions":{"description":"The editions of this Article that are available to the user.","items":{"$ref":"#/components/schemas/Edition"},"type":"array","maxItems":20},"averageRating":{"format":"double","description":"The average rating of the Article.","type":"number","minimum":0,"maximum":100},"content":{"description":"The Article content. The maximum allowed Article content size is 2 MB.","type":"string","pattern":"^[\\w\\W]*$","minLength":0,"maxLength":2000000},"contentText":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The plaintext version of the Article content, which does not have the HTML tags and rich formatting present in "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"content"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The maximum allowed Article content size is 2 MB."},"children":[]}]}]}],"type":"string","pattern":"^[\\w\\W]*$","minLength":0,"maxLength":2000000},"createdBy":{"$ref":"#/components/schemas/createdBy"},"modifiedBy":{"$ref":"#/components/schemas/modifiedBy"},"ownedBy":{"$ref":"#/components/schemas/ownedBy"},"createdDate":{"type":"string","format":"DateAndTime","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z$","minLength":20,"maxLength":25},"customAttributes":{"items":{"$ref":"#/components/schemas/CustomAttribute"},"description":"A list of custom attributes.","type":"array","minItems":0,"maxItems":25},"departmentID":{"description":"ID of the Article's department.","type":"string","pattern":"^999$|^[1-9][0-9]{3,8}$","minLength":3,"maxLength":9},"description":{"description":"A description of the Article. The maximum allowed Article description size is 1 KB.","type":"string","minLength":0,"maxLength":1000,"pattern":"^[\\w\\W]*$"},"expirationDate":{"description":"Date of Article expiration if Article expires otherwise empty.","type":"string","format":"DateAndTime","pattern":"^(\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z)?$","minLength":0,"maxLength":25},"imageURL":{"description":"The URL of an image to be associated with the Article.","type":"string","minLength":0,"maxLength":2000,"pattern":"^(https?|ftp):\\/\\/[^\\s/$.?#].[^\\s]*$|^$"},"includeInGenAI":{"type":"boolean","description":"Indicates whether the Article is included for Generative AI."},"isSubscribed":{"description":"Indicates whether the Article is subscribed for notifications.","type":"boolean"},"modifiedDate":{"description":"The date on which the Article was last modified.","type":"string","format":"DateAndTime","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z$","minLength":20,"maxLength":25},"languageCode":{"$ref":"#/components/schemas/languageCode"},"link":{"$ref":"#/components/schemas/Link"},"name":{"description":"The name of the Article.","type":"string","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$"},"structuredAuthoringFields":{"$ref":"#/components/schemas/StructuredAuthoringFields"},"articleState":{"description":"The Article's state.","type":"string","minLength":1,"maxLength":1},"timesRated":{"description":"The number of times that this Article has been rated.","type":"integer","format":"int64","minimum":0},"topicBreadcrumb":{"type":"array","items":{"$ref":"#/components/schemas/TopicBreadcrumb"},"minItems":1,"maxItems":50,"description":"A list of topics from the root topic to this Article. There may be multiple paths."},"versionId":{"description":"The ID of this version of the Article.","type":"string","minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$"},"workflow":{"$ref":"#/components/schemas/Workflow"},"compliance":{"$ref":"#/components/schemas/ComplianceForArticle"},"personalization":{"$ref":"#/components/schemas/Personalization"},"bookmarkStatus":{"$ref":"#/components/schemas/BookmarkStatus"}}}},"components/schemas/WSErrorCommon":{"id":"components/schemas/WSErrorCommon","kind":"json-schema","title":"Error Response","data":{"type":"object","title":"Error Response","required":["code","developerMessage"],"properties":{"code":{"title":"Code Identifier","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A string that follows the pattern "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"{integer}-{integer}"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The first "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"{integer}"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is the http status code.  This code as a whole is unique."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For example, error codes \"400-101\" and \"404-101\" are distinctly different."},"children":[]}]}]}]}],"type":"string"},"developerMessage":{"title":"Developer Message","description":"A summary of the error.","type":"string","minLength":0,"maxLength":2048},"details":{"title":"Response Details","type":"array","items":{"type":"object","required":["key"],"properties":{"key":{"title":"Key","type":"string","minLength":0,"maxLength":255},"value":{"title":"Value","type":"string","minLength":0,"maxLength":255}}},"minItems":0,"maxItems":30},"userMessage":{"title":"User Message","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"UI friendly messages are only supported by some APIs."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The client must explicitly request UI friendly messages by passing the "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"X-egain-error-message=yes"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" header."},"children":[]}]}]}]}],"type":"string","minLength":0,"maxLength":1024}}}},"components/schemas/RelatedQuestions":{"id":"components/schemas/RelatedQuestions","kind":"json-schema","title":"RelatedQuestions","data":{"type":"object","description":"Related questions for the article.","properties":{"relatedQuestion":{"type":"array","description":"An array of related questions.","items":{"type":"string"}},"count":{"type":"integer","format":"int32","description":"The total count of related questions for the article."}}}},"components/schemas/ArticleWithEditions":{"id":"components/schemas/ArticleWithEditions","kind":"json-schema","title":"Article With Editions","data":{"title":"Article With Editions","type":"object","required":["id","name","createdBy"],"properties":{"id":{"type":"string","minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An Article ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}]},"additionalInfo":{"description":"Additional information about the Article. Max 1 KB.","type":"string","maxLength":1024,"pattern":"^[\\w\\W]*$"},"articleMacro":{"description":"The name of the macro associated with this Article.","type":"string","minLength":0,"maxLength":255,"pattern":"^[^\\s<>`,.?;&\"'!/+]*$"},"articleType":{"$ref":"#/components/schemas/ArticleType"},"articleKeywords":{"description":"A comma-separated list of keywords associated with this Article. 1 KB max size limit.","type":"string","minLength":0,"maxLength":1024,"pattern":"^[\\w\\W]*$"},"articleSummary":{"description":"A brief summary of the Article, provided as metadata. 1 KB max size limit.","type":"string","maxLength":1024,"pattern":"^[\\w\\W]*$"},"attachments":{"description":"The attachments of the Article.\n","items":{"$ref":"#/components/schemas/ArticleAttachment"},"type":"array","minItems":0,"maxItems":50},"availabilityDate":{"type":"string","description":"The date on which the Article version is available.","format":"DateAndTime","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z$","minLength":20,"maxLength":25},"availableEditions":{"description":"The editions of this Article that are available to the user.","items":{"$ref":"#/components/schemas/Edition"},"type":"array","maxItems":20},"averageRating":{"format":"double","description":"The average rating of the Article.","type":"number","minimum":0,"maximum":100},"content":{"description":"The Article content. The maximum allowed Article content size is 2 MB.","type":"string","pattern":"^[\\w\\W]*$","minLength":0,"maxLength":2000000},"contentText":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The plaintext version of the Article content, which does not have the HTML tags and rich formatting present in "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"content"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". The maximum allowed Article content size is 2 MB."},"children":[]}]}]}],"type":"string","pattern":"^[\\w\\W]*$","minLength":0,"maxLength":2000000},"createdBy":{"$ref":"#/components/schemas/createdBy"},"modifiedBy":{"$ref":"#/components/schemas/modifiedBy"},"ownedBy":{"$ref":"#/components/schemas/ownedBy"},"createdDate":{"description":"The date on which the Article was created. The timezone of the date will be in UTC.","type":"string","format":"DateAndTime","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z$","minLength":20,"maxLength":25},"customAttributes":{"items":{"$ref":"#/components/schemas/CustomAttribute"},"description":"A list of custom attributes.","type":"array","minItems":0,"maxItems":25},"departmentID":{"description":"ID of the Article's department.","type":"string","pattern":"^999$|^[1-9][0-9]{3,8}$","minLength":3,"maxLength":9},"description":{"description":"A description of the Article. The maximum allowed Article description size is 1 KB.","type":"string","minLength":0,"maxLength":1000,"pattern":"^[\\w\\W]*$"},"expirationDate":{"description":"Date of Article expiration if Article expires otherwise empty.","type":"string","format":"DateAndTime","pattern":"^(\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z)?$","minLength":0,"maxLength":25},"imageURL":{"description":"The URL of an image to be associated with the Article.","type":"string","minLength":0,"maxLength":2000,"pattern":"^(https?|ftp):\\/\\/[^\\s/$.?#].[^\\s]*$|^$"},"includeInGenAI":{"type":"boolean","description":"Indicates whether the Article is included for Generative AI."},"isSubscribed":{"description":"Indicates whether the Article is subscribed for notifications.","type":"boolean"},"modifiedDate":{"description":"The date on which the Article was last modified. The timezone of the date will be in UTC.","type":"string","format":"DateAndTime","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z$","minLength":20,"maxLength":25},"languageCode":{"$ref":"#/components/schemas/languageCode"},"link":{"$ref":"#/components/schemas/Link"},"name":{"description":"The name of the Article.","type":"string","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$"},"structuredAuthoringFields":{"$ref":"#/components/schemas/StructuredAuthoringFields"},"articleState":{"description":"The Article's state.","type":"string","minLength":1,"maxLength":1},"timesRated":{"description":"The number of times that this Article has been rated.","type":"integer","format":"int64","minimum":0},"relatedQuestions":{"$ref":"#/components/schemas/RelatedQuestions"},"versionId":{"description":"The ID of this version of the Article.","type":"string","minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$"},"workflow":{"$ref":"#/components/schemas/Workflow"},"personalization":{"$ref":"#/components/schemas/Personalization"}}}},"components/schemas/PublishProfile":{"id":"components/schemas/PublishProfile","kind":"json-schema","title":"Publish Profile","data":{"title":"Publish Profile","type":"object","description":"This schema contains information about Profile.","properties":{"id":{"type":"string","minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Publish Profile."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An Publish Profile ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}]},"name":{"properties":{},"description":"The name of the profile.","type":"string","minLength":1,"maxLength":255,"pattern":"^[a-zA-Z0-9]+$"}},"required":["id","name"]}},"components/schemas/schemas-TagGroup":{"id":"components/schemas/schemas-TagGroup","kind":"json-schema","title":"TagGroup","data":{"title":"TagGroup","type":"object","properties":{"id":{"type":"string","example":"PROD-14566","minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","description":"The unique identifier for the tag group."},"name":{"type":"string","description":"Name of the tag group.","pattern":"^[\\w\\W]+$","minLength":1,"maxLength":255},"tagGroup":{"items":{"$ref":"#/components/schemas/schemas-TagGroup"},"type":"array"},"tag":{"items":{"$ref":"#/components/schemas/schemas-Tag"},"type":"array"}}}},"components/schemas/schemas-Tag":{"id":"components/schemas/schemas-Tag","kind":"json-schema","title":"Tag","data":{"title":"Tag","type":"object","properties":{"id":{"type":"string","example":"PROD-13206","minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","description":"The unique identifier for the tag."},"name":{"type":"string","example":"Blue","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$","description":"The name of the tag."}}}},"components/schemas/UserView":{"id":"components/schemas/UserView","kind":"json-schema","title":"User","data":{"title":"User","type":"object","properties":{"link":{"title":"link","description":"The link to the user.","type":"array","items":{"$ref":"#/components/schemas/Link"},"minItems":1,"maxItems":1},"firstName":{"title":"firstName","description":"The first name of the user.","type":"string","pattern":"^[\\w\\W]+$","minLength":1,"maxLength":255},"lastName":{"title":"lastName","description":"The last name of the user.","type":"string","pattern":"^[\\w\\W]+$","minLength":1,"maxLength":255},"id":{"title":"id","description":"The ID of the user.","type":"string","pattern":"^[1-9]\\d*$","minLength":1,"maxLength":9}}}},"components/schemas/schemas-TagCategory":{"id":"components/schemas/schemas-TagCategory","kind":"json-schema","title":"TagCategory","data":{"title":"TagCategory","type":"object","properties":{"name":{"minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$","type":"string","description":"name of the tag category."},"tagGroup":{"items":{"$ref":"#/components/schemas/schemas-TagGroup"},"type":"array"},"tag":{"items":{"$ref":"#/components/schemas/schemas-Tag"},"type":"array"},"created":{"type":"object","title":"DateAndTime","required":["date"],"properties":{"user":{"$ref":"#/components/schemas/UserView"},"date":{"title":"date","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date in the format "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"YYYY-MM-DDTHH:MM:SS"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"string","format":"date-time","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z$"}},"description":"Date the Tag Category was created."},"lastModified":{"type":"object","title":"DateAndTime","required":["date"],"properties":{"user":{"$ref":"#/components/schemas/UserView"},"date":{"title":"date","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date in the format "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"YYYY-MM-DDTHH:MM:SS"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"string","format":"date-time","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z$"}},"description":"Date of last modification."}}}},"components/schemas/EditionWithContent":{"id":"components/schemas/EditionWithContent","kind":"json-schema","title":"Edition","data":{"type":"object","properties":{"id":{"description":"ID of the edition.","type":"string","minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$"},"name":{"description":"Name of the edition.","type":"string","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$"},"publishProfile":{"$ref":"#/components/schemas/PublishProfile"},"content":{"description":"The raw content of the article. The maximum allowed Article content size is 2 MB.","type":"string","pattern":"^[\\w\\W]*$","minLength":0,"maxLength":2000000},"contentText":{"description":"Plain text version of the content. The maximum allowed Article content size is 2 MB.","type":"string","pattern":"^[\\w\\W]*$","minLength":0,"maxLength":2000000},"accessTags":{"title":"accessTags","type":"object","properties":{"tagCategory":{"description":"An array of tag categories. Note that the total number of tag categories cannot exceed 20.","type":"array","items":{"$ref":"#/components/schemas/schemas-TagCategory"},"minItems":0,"maxItems":20}}},"link":{"$ref":"#/components/schemas/Link"}},"description":"This schema contains information about article edition.","title":"Edition"}},"components/schemas/ArticleTypeInfo":{"id":"components/schemas/ArticleTypeInfo","kind":"json-schema","title":"Article Type","data":{"title":"Article Type","type":"object","properties":{"articleCategoryId":{"description":"Specifies the article category ID.","type":"integer","format":"int32","minimum":0,"maximum":7},"typeName":{"description":"Indicates the article type name.","type":"string","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$"},"useStructuredAuthoring":{"description":"Indicates whether structured authoring is enabled for this article type, requiring content to be created using predefined fields","type":"boolean"},"useForCertifiedAnswers":{"description":"Indicates whether articles of this type can be designated as Certified Answers","type":"boolean"},"articleTypeId":{"description":"The ID of the Article Type.","type":"string","minLength":15,"maxLength":20,"pattern":"^[0-9]+$","example":"932100000002020"},"imageURL":{"description":"The URL of an image to be associated with the Article Type","type":"string","minLength":1,"maxLength":2000,"pattern":"^(?:https?:\\/\\/|\\/\\/|\\/|\\.\\.?\\/|[a-zA-Z0-9])[\\w\\-\\.\\/%\\?=#&:]*$"},"description":{"description":"Description of Article Type","type":"string","minLength":0,"maxLength":2000,"pattern":"^[\\w\\W]*$"},"isSearchable":{"description":"Indicates whether articles of this type are included in portal search results","type":"boolean"},"isBrowsable":{"description":"Indicates whether articles of this type are displayed in portal browsing areas such as topics and lists","type":"boolean"}}}},"components/schemas/ArticleTypes":{"id":"components/schemas/ArticleTypes","kind":"json-schema","title":"ArticleTypes","data":{"type":"array","items":{"$ref":"#/components/schemas/ArticleTypeInfo"},"maxItems":250}},"components/schemas/TopicBreadcrumbsList":{"id":"components/schemas/TopicBreadcrumbsList","kind":"json-schema","title":"Topic Breadcrumbs List","data":{"title":"Topic Breadcrumbs List","type":"object","description":"This schema contains an array of topic breadcrumbs, allowing clients to distinguish between multiple distinct hierarchical topic paths.","properties":{"topicBreadcrumb":{"items":{"$ref":"#/components/schemas/TopicBreadcrumb"},"description":"An array of TopicBreadcrumb instances representing individual paths.","type":"array"}}}},"components/schemas/ArticleActivityLink":{"id":"components/schemas/ArticleActivityLink","kind":"json-schema","title":"ArticleActivityLink","data":{"type":"object","required":["versionId","language"],"title":"ArticleActivityLink","properties":{"versionId":{"type":"string","description":"An Article version's ID.","minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$"},"editionId":{"description":"An Article edition's ID.","type":"string","minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$"},"language":{"type":"object","title":"Language","required":["code"],"properties":{"code":{"description":"The code of the language.","allOf":[{"$ref":"#/components/schemas/LegacyKBLanguageCodes"}]}},"description":"The knowledge base language in which the version is created."}},"example":{"editionId":"PROD-13015","versionId":"PROD-12416","language":{"code":"en-US"}}}},"components/schemas/ArticleResult":{"id":"components/schemas/ArticleResult","kind":"json-schema","title":"ArticleResult","data":{"title":"ArticleResult","type":"object","description":"Article search result, a subset of Article that does not contain content and contentText.","properties":{"id":{"type":"string","minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An Article ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}]},"articleType":{"$ref":"#/components/schemas/ArticleType"},"articleKeywords":{"description":"A comma-separated list of keywords associated with this Article. 1 KB max size limit.","type":"string","minLength":0,"maxLength":1024,"pattern":"^[\\w\\W]*$"},"articleSummary":{"description":"A brief summary of the Article, provided as metadata. 1 KB max size limit.","type":"string","maxLength":1024,"pattern":"^[\\w\\W]*$"},"averageRating":{"format":"double","description":"The average rating of the Article.","type":"number","minimum":0,"maximum":100},"createdBy":{"$ref":"#/components/schemas/createdBy"},"modifiedBy":{"$ref":"#/components/schemas/modifiedBy"},"ownedBy":{"$ref":"#/components/schemas/ownedBy"},"createdDate":{"type":"string","format":"DateAndTime","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z$","minLength":20,"maxLength":25},"customAttributes":{"items":{"$ref":"#/components/schemas/CustomAttribute"},"description":"A list of custom attributes.","type":"array","minItems":0,"maxItems":25},"description":{"description":"A description of the Article. The maximum allowed Article description size is 1 KB.","type":"string","minLength":0,"maxLength":1000,"pattern":"^[\\w\\W]*$"},"hasAttachments":{"description":"Indicates whether the Article has any attachments.","type":"boolean"},"isSubscribed":{"description":"Indicates whether the Article is subscribed for notifications.","type":"boolean"},"modifiedDate":{"description":"The date on which the Article was last modified.","type":"string","format":"DateAndTime","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z$","minLength":20,"maxLength":25},"languageCode":{"$ref":"#/components/schemas/languageCode"},"link":{"$ref":"#/components/schemas/Link"},"imageURL":{"description":"The URL of the image that is present in the Article version. It is used as the thumbnail image for the Article.","type":"string","minLength":0,"maxLength":2000,"pattern":"^(https?|ftp):\\/\\/[^\\s/$.?#].[^\\s]*$|^$"},"name":{"description":"The name of the Article.","type":"string","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$"},"timesRated":{"description":"The number of times that this Article has been rated.","type":"integer","format":"int64","minimum":0},"topicBreadcrumb":{"type":"array","items":{"$ref":"#/components/schemas/TopicBreadcrumb"},"minItems":1,"maxItems":50,"description":"A list of topics from the root topic to this Article. There may be multiple paths."},"versionId":{"description":"The ID of this version of the Article.","type":"string","minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$"},"workflow":{"$ref":"#/components/schemas/Workflow"},"compliance":{"$ref":"#/components/schemas/ComplianceForArticle"},"personalization":{"$ref":"#/components/schemas/Personalization"}}}},"components/schemas/PaginationInfo":{"id":"components/schemas/PaginationInfo","kind":"json-schema","title":"PaginationInfo","data":{"type":"object","title":"PaginationInfo","required":["count","pagenum","pagesize"],"properties":{"count":{"title":"count","description":"The total number of items.","type":"integer","minimum":0,"maximum":999},"pagenum":{"title":"pagenum","description":"The page number requested. Page numbers start from 1.","type":"integer","minimum":1,"maximum":999},"pagesize":{"title":"pagesize","description":"The number of objects requested per page. The maximum number of objects per page is 75.","type":"integer","minimum":1,"maximum":75},"link":{"title":"link","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Can include the "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"prev"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"next"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" link."},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/Link"},"maxItems":2,"minItems":0}}}},"components/schemas/ArticleResults":{"id":"components/schemas/ArticleResults","kind":"json-schema","title":"ArticleList","data":{"title":"ArticleList","type":"object","description":"One or more instances of an Article result.","properties":{"articles":{"description":"Article details\n","type":"array","items":{"$ref":"#/components/schemas/ArticleResult"}},"paginationInfo":{"$ref":"#/components/schemas/PaginationInfo"}}}},"components/schemas/AttachmentContent":{"id":"components/schemas/AttachmentContent","kind":"json-schema","title":"AttachmentContent","data":{"title":"AttachmentContent","properties":{"attachmentId":{"description":"The ID of the attachment.","type":"string","minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$"},"name":{"description":"The name of the attachment.","type":"string","minLength":1,"maxLength":4000,"pattern":"^[A-Za-z0-9 _\\-\\.\\(\\)\\[\\]\\{\\}&\\+\\!#@,~]+(\\.[A-Za-z0-9]+)?$"},"size":{"type":"integer","format":"int64","description":"The size of the attachment in bytes. The maximum size is limited to 25MB.","minimum":1,"maximum":26214400},"type":{"description":"The type of attachment.","type":"string","enum":["INTERNAL","EXTERNAL"]},"attachmentContentType":{"description":"The type of the content.","type":"string","pattern":"^[\\w\\W]+$","minLength":1,"maxLength":255},"streamingUrl":{"description":"The streaming URL of the attachment.","type":"string","pattern":"^(https?|ftp):\\/\\/[^\\s/$.?#].[^\\s]*$","maxLength":1000},"link":{"$ref":"#/components/schemas/Link"}}}},"components/schemas/AttachmentContentResult":{"id":"components/schemas/AttachmentContentResult","kind":"json-schema","title":"AttachmentContentResult","data":{"title":"AttachmentContentResult","type":"object","description":"The returned attachment content.","properties":{"attachmentContent":{"type":"array","items":{"$ref":"#/components/schemas/AttachmentContent"},"minItems":1,"maxItems":1}}}},"components/schemas/ArticleRating":{"id":"components/schemas/ArticleRating","kind":"json-schema","title":"ArticleRating","data":{"title":"ArticleRating","type":"object","description":"This schema contains general information about the article rating.","properties":{"id":{"description":"The ID of the rating.","type":"string","pattern":"^[1-9]\\d*$","minLength":1,"maxLength":8},"articleId":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the article."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An article ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"type":"string","pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","minLength":7,"maxLength":20},"ratingValue":{"description":"The score value of the rating. This must be a value between 0 and 100.","type":"integer","format":"int64","minimum":0,"maximum":100},"ratingComments":{"description":"Comments about the rating.","type":"string","pattern":"^[\\w\\W]*$","minLength":0,"maxLength":255},"userId":{"description":"The ID of the user that rated the article.","type":"string","pattern":"^[1-9]\\d*$","minLength":1,"maxLength":8},"ratingTimestamp":{"description":"The timestamp for when the article was rated.","type":"string","format":"date-time","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z$"}}}},"components/schemas/ArticleRatingsResponse":{"id":"components/schemas/ArticleRatingsResponse","kind":"json-schema","title":"ArticleRatingResponse","data":{"type":"object","title":"ArticleRatingResponse","properties":{"articleRatings":{"type":"array","items":{"$ref":"#/components/schemas/ArticleRating"}},"paginationInfo":{"$ref":"#/components/schemas/PaginationInfo"}}}},"components/schemas/ComplianceArticleResult":{"id":"components/schemas/ComplianceArticleResult","kind":"json-schema","title":"ArticleResult","data":{"title":"ArticleResult","type":"object","description":"Article search result, a subset of Article that does not contain content and contentText.","properties":{"id":{"type":"string","minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An Article ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}]},"articleType":{"$ref":"#/components/schemas/ArticleType"},"articleKeywords":{"description":"A comma-separated list of keywords associated with this Article. 1 KB max size limit.","type":"string","minLength":0,"maxLength":1024,"pattern":"^[\\w\\W]*$"},"articleSummary":{"description":"A brief summary of the Article, provided as metadata. 1 KB max size limit.","type":"string","maxLength":1024,"pattern":"^[\\w\\W]*$"},"averageRating":{"format":"double","description":"The average rating of the Article.","type":"number","minimum":0,"maximum":100},"createdBy":{"$ref":"#/components/schemas/createdBy"},"modifiedBy":{"$ref":"#/components/schemas/modifiedBy"},"ownedBy":{"$ref":"#/components/schemas/ownedBy"},"createdDate":{"type":"string","format":"DateAndTime","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z$","minLength":20,"maxLength":25},"customAttributes":{"items":{"$ref":"#/components/schemas/CustomAttribute"},"description":"A list of custom attributes.","type":"array","minItems":0,"maxItems":25},"description":{"description":"A description of the Article. The maximum allowed Article description size is 1 KB.","type":"string","minLength":0,"maxLength":1000,"pattern":"^[\\w\\W]*$"},"hasAttachments":{"description":"Indicates whether the Article has any attachments.","type":"boolean"},"isSubscribed":{"description":"Indicates whether the Article is subscribed for notifications.","type":"boolean"},"modifiedDate":{"description":"The date on which the Article was last modified.","type":"string","format":"DateAndTime","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z$","minLength":20,"maxLength":25},"updateSummary":{"type":"string","description":"Summary of latest update change to article.","maxLength":1000,"pattern":"^[\\w\\W]*$"},"languageCode":{"$ref":"#/components/schemas/languageCode"},"link":{"$ref":"#/components/schemas/Link"},"imageURL":{"description":"The URL of the image that is present in the Article version. It is used as the thumbnail image for the Article.","type":"string","minLength":0,"maxLength":2000,"pattern":"^(https?|ftp):\\/\\/[^\\s/$.?#].[^\\s]*$|^$"},"name":{"description":"The name of the Article.","type":"string","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$"},"timesRated":{"description":"The number of times that this Article has been rated.","type":"integer","format":"int64","minimum":0},"topicBreadcrumb":{"type":"array","items":{"$ref":"#/components/schemas/TopicBreadcrumb"},"minItems":1,"maxItems":50,"description":"A list of topics from the root topic to this Article. There may be multiple paths."},"versionId":{"description":"The ID of this version of the Article.","type":"string","minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$"},"workflow":{"$ref":"#/components/schemas/Workflow"},"compliance":{"$ref":"#/components/schemas/ComplianceForArticle"},"personalization":{"$ref":"#/components/schemas/Personalization"}}}},"components/schemas/ComplianceArticleResults":{"id":"components/schemas/ComplianceArticleResults","kind":"json-schema","title":"ComplianceArticleResult","data":{"title":"ComplianceArticleResult","type":"object","description":"One or more instances of Compliance Article.","properties":{"article":{"description":"Article details\n","type":"array","items":{"$ref":"#/components/schemas/ComplianceArticleResult"}},"paginationInfo":{"$ref":"#/components/schemas/PaginationInfo"}}}},"components/schemas/Topic":{"id":"components/schemas/Topic","kind":"json-schema","title":"Topic","data":{"title":"Topic","type":"object","description":"This schema contains general information about the topic.","required":["id","name"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","minLength":7,"maxLength":20,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The alphanumeric ID of the topic."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A topic ID is composed of a 4-letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}]},"name":{"description":"The name of the topic.","pattern":"^[\\w\\W]+$","minLength":1,"maxLength":255},"description":{"description":"A description of the topic.","type":"string","minLength":0,"maxLength":255,"pattern":"^[\\w\\W]*$"},"articleCountInTopic":{"type":"integer","format":"int32","minimum":0,"maximum":100000,"description":"Number of articles in this topic."},"articleCountInTopicTree":{"type":"integer","format":"int32","minimum":0,"maximum":100000,"description":"Number of articles in this topic and all sub-topics."},"createdBy":{"$ref":"#/components/schemas/createdBy"},"createdDate":{"type":"string","format":"DateAndTime","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z$"},"departmentId":{"description":"ID of the topic's department.","type":"string","pattern":"^[1-9]\\d*$","minLength":3,"maxLength":10,"example":"1000001035"},"imageUrl":{"description":"The URL of an image to be associated with the topic.","type":"string","pattern":"^(https?|ftp):\\/\\/[^\\s/$.?#].[^\\s]*$|^$","minLength":0,"maxLength":1000},"modifiedBy":{"$ref":"#/components/schemas/modifiedBy"},"modifiedDate":{"description":"The date on which the topic was last modified.","type":"string","format":"DateAndTime","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z$"},"childCount":{"description":"Number of sub-topics below this topic.","type":"integer","format":"int32","minimum":0,"maximum":2500},"subTopicIds":{"type":"array","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Array with the list of sub-topics. "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Valid IDs are composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"minItems":0,"maxItems":2500,"items":{"type":"string","pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","minLength":7,"maxLength":20}},"parentTopicId":{"type":"string","minLength":2,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$|-1$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ID of the parent topic. -1 if it is the root topic. "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Valid IDs are composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}]},"customAttributes":{"description":"Custom attributes for the Topic.","type":"array","minItems":0,"maxItems":10,"items":{"$ref":"#/components/schemas/CustomAttribute"}},"topicHomeArticleId":{"type":"string","pattern":"^([a-zA-Z0-9]{2,4}-\\d{4,15})?$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the article used as the home page of this topic. "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Valid IDs are composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}]},"link":{"$ref":"#/components/schemas/Link"}}}},"components/schemas/TopicTreeNode":{"id":"components/schemas/TopicTreeNode","kind":"json-schema","title":"Topic tree","data":{"title":"Topic tree","type":"object","description":"This schema contains general information about the TopicTree.","properties":{"topic":{"$ref":"#/components/schemas/Topic"},"topicTree":{"items":{"$ref":"#/components/schemas/TopicTreeNode"}}}}},"components/schemas/TopicTreeResult":{"id":"components/schemas/TopicTreeResult","kind":"json-schema","title":"Topic tree result","data":{"title":"Topic tree result","type":"object","description":"This schema contains the result of topic tree","properties":{"topicTree":{"items":{"$ref":"#/components/schemas/TopicTreeNode"},"type":"array"},"paginationInfo":{"$ref":"#/components/schemas/PaginationInfo"}}}},"components/schemas/TopicResult":{"id":"components/schemas/TopicResult","kind":"json-schema","title":"Topic result","data":{"title":"Topic result","type":"object","description":"A TopicResult defines a response from any of the Topic APIs.","properties":{"topic":{"items":{"$ref":"#/components/schemas/Topic"},"type":"array"},"paginationInfo":{"$ref":"#/components/schemas/PaginationInfo"}}}},"components/schemas/CasebaseId":{"id":"components/schemas/CasebaseId","kind":"json-schema","title":"CasebaseId","data":{"type":"string","pattern":"^[1-9]\\d*$","minLength":15,"maxLength":15,"example":"409601000000001","description":"The numerical ID of the Casebase."}},"components/schemas/ProfileId":{"id":"components/schemas/ProfileId","kind":"json-schema","title":"ProfileId","data":{"type":"string","pattern":"^1$|^[1-9]\\d{9,15}$","minLength":1,"maxLength":15,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the guided help profile."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"1 will always be the "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"system profile"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}},"components/schemas/Profile":{"id":"components/schemas/Profile","kind":"json-schema","title":"Guided Help Profile","data":{"type":"object","title":"Guided Help Profile","required":["id","name"],"properties":{"id":{"$ref":"#/components/schemas/ProfileId"},"name":{"type":"string","description":"Name of the profile","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$"}}}},"components/schemas/ProfileResult":{"id":"components/schemas/ProfileResult","kind":"json-schema","title":"Profile Result","data":{"type":"object","title":"Profile Result","properties":{"profile":{"description":"profiles","items":{"$ref":"#/components/schemas/Profile"},"type":"array"},"paginationInfo":{"$ref":"#/components/schemas/PaginationInfo"}}}},"components/schemas/CasebaseSearchSettings":{"id":"components/schemas/CasebaseSearchSettings","kind":"json-schema","title":"Casebase Search Settings","data":{"type":"object","title":"Casebase Search Settings","properties":{"closeSessionOnAccept":{"type":"boolean","description":"indicates whether to close the Guided Help session upon acceptance of answer"},"closeSessionOnReject":{"type":"boolean","description":"indicates wheather to reject the Guided Helo session upon rejection of answer"}}}},"components/schemas/KbLanguage":{"id":"components/schemas/KbLanguage","kind":"json-schema","title":"KbLanguage","data":{"title":"KbLanguage","type":"object","properties":{"name":{"type":"string","description":"Name of the language.","enum":["English (United States)","English (United Kingdom)","French (France)","Spanish (Spain)","Italian (Italy)","German (Germany)","Dutch (Netherlands)","Portuguese (Brazil)","Portuguese (Portugal)","Danish (Denmark)","Swedish (Sweden)","Russian (Russia)","French (Canada)","Chinese (Simplified)","Japanese (Japan)","Korean (South Korea)"]},"code":{"type":"string","description":"IETF code of the language.","enum":["en-US","en-GB","fr-FR","es-ES","it-IT","de-DE","nl-NL","pt-BR","pt-PT","da-DK","sv-SE","ru-RU","fr-CA","zh-CN","ja-JP","ko-KR"]}}}},"components/schemas/KbLanguages":{"id":"components/schemas/KbLanguages","kind":"json-schema","title":"KbLanguages","data":{"title":"KbLanguages","description":"KB languages","type":"object","minItems":1,"maxItems":16,"properties":{"KbLanguage":{"items":{"$ref":"#/components/schemas/KbLanguage"},"type":"array"}}}},"components/schemas/Casebase":{"id":"components/schemas/Casebase","kind":"json-schema","title":"Casebase Release","data":{"type":"object","title":"Casebase Release","properties":{"casebaseId":{"$ref":"#/components/schemas/CasebaseId"},"name":{"description":"name of the Casebase Release.","type":"string","maxLength":255,"minLength":1,"pattern":"^[\\w\\W]+$"},"id":{"type":"string","pattern":"^[1-9]\\d*$","minLength":15,"maxLength":15,"description":"The numerical ID of the Casebase Release."},"status":{"type":"string","description":"status of the Casebase","enum":["author","live","qa"]},"profiles":{"items":{"$ref":"#/components/schemas/ProfileResult"},"description":"All Guided Help Profiles associated with Casebase release","type":"array"},"searchSettings":{"$ref":"#/components/schemas/CasebaseSearchSettings"},"languages":{"$ref":"#/components/schemas/KbLanguages"},"link":{"$ref":"#/components/schemas/Link"}}}},"components/schemas/CasebaseResult":{"id":"components/schemas/CasebaseResult","kind":"json-schema","title":"Casebase Result","data":{"type":"object","title":"Casebase Result","properties":{"casebase":{"description":"Casebase releases","items":{"$ref":"#/components/schemas/Casebase"},"type":"array"},"paginationInfo":{"$ref":"#/components/schemas/PaginationInfo"}}}},"components/schemas/ClusterResult":{"id":"components/schemas/ClusterResult","kind":"json-schema","title":"ClusterResult","data":{"title":"ClusterResult","type":"object","properties":{"id":{"description":"id of the cluster","type":"string","pattern":"^[1-9]\\d*$","minLength":10,"maxLength":15,"example":"1000000257"},"shortName":{"description":"short name of the cluster","type":"string","minLength":0,"maxLength":255,"pattern":"^[\\w\\W]*$"},"name":{"description":"name of the cluster","type":"string","minLength":0,"maxLength":255,"pattern":"^[\\w\\W]*$"},"startup":{"description":"indicates if the cluster is startup cluster of the release","type":"boolean"},"depth":{"description":"depth of the cluster","type":"integer","format":"int32","minimum":0,"maximum":999}}}},"components/schemas/ClusterResults":{"id":"components/schemas/ClusterResults","kind":"json-schema","title":"Cluster Result","data":{"type":"object","title":"Cluster Result","properties":{"cluster":{"description":"Clusters","items":{"$ref":"#/components/schemas/ClusterResult"},"type":"array"},"paginationInfo":{"$ref":"#/components/schemas/PaginationInfo"}}}},"components/schemas/Answer":{"id":"components/schemas/Answer","kind":"json-schema","title":"Answer","data":{"type":"object","title":"Answer","properties":{"id":{"type":"string","description":"ID of answer","minLength":6,"maxLength":20,"example":"1000000004","pattern":"^[0-9]+$"},"value":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$","description":"Value of answer"}}}},"components/schemas/QuestionAndAnswer":{"id":"components/schemas/QuestionAndAnswer","kind":"json-schema","title":"Question and Answers","data":{"type":"object","title":"Question and Answers","description":"Questions and answers of the Casebase","required":["id"],"properties":{"id":{"type":"string","description":"ID of question","minLength":6,"maxLength":20,"pattern":"^[0-9]+$","example":"1000003852"},"answers":{"minItems":1,"maxItems":100,"type":"array","description":"Answers of question","items":{"$ref":"#/components/schemas/Answer"}}}}},"components/schemas/SessionContextVariable":{"id":"components/schemas/SessionContextVariable","kind":"json-schema","title":"SessionContextVariable","data":{"type":"object","title":"SessionContextVariable","properties":{"name":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$"},"value":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$"}}}},"components/schemas/GHStepSearchRequest":{"id":"components/schemas/GHStepSearchRequest","kind":"json-schema","title":"Guided Help Step Search Request","data":{"title":"Guided Help Step Search Request","type":"object","properties":{"casebaseId":{"$ref":"#/components/schemas/CasebaseId"},"questions":{"items":{"$ref":"#/components/schemas/QuestionAndAnswer"},"minItems":1,"maxItems":500,"description":"Pre-answered Questions in Guided Help search","type":"array"},"profileId":{"$ref":"#/components/schemas/ProfileId"},"sessionVariable":{"description":"Session variables used to give Guided Help additional context.","items":{"$ref":"#/components/schemas/SessionContextVariable"},"type":"array"},"startOver":{"type":"boolean","description":"Restart the current Guided Help search with the existing context along with session variable context."},"useLiveRelease":{"type":"boolean","description":"Use current live release snapshot of the Casebase otherwise use the authoring release."},"ghsArticleId":{"type":"string","pattern":"^[1-9]\\d*$","minLength":15,"maxLength":15,"example":"100000000001035","description":"Numeric ID of the guided help session article used for starting search."}},"required":["questions","casebaseId"]}},"components/schemas/Metadata":{"id":"components/schemas/Metadata","kind":"json-schema","title":"Metadata","data":{"title":"Metadata","type":"object","properties":{"title":{"type":"string","pattern":"^[\\w\\W]*$","minLength":0,"maxLength":255,"description":"content of the title"},"additionalInformation":{"type":"string","pattern":"^[\\w\\W]*$","minLength":0,"maxLength":255,"description":"content of the additional information"},"action":{"type":"string","pattern":"^[\\w\\W]*$","minLength":0,"maxLength":1024,"description":"content of the action"}}}},"components/schemas/ActionSearch":{"id":"components/schemas/ActionSearch","kind":"json-schema","title":"Action Search","data":{"type":"object","title":"Action Search","properties":{"acceptCount":{"type":"integer","format":"int64","description":"number of times action was accepted","minimum":0,"maximum":9999999999},"hasAdditionalInfo":{"description":"indicates if action has additional information","type":"boolean"},"metadata":{"description":"Metadata in action search.","items":{"$ref":"#/components/schemas/Metadata"},"type":"array"},"articleId":{"type":"string","minLength":0,"maxLength":20,"example":"PROD-9312","pattern":"^([a-zA-Z0-9]{2,4}-\\d{4,15})?$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article ."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}]},"caseId":{"type":"string","pattern":"^[1-9]\\d*$","minLength":10,"maxLength":15,"example":"100000000001035","description":"The numerical ID of the case."},"passedThresholdValue":{"type":"boolean","description":"indicates if the case has passed the threshold value"},"rejectCount":{"type":"integer","format":"int64","description":"The number of times action was rejected","minimum":0,"maximum":9999999999},"shortName":{"type":"string","description":"short name","pattern":"^[\\w\\W]+$","minLength":1,"maxLength":255},"score":{"type":"integer","format":"int64","description":"score of the case","minimum":0,"maximum":100},"name":{"type":"string","description":"name of the case","pattern":"^[\\w\\W]+$","minLength":1,"maxLength":255},"actionId":{"type":"string","minLength":10,"maxLength":15,"example":"100000000009312","pattern":"^[1-9]\\d*$","description":"The ID of the Action."},"type":{"type":"string","description":"type of the action","enum":["control","article"]},"articleType":{"$ref":"#/components/schemas/ArticleType"}}}},"components/schemas/Image":{"id":"components/schemas/Image","kind":"json-schema","title":"Image","data":{"title":"Image","type":"object","properties":{"link":{"$ref":"#/components/schemas/Link"}}}},"components/schemas/schemas-Answer":{"id":"components/schemas/schemas-Answer","kind":"json-schema","title":"Answer","data":{"title":"Answer","type":"object","properties":{"id":{"description":"ID of the answer","type":"string","pattern":"^[1-9]\\d*$","minLength":10,"maxLength":10,"example":"1000001035"},"depth":{"minLength":1,"maxLength":999,"type":"integer","format":"int64","description":"depth of the answer"},"isInvisible":{"type":"boolean","description":"Flag indicating if answer is visible"},"text":{"type":"string","minLength":1,"maxLength":510,"pattern":"^[\\w\\W]+$","description":"Text of the answer"},"image":{"$ref":"#/components/schemas/Image"},"conceptName":{"type":"string","minLength":1,"maxLength":510,"pattern":"^[\\w\\W]+$","description":"name of the answer"},"conceptId":{"type":"string","pattern":"^[1-9]\\d*$","minLength":10,"maxLength":10,"description":"Id of the answer"},"lowerValue":{"type":"integer","format":"int64","description":"lower value of the answer","minimum":-999999999999},"upperValue":{"type":"integer","format":"int64","description":"upper value of the answer","maximum":999999999999},"enumLowerValue":{"type":"string","description":"lower value of enum answer"},"enumUpperValue":{"type":"string","description":"upper value of enum answer"},"lowerInclusive":{"type":"boolean","description":"Value indicating if lower value is inclusive"},"upperInclusive":{"type":"boolean","description":"Value indicating if upper value is inclusive"},"partialMin":{"type":"integer","format":"int64","description":"Partial minimum"},"partialMax":{"type":"integer","format":"int64","description":"Partial maximim"}}}},"components/schemas/AnswerRange":{"id":"components/schemas/AnswerRange","kind":"json-schema","title":"Answer Range","data":{"title":"Answer Range","type":"object","properties":{"id":{"type":"string","pattern":"^[1-9]\\d*$","minLength":10,"maxLength":10,"example":"1000001035","description":"Id of the answer range"},"min":{"type":"number","description":"minimum value of range"},"max":{"type":"number","description":"maximum value of range"},"minInclusive":{"type":"boolean","description":"flag indicating if minimum value is included"},"maxInclusive":{"type":"boolean","description":"flag indicating if maximim value is included"}}}},"components/schemas/schemas-CustomAttribute":{"id":"components/schemas/schemas-CustomAttribute","kind":"json-schema","title":"schemas-CustomAttribute","data":{"type":"object","properties":{"name":{"description":"The custom attribute's name.","type":"string","pattern":"^[\\w\\W]+$","minLength":1,"maxLength":4000},"value":{"description":"The custom attribute's value.","type":"string","pattern":"^[\\w\\W]*$","minLength":0,"maxLength":4000},"type":{"description":"The custom attribute's type.","type":"string","enum":["STRING","INTEGER","BOOLEAN","DATETIME"]}}}},"components/schemas/AnsweredQuestion":{"id":"components/schemas/AnsweredQuestion","kind":"json-schema","title":"Question","data":{"type":"object","title":"Question","properties":{"id":{"description":"The numerical ID of the question","type":"string","pattern":"^[1-9]\\d*$","minLength":10,"maxLength":19,"example":"1000001035"},"title":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$","description":"Title of the question"},"type":{"type":"string","description":"type of the question","enum":["numeric","enumerated","list","text"]},"format":{"type":"string","description":"format of the question","enum":["radioButton","dropdown","checkbox","mutliSelect","number","singleLineTextField","multiLineTextField"]},"shortName":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$","description":"short name"},"hasAdditionalInfo":{"type":"boolean","description":"indicates if question has additional information"},"hasAction":{"type":"boolean","description":"indicates if question has action"},"validAnswer":{"description":"valid answers for question","items":{"$ref":"#/components/schemas/schemas-Answer"},"type":"array"},"previousAnswer":{"description":"answers provided for question","items":{"$ref":"#/components/schemas/schemas-Answer"},"type":"array"},"validAnswerRange":{"$ref":"#/components/schemas/AnswerRange"},"metadata":{"description":"Metadata on question","items":{"$ref":"#/components/schemas/Metadata"},"type":"array"},"customAttributes":{"description":"Custom attributes of question","items":{"$ref":"#/components/schemas/schemas-CustomAttribute"},"type":"array","minItems":0,"maxItems":15},"answerSource":{"type":"string","description":"source of the provided answer","enum":["rule","data_link_article","user"]}}}},"components/schemas/Action":{"id":"components/schemas/Action","kind":"json-schema","title":"Action","data":{"title":"Action","type":"object","properties":{"id":{"type":"string","pattern":"^[1-9]\\d*$","description":"ID of the action","minLength":10,"maxLength":10},"title":{"type":"string","description":"Name of the action","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$"},"type":{"type":"string","description":"type of the action","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$"},"shortName":{"type":"string","description":"short name of the action","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$"},"rejectCount":{"type":"integer","format":"int64","description":"number of times action was rejected.","minimum":0,"maximum":9999999999},"acceptCount":{"type":"integer","format":"int64","description":"number of times action was accepted.","minimum":0,"maximum":9999999999},"metadata":{"description":"Metadata of action","items":{"$ref":"#/components/schemas/Metadata"},"type":"array"},"articleType":{"$ref":"#/components/schemas/ArticleType"}}}},"components/schemas/CaseSearch":{"id":"components/schemas/CaseSearch","kind":"json-schema","title":"Case Search","data":{"type":"object","title":"Case Search","properties":{"acceptCount":{"type":"integer","format":"int64","minimum":0,"maximum":9999999999,"description":"The number of times action was accepted"},"action":{"description":"actions in search","items":{"$ref":"#/components/schemas/Action"},"type":"array"},"additionalInfo":{"description":"This field indicates if action has additional information","type":"boolean"},"metadata":{"description":"Metadata in search","items":{"$ref":"#/components/schemas/Metadata"},"type":"array"},"caseId":{"type":"string","description":"case Id","minLength":10,"maxLength":15,"pattern":"^[1-9]\\d*$"},"passedThresholdValue":{"type":"boolean","description":"This field indicates if the case has passed the threshold value"},"rejectCount":{"minimum":0,"maximum":9999999999,"type":"integer","format":"int64","description":"The number of times action was rejected"},"shortName":{"type":"string","minLength":1,"maxLength":255,"description":"The short name"},"score":{"type":"number","format":"double","minimum":0,"maximum":100,"description":"The score of the case"},"title":{"type":"string","minLength":1,"maxLength":255,"description":"The title of the case"},"type":{"type":"string","enum":["Control","Article"],"description":"The type of the action"}}}},"components/schemas/DynamicCluster":{"id":"components/schemas/DynamicCluster","kind":"json-schema","title":"Dynamic Cluster","data":{"type":"object","title":"Dynamic Cluster","properties":{"id":{"type":"string","minLength":10,"maxLength":10,"pattern":"^[0-9]+$","description":"Id of the cluster"},"title":{"type":"string","description":"name of the cluster","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$"}}}},"components/schemas/DetailField":{"id":"components/schemas/DetailField","kind":"json-schema","title":"Detail Field","data":{"title":"Detail Field","type":"object","properties":{"id":{"type":"string","minLength":7,"maxLength":20,"example":"PROD-9312","pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Detail Field."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}]},"detailLink":{"type":"string","minLength":0,"maxLength":255,"pattern":"^[\\w\\W]+$","description":"link of the detail"},"detailType":{"type":"string","minLength":0,"maxLength":255,"pattern":"^[\\w\\W]+$","description":"type of the detail"},"fieldName":{"type":"string","minLength":0,"maxLength":255,"pattern":"^[\\w\\W]+$","description":"name of the field"}}}},"components/schemas/DisplayField":{"id":"components/schemas/DisplayField","kind":"json-schema","title":"Display Field","data":{"title":"Display Field","type":"object","properties":{"id":{"type":"string","minLength":7,"maxLength":20,"example":"PROD-9312","pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Display Field."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}]},"content":{"type":"string","minLength":0,"maxLength":2097152,"pattern":"^[\\w\\W]+$","description":"content in bytes. 2 MB max"},"fieldName":{"minLength":0,"maxLength":255,"pattern":"^[\\w\\W]+$","description":"name of the field"}}}},"components/schemas/VirtualCase":{"id":"components/schemas/VirtualCase","kind":"json-schema","title":"Virtual Case","data":{"title":"Virtual Case","type":"object","properties":{"id":{"type":"string","minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","description":"ID of the case"},"detailField":{"description":"detail fields","items":{"$ref":"#/components/schemas/DetailField"},"type":"array"},"displayField":{"description":"display fields","items":{"$ref":"#/components/schemas/DisplayField"},"type":"array"},"dynamicClusterId":{"type":"string","pattern":"^[1-9]\\d*$","minLength":10,"maxLength":10,"example":"1000001035","description":"Cluster id"},"title":{"type":"string","description":"name of the case","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$"},"virtualCaseId":{"type":"string","minLength":6,"maxLength":20,"pattern":"^[0-9]+$","description":"virtual case id"}}}},"components/schemas/DynamicSearch":{"id":"components/schemas/DynamicSearch","kind":"json-schema","title":"Dynamic Search","data":{"type":"object","title":"Dynamic Search","properties":{"dynamicCluster":{"description":"clusters in search","items":{"$ref":"#/components/schemas/DynamicCluster"},"type":"array"},"parentClusterId":{"type":"string","pattern":"^[1-9]\\d*$","minLength":10,"maxLength":10,"example":"1000001035","description":"Parent cluster"},"type":{"type":"string","description":"type of search","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$"},"virtualCase":{"description":"cases in search","items":{"$ref":"#/components/schemas/VirtualCase"},"type":"array"}}}},"components/schemas/Question":{"id":"components/schemas/Question","kind":"json-schema","title":"Question","data":{"type":"object","title":"Question","properties":{"id":{"description":"The numerical ID of the question","type":"string","pattern":"^[1-9]\\d*$","minLength":10,"maxLength":19,"example":"1000001035"},"title":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$","description":"Title of the question"},"type":{"type":"string","description":"type of the question","enum":["numeric","enumerated","list","text"]},"format":{"type":"string","description":"format of the question","enum":["radioButton","dropdown","checkbox","mutliSelect","number","singleLineTextField","multiLineTextField"]},"shortName":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$","description":"short name"},"hasAdditionalInfo":{"type":"boolean","description":"indicates if question has additional information"},"hasAction":{"type":"boolean","description":"indicates if question has action"},"validAnswer":{"description":"valid answers for question","items":{"$ref":"#/components/schemas/schemas-Answer"},"type":"array"},"validAnswerRange":{"$ref":"#/components/schemas/AnswerRange"},"metadata":{"description":"Metadata on question","items":{"$ref":"#/components/schemas/Metadata"},"type":"array"},"customAttributes":{"description":"Custom attributes of question","items":{"$ref":"#/components/schemas/schemas-CustomAttribute"},"type":"array","minItems":0,"maxItems":15}}}},"components/schemas/ClusterId":{"id":"components/schemas/ClusterId","kind":"json-schema","title":"Cluster id","data":{"type":"object","title":"Cluster id","properties":{"id":{"type":"string","pattern":"^[1-9]\\d*$","minLength":10,"maxLength":15,"example":"1000000257","description":"The numerical Cluster ID"}}}},"components/schemas/GHSearchResult":{"id":"components/schemas/GHSearchResult","kind":"json-schema","title":"Guided Help Search Result","data":{"type":"object","title":"Guided Help Search Result","properties":{"casebase":{"$ref":"#/components/schemas/Casebase"},"actionSearch":{"description":"actions in the search","items":{"$ref":"#/components/schemas/ActionSearch"},"type":"array"},"answeredQuestion":{"description":"questions answered in the search","items":{"$ref":"#/components/schemas/AnsweredQuestion"},"type":"array"},"caseSearch":{"description":"cases in the search","items":{"$ref":"#/components/schemas/CaseSearch"},"type":"array"},"dynamicSearch":{"description":"dynamic cases in the search","items":{"$ref":"#/components/schemas/DynamicSearch"},"type":"array"},"unansweredQuestion":{"description":"unanswered questions in the search","items":{"$ref":"#/components/schemas/Question"},"type":"array"},"startupQuestion":{"description":"startup questions in the search","items":{"$ref":"#/components/schemas/Question"},"type":"array"},"targetClusters":{"description":"active clusters in the search","items":{"$ref":"#/components/schemas/ClusterId"},"type":"array"}}}},"components/schemas/StartQuestionAndAnswer":{"id":"components/schemas/StartQuestionAndAnswer","kind":"json-schema","title":"Question and Answers","data":{"type":"object","title":"Question and Answers","description":"Questions and answers of the Casebase","required":["id","answers"],"properties":{"id":{"type":"string","description":"ID of question","minLength":6,"maxLength":20,"pattern":"^[0-9]+$","example":"1000003852"},"answers":{"minItems":1,"maxItems":100,"type":"array","description":"Answers of question","items":{"$ref":"#/components/schemas/Answer"}}}}},"components/schemas/GHSearchRequest":{"id":"components/schemas/GHSearchRequest","kind":"json-schema","title":"Guided Help Search Request","data":{"title":"Guided Help Search Request","type":"object","properties":{"casebaseId":{"$ref":"#/components/schemas/CasebaseId"},"questions":{"items":{"$ref":"#/components/schemas/StartQuestionAndAnswer"},"minItems":0,"maxItems":500,"description":"Pre-answered Questions in Guided Help search","type":"array"},"profileId":{"type":"string","pattern":"^1$|^[1-9]\\d{9,15}$","minLength":1,"maxLength":15,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the guided help profile. 1 will always be the "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"system profile"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},"sessionVariable":{"description":"Session variables used to give Guided Help additional context.","items":{"$ref":"#/components/schemas/SessionContextVariable"},"type":"array"},"startOver":{"type":"boolean","description":"Restart the current Guided Help search with the existing context along with session variable context."},"useLiveRelease":{"type":"boolean","description":"Use current live release snapshot of the Casebase otherwise use the authoring release."},"ghsArticleId":{"type":"string","pattern":"^[1-9]\\d*$","minLength":15,"maxLength":15,"example":"100000000001035","description":"Numeric ID of the guided help session article used for starting search."}},"required":["casebaseId"]}},"components/schemas/CaseListResult":{"id":"components/schemas/CaseListResult","kind":"json-schema","title":"Case","data":{"type":"object","title":"Case","properties":{"id":{"type":"string","pattern":"^[1-9]\\d*$","minLength":10,"maxLength":15,"example":"100000000001035","description":"The numerical ID of the case."},"shortName":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$","description":"short name of the case."},"title":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$","description":"title of the case"},"profileId":{"$ref":"#/components/schemas/ProfileId"},"releaseId":{"type":"string","pattern":"^[1-9]\\d*$","minLength":15,"maxLength":15,"example":"100000000001035","description":"The numerical ID of the Casebase Release in which case in created"},"clusterId":{"type":"string","pattern":"^[1-9]\\d*$","minLength":10,"maxLength":15,"example":"100000000001035","description":"ID of the cluster in which case is created"},"createdDate":{"description":"The date on which the Case was created.","type":"string","format":"DateAndTime","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z$","minLength":20,"maxLength":25},"createdBy":{"$ref":"#/components/schemas/createdBy"},"modifiedBy":{"$ref":"#/components/schemas/modifiedBy"},"modifiedDate":{"description":"The date on which the Case was last modified.","type":"string","format":"DateAndTime","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z$","minLength":20,"maxLength":25},"link":{"$ref":"#/components/schemas/Link"}}}},"components/schemas/CaseListResults":{"id":"components/schemas/CaseListResults","kind":"json-schema","title":"Case List Result","data":{"type":"object","title":"Case List Result","properties":{"case":{"description":"Cases","type":"array","items":{"$ref":"#/components/schemas/CaseListResult"}},"paginationInfo":{"$ref":"#/components/schemas/PaginationInfo"}}}},"components/schemas/CaseQuestion":{"id":"components/schemas/CaseQuestion","kind":"json-schema","title":"Question","data":{"type":"object","title":"Question","properties":{"id":{"description":"The numerical ID of the question","type":"string","pattern":"^[1-9]\\d*$","minLength":10,"maxLength":19,"example":"1000001035"}}}},"components/schemas/CaseAnswer":{"id":"components/schemas/CaseAnswer","kind":"json-schema","title":"Answer","data":{"title":"Answer","type":"object","properties":{"id":{"description":"ID of the answer","type":"string","pattern":"^[1-9]\\d*$","minLength":10,"maxLength":10,"example":"1000001035"},"text":{"type":"string","minLength":1,"maxLength":510,"pattern":"^[\\w\\W]+$","description":"Text of the answer"}}}},"components/schemas/CaseQuestionDetail":{"id":"components/schemas/CaseQuestionDetail","kind":"json-schema","title":"Question Detail","data":{"type":"object","title":"Question Detail","required":["question","answer"],"properties":{"question":{"$ref":"#/components/schemas/CaseQuestion"},"answer":{"description":"Answer of the question","items":{"$ref":"#/components/schemas/CaseAnswer"},"type":"array"},"scoringValue":{"type":"number","format":"double","description":"Weightage of the question"}}}},"components/schemas/Case":{"id":"components/schemas/Case","kind":"json-schema","title":"Case","data":{"type":"object","title":"Case","properties":{"id":{"type":"string","pattern":"^[1-9]\\d*$","minLength":10,"maxLength":15,"example":"100000000001035","description":"The numerical ID of the case."},"shortName":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$","description":"short name of the case."},"title":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$","description":"title of the case"},"comments":{"type":"string","pattern":"^[\\w\\W]*$","minLength":0,"maxLength":255,"description":"comments on the case"},"profileId":{"$ref":"#/components/schemas/ProfileId"},"releaseId":{"type":"string","pattern":"^[1-9]\\d*$","minLength":15,"maxLength":15,"example":"100000000001035","description":"The numerical ID of the Casebase Release in which case in created"},"clusterId":{"type":"string","pattern":"^[1-9]\\d*$","minLength":10,"maxLength":15,"example":"100000000001035","description":"ID of the cluster in which case is created"},"createdDate":{"description":"The date on which the Case was created.","type":"string","format":"DateAndTime","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z$","minLength":20,"maxLength":25},"createdBy":{"$ref":"#/components/schemas/createdBy"},"modifiedBy":{"$ref":"#/components/schemas/modifiedBy"},"modifiedDate":{"description":"The date on which the Case was last modified.","type":"string","format":"DateAndTime","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z$","minLength":20,"maxLength":25},"isVisible":{"type":"boolean","description":"Flag indicating if the case is visible"},"rejectCount":{"minimum":0,"maximum":9999999999,"type":"integer","format":"int64","description":"number of times case was rejected."},"acceptCount":{"type":"integer","format":"int64","minimum":0,"maximum":9999999999,"description":"number of times case was accepted."},"action":{"description":"actions in the case","items":{"$ref":"#/components/schemas/Action"},"type":"array"},"metadata":{"description":"Metadata of the case","items":{"$ref":"#/components/schemas/Metadata"},"type":"array"},"thresholdValue":{"minimum":0,"maximum":100,"type":"integer","format":"int32","description":"Threshold value of the case"},"thresholdType":{"type":"string","enum":["Default","Custom"],"description":"Threshold type indicating if thresholdValue is default or custom."},"thresholdValueFromCluster":{"type":"number","format":"double","minimum":0,"maximum":100,"description":"Threshold value of the cluster in which case is created"},"caseType":{"type":"string","enum":["Control","Content"],"description":"Type of the case. Control or Content type"},"questionDetail":{"description":"Questions in the case","items":{"$ref":"#/components/schemas/CaseQuestionDetail"},"type":"array"},"link":{"$ref":"#/components/schemas/Link"}}}},"components/schemas/CasebaseReleaseId":{"id":"components/schemas/CasebaseReleaseId","kind":"json-schema","title":"CasebaseReleaseId","data":{"type":"string","pattern":"^[1-9]\\d*$","minLength":15,"maxLength":15,"example":"409601000000001","description":"The numerical ID of the Casebase Release."}},"components/schemas/QuickpickRating":{"id":"components/schemas/QuickpickRating","kind":"json-schema","title":"Rating","data":{"title":"Rating","type":"object","properties":{"id":{"$ref":"#/components/schemas/CasebaseReleaseId"},"name":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$","description":"name of the case or article"},"profileId":{"$ref":"#/components/schemas/ProfileId"}},"required":["id","name","profileId"]}},"components/schemas/QuickpickResult":{"id":"components/schemas/QuickpickResult","kind":"json-schema","title":"Quickpick","data":{"type":"object","title":"Quickpick","properties":{"id":{"description":"The ID of the Quickpick being accessed.\n","type":"string","pattern":"^[1-9]\\d*$","minLength":1,"maxLength":19},"name":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[a-zA-Z0-9_-]+$","description":"name of the quick pick"},"comment":{"type":"string","pattern":"^[\\w\\W]+$","maxLength":255,"minLength":1,"description":"comment about quick pick"},"casebaseReleaseId":{"type":"string","pattern":"^[1-9]\\d*$","minLength":15,"maxLength":15,"example":"409601000000001","description":"The numerical ID of the Casebase Release."}}}},"components/schemas/QuickpickResults":{"id":"components/schemas/QuickpickResults","kind":"json-schema","title":"Quickpick result","data":{"title":"Quickpick result","type":"object","properties":{"quickpick":{"description":"quick picks","items":{"$ref":"#/components/schemas/QuickpickResult"},"type":"array"},"paginationInfo":{"$ref":"#/components/schemas/PaginationInfo"}}}},"components/schemas/CreateQuickpick":{"id":"components/schemas/CreateQuickpick","kind":"json-schema","title":"Quickpick","data":{"required":["casebaseReleaseId"],"type":"object","title":"Quickpick","properties":{"name":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$","description":"name of the quick pick"},"comment":{"type":"string","pattern":"^[\\w\\W]+$","maxLength":255,"minLength":1,"description":"comment about quick pick"},"casebaseReleaseId":{"type":"string","pattern":"^[1-9]\\d*$","minLength":15,"maxLength":15,"example":"409601000000001","description":"The numerical ID of Live release of the Casebase."},"linkToActivity":{"type":"boolean","description":"indicates if quickpick is to be linked with activity"}}}},"components/schemas/Bookmark":{"id":"components/schemas/Bookmark","kind":"json-schema","title":"Bookmark","data":{"title":"Bookmark","type":"object","required":["resourceId"],"properties":{"portalId":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal associated with the bookmark."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 2-4 15 digits."},"children":[]}]}]}],"type":"string","pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","minLength":7,"maxLength":20,"example":"PROD-98123"},"resourceId":{"description":"The ID of the article or topic associated with this bookmark. A case ID or an article ID is composed of a 2-4 letter prefix, followed by a dash and 15 digits.","type":"string","pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","minimum":7,"maximum":20,"example":"DEV-7692"},"id":{"description":"The ID of the bookmark.","type":"string","pattern":"^[1-9]\\d*$","minLength":4,"maxLength":19,"example":"1000001035"},"bookmarkName":{"description":"The name of the bookmark.","type":"string","pattern":"^[\\w\\W]*$","minLength":0,"maxLength":255},"resourceType":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Determines the type of resource:"},"children":[]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"1 - Article"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"2 - Topic"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"3 - External Content"},"children":[]}]}],"type":"integer","format":"int32","minimum":1,"maximum":3},"resourceName":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name of the resource associated with the bookmark."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This attribute is only available for article and topic bookmarks."},"children":[]}]}]}],"type":"string","pattern":"^[\\w\\W]+$","minLength":1,"maxLength":255},"externalContentId":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the external content."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This attribute must be provided if "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"resourceType"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is set to \"3 - External Content\"."},"children":[]}]}]}],"type":"string","pattern":"^[\\w\\W]*$","minLength":0,"maxLength":255}}}},"components/schemas/BookmarkResult":{"id":"components/schemas/BookmarkResult","kind":"json-schema","title":"BookmarkResult","data":{"title":"BookmarkResult","type":"object","description":"One or more instances of Bookmark.","properties":{"bookmarks":{"type":"array","items":{"$ref":"#/components/schemas/Bookmark"}},"paginationInfo":{"$ref":"#/components/schemas/PaginationInfo"}}}},"components/schemas/CreateBookmark":{"id":"components/schemas/CreateBookmark","kind":"json-schema","title":"CreateBookmark","data":{"title":"CreateBookmark","type":"object","properties":{"resourceId":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the article or topic associated with this bookmark. A case ID or an article ID is composed of a 2-4 letter prefix, followed by a dash and 15 digits."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This attribute must be provided if "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"resourceType"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is set to \"1 - Article\" or \"2 - Topic\"."},"children":[]}]}]}],"type":"string","pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","minimum":7,"maximum":20,"example":"DEV-7692"},"userId":{"description":"The ID of the user associated with the bookmark.","type":"string","pattern":"^[1-9]\\d*$","minLength":1,"maxLength":10,"example":"1000001035"},"userType":{"description":"The type of the user associated with the bookmark.","type":"string","enum":["customer","agent"]},"bookmarkName":{"description":"The name of the bookmark.","type":"string","pattern":"^[\\w\\W]+$","minLength":1,"maxLength":255},"resourceType":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Determines the type of resource:"},"children":[]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"1 - Article"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"2 - Topic"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"3 - External Content"},"children":[]}]}],"type":"integer","format":"int32","minimum":1,"maximum":3},"resourceName":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name of the resource associated with the bookmark."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This attribute is only available for article and topic bookmarks."},"children":[]}]}]}],"type":"string","pattern":"^[\\w\\W]+$","minLength":1,"maxLength":255},"externalContentId":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the external content."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This attribute must be provided if "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"resourceType"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is set to \"3 - External Content\"."},"children":[]}]}]}],"type":"string","pattern":"^[\\w\\W]+$","minLength":1,"maxLength":255}}}},"components/schemas/UserProfile":{"id":"components/schemas/UserProfile","kind":"json-schema","title":"User Profile","data":{"title":"User Profile","type":"object","properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","minLength":7,"maxLength":20,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Readable ID of the user profile."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]}]}]}]},"name":{"type":"string","minimum":1,"maximum":250,"pattern":"^[A-Za-z0-9_\\- ]*$","description":"Name given to the user profile"},"isLastUsedInPortal":{"type":"boolean","description":"Indicates if the profile was the last one used by the current user in the portal."}}}},"components/schemas/UserProfiles":{"id":"components/schemas/UserProfiles","kind":"json-schema","title":"User Profiles","data":{"title":"User Profiles","type":"object","properties":{"profile":{"description":"User profiles assigend to user.","items":{"$ref":"#/components/schemas/UserProfile"},"type":"array"}}}},"components/schemas/id":{"id":"components/schemas/id","kind":"json-schema","title":"id","data":{"title":"id","description":"ID of the object","type":"string"}},"components/schemas/name":{"id":"components/schemas/name","kind":"json-schema","title":"name","data":{"title":"name","description":"Name of the object","type":"string","maxLength":255}},"components/schemas/RoleTemplate":{"id":"components/schemas/RoleTemplate","kind":"json-schema","title":"template","data":{"title":"template","x-stoplight":{"id":"fn6y73dcuvzj0"},"type":"object","description":"Role template","properties":{"value":{"title":"value","description":"Value of the role template","type":"string"},"displayValue":{"title":"displayValue","description":"Display value of the role template","type":"string"}},"required":["value","displayValue"]}},"components/schemas/Role":{"id":"components/schemas/Role","kind":"json-schema","title":"Role","data":{"type":"object","x-stoplight":{"id":"3ceinhaulvu1w"},"title":"Role","required":["id","name","template"],"properties":{"id":{"description":"ID of the role","$ref":"#/components/schemas/id"},"name":{"description":"Name of the role","$ref":"#/components/schemas/name"},"template":{"title":"template","description":"Template of the role.","$ref":"#/components/schemas/RoleTemplate"}}}},"components/schemas/UserDetails":{"id":"components/schemas/UserDetails","kind":"json-schema","title":"User Details","data":{"title":"User Details","type":"object","properties":{"id":{"description":"The numerical ID of the User","type":"string","pattern":"^[1-9]\\d*$","minLength":1,"maxLength":9},"roles":{"type":"array","description":"Roles of the User","items":{"$ref":"#/components/schemas/Role"}},"firstName":{"type":"string","pattern":"^[a-zA-Z0-9]|@|\\s|:|.|_|-|&|[\\x80-\\xFF]{1,250}$","description":"First Name of the User","example":"John"},"lastName":{"type":"string","pattern":"^[a-zA-Z0-9]|@|\\s|:|.|_|-|&|[\\x80-\\xFF]{1,250}$","description":"Last Name of the User","example":"Doe"},"hasEmailConfigured":{"type":"boolean","description":"Indicates if user has email"}}}},"components/schemas/ArticleListResult":{"id":"components/schemas/ArticleListResult","kind":"json-schema","title":"Article List","data":{"title":"Article List","type":"object","required":["id","name"],"properties":{"name":{"description":"The name of the article list.","type":"string","pattern":"^[\\w\\W]+$","minLength":1,"maxLength":255},"id":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the article list."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An article list ID is either a 4-digit number or composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"type":"string","pattern":"^[0-9]{4}$|^[a-zA-Z0-9]{2,4}-\\d{4,15}$","minLength":4,"maxLength":20},"description":{"description":"The description of the article list. The maximum allowed article list description size is 1 KB.","type":"string","pattern":"^[\\w\\W]*$","minLength":0,"maxLength":1024},"typeId":{"description":"The type of the article list.","type":"string","pattern":"^[1-9]\\d*$","minLength":1,"maxLength":4,"example":"12"},"link":{"$ref":"#/components/schemas/Link"}}}},"components/schemas/ArticleListsResult":{"id":"components/schemas/ArticleListsResult","kind":"json-schema","title":"Article Lists","data":{"title":"Article Lists","description":"Instances of Artice List","type":"object","properties":{"articleLists":{"type":"array","items":{"$ref":"#/components/schemas/ArticleListResult"},"minItems":1,"maxItems":50}}}},"components/schemas/ArticleList":{"id":"components/schemas/ArticleList","kind":"json-schema","title":"Article List","data":{"title":"Article List","type":"object","required":["id","name"],"properties":{"name":{"description":"The name of the article list.","type":"string","pattern":"^[\\w\\W]+$","minLength":1,"maxLength":255},"id":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the article list."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An article list ID is either a 4-digit number or composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"type":"string","pattern":"^[0-9]{4}$|^[a-zA-Z0-9]{2,4}-\\d{4,15}$","minLength":4,"maxLength":20},"description":{"description":"The description of the article list. The maximum allowed article list description size is 1 KB.","type":"string","pattern":"^[\\w\\W]*$","minLength":0,"maxLength":1024},"typeId":{"description":"The type of the article list.","type":"string","pattern":"^[1-9]\\d*$","minLength":1,"maxLength":4,"example":"12"},"articles":{"description":"An array of articles that belong to the article list.","type":"array","items":{"$ref":"#/components/schemas/ArticleResult"},"minItems":0,"maxItems":75},"link":{"$ref":"#/components/schemas/Link"}}}},"components/schemas/ConfigurableAttribute":{"id":"components/schemas/ConfigurableAttribute","kind":"json-schema","title":"ConfigurableAttribute","data":{"type":"object","required":["name","editable","mandatory"],"properties":{"name":{"type":"string","description":"The name of the attribute."},"mandatory":{"type":"boolean","description":"Indicates if the attribute is mandatory."},"editable":{"type":"boolean","description":"Indicates if the attribute is editable."}}}},"components/schemas/ConfigurableAttributes":{"id":"components/schemas/ConfigurableAttributes","kind":"json-schema","title":"ConfigurableAttributes","data":{"title":"ConfigurableAttributes","type":"object","properties":{"attribute":{"type":"array","minItems":1,"maxItems":50,"items":{"$ref":"#/components/schemas/ConfigurableAttribute"}}}}},"components/schemas/StringAttributeValue":{"id":"components/schemas/StringAttributeValue","kind":"json-schema","title":"StringAttributeValue","data":{"title":"StringAttributeValue","type":"object","description":"An attribute can have an external value such as a readable label, and an internal value such as a unique ID. This schema provides both the internal and external values for one attribute.","properties":{"internalValue":{"type":"string","description":"The internal value of the attribute.","minimum":1,"maximum":255},"externalValue":{"type":"string","description":"The external or public value of the attribute.","minimum":1,"maximum":255}}}},"components/schemas/SearchFilterAttribute":{"id":"components/schemas/SearchFilterAttribute","kind":"json-schema","title":"SearchFilterAttribute","data":{"title":"SearchFilterAttribute","description":"This includes the custom attributes that have been added to the portal for filtering.","type":"object","properties":{"internalName":{"type":"string","description":"The internal name of a custom attribute.","minimum":1,"maximum":255},"externalName":{"type":"string","description":"The external or public name of a custom attribute.","minimum":1,"maximum":255},"valueType":{"enum":["String","Integer","Decimal","Date","Boolean"],"description":"The data type of the value of the attribute.","type":"string"},"isEnumerated":{"type":"boolean","description":"Whether the valueType is enumerated."},"isMultiselect":{"type":"boolean","description":"Whether the user can select multiple values."},"value":{"$ref":"#/components/schemas/StringAttributeValue"}}}},"components/schemas/components-schemas-Tag":{"id":"components/schemas/components-schemas-Tag","kind":"json-schema","title":"components-schemas-Tag","data":{"type":"object","description":"Tag","properties":{"name":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$","description":"Name of the Tag"},"id":{"type":"string","minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Tag ."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A Tag ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}]}}}},"components/schemas/components-schemas-TagGroup":{"id":"components/schemas/components-schemas-TagGroup","kind":"json-schema","title":"components-schemas-TagGroup","data":{"type":"object","description":"Group of Tags","properties":{"name":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$","description":"Name of the Tag Group"},"id":{"type":"string","minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Tag Group."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A Tag Group ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}]}}}},"components/schemas/components-schemas-TagCategory":{"id":"components/schemas/components-schemas-TagCategory","kind":"json-schema","title":"components-schemas-TagCategory","data":{"type":"object","description":"Tag Categories for Interest configured for a portal.","properties":{"name":{"type":"string","description":"Name of the Tag Category","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$"},"id":{"type":"string","minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Tag Category."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A Tag Category ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}]},"tag":{"minItems":0,"maxItems":200,"items":{"$ref":"#/components/schemas/components-schemas-Tag"},"type":"array"},"tagGroup":{"minItems":0,"maxItems":50,"items":{"$ref":"#/components/schemas/components-schemas-TagGroup"}}}}},"components/schemas/TagCategoriesForInterest":{"id":"components/schemas/TagCategoriesForInterest","kind":"json-schema","title":"Tag Categories for Interest","data":{"title":"Tag Categories for Interest","type":"object","properties":{"tagCategory":{"type":"array","minItems":0,"maxItems":15,"items":{"$ref":"#/components/schemas/components-schemas-TagCategory"}}}}},"components/schemas/PortalSettings":{"id":"components/schemas/PortalSettings","kind":"json-schema","title":"Portal Settings","data":{"title":"Portal Settings","description":"The settings for this portal.","type":"object","additionalProperties":false,"properties":{"isAnnoucementsEnabled":{"description":"Whether the announcements section is enabled on this portal.","type":"boolean"},"isArticleFeedbackEnabled":{"description":"Whether article feedback is allowed.","type":"boolean"},"isArticleFeedbackCommentsEnabled":{"description":"Whether comments should be included in the feedback.","type":"boolean"},"isArticleFeedbackSummaryEnabled":{"description":"Whether a summary of feedback ratings should be displayed.","type":"boolean"},"isRelatedArticlesInSameTopicEnabled":{"description":"Whether all articles in the same topic are automatically treated as related articles.","type":"boolean"},"isRelatedArticlesEnabled":{"description":"Whether the related articles section is shown.","type":"boolean"},"isAuthenticationRequired":{"description":"Specifies whether authentication is required for customers to access the portal.","type":"boolean"},"isAgentsSSOEnabled":{"description":"Whether SSO is enabled for agents","type":"boolean"},"isAgentsDelegatedAuthenticationEnabled":{"description":"Whether delegated authentication is enabled for agents","type":"boolean"},"customerProfileAttributes":{"$ref":"#/components/schemas/ConfigurableAttributes"},"isPopularArticlesListEnabled":{"description":"Whether the popular articles list is displayed. Maximum of 50 popular articles will be dislpayed.","type":"boolean"},"popularArticlesListInfluenceWeight":{"description":"The weight assigned to the influence of related articles on the ranking of popular articles in the ranking formula.","type":"number","format":"double","minimum":0,"maximum":100},"popularArticlesListInfluencePeriod":{"description":"The timeframe in days that related articles affect the ranking of popular articles in the ranking formula.","type":"integer","format":"int32","minimum":1,"maximum":100},"appendSessionJourneyToEmail":{"description":"Whether the session transcript should be appended to the email message.","type":"boolean"},"isArticleSuggestionsBeforeEscalationEnabled":{"description":"Whether a user is  shown suggested articles before escalating.","type":"boolean"},"isEscalationToEmailEnabled":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Whether the user can ask a question via email if Guided Help doesn’t provide an answer, triggering a search before escalation."},"children":[]}]}]}],"type":"boolean"},"numberOfSuggestedArticlesBeforeEscalation":{"description":"The number of articles to show to a customer before escalation.","type":"integer","format":"int32","minimum":0,"maximum":10},"isGHEnabled":{"description":"Whether guided help is enabled.","type":"boolean"},"isGHInSearchResultsEnabled":{"description":"Whether to show guided help results in search results.","type":"boolean"},"isGHStartupQuestionsBeforeUnansweredQuestionsEnabled":{"description":"Whether startup questions should be presented before unanswered questions in Guided Help.","type":"boolean"},"isGHDetailsForSearchEnabled":{"description":"Whether additional information should be shown in search results.","type":"boolean"},"isGHShortNameInSearchEnabled":{"description":"When enabled it shows the short names in results.","type":"boolean"},"isGHClusterScopeDiagnosticsEnabled":{"description":"Whether to show Cluster scope diagnostics during execution.","type":"boolean"},"isGHResultsShownOnSuccessfulSearch":{"type":"boolean","description":"Whether to automatically display results on search success."},"isGHControlActionDiagnosticsEnabled":{"description":"isGHControlActionDiagnosticsEnabled","type":"boolean"},"GHFailureSuccessThreshold":{"description":"A value from range that indicates the failure-success score","type":"number","format":"double","minimum":0,"maximum":100},"maxGHAnsweredQuestions":{"description":"A value indicating the maximum number of answered questions.","type":"integer","format":"int32","minimum":1,"maximum":100},"maxGHUnansweredQuestions":{"description":"A value indicating the maximum number of unanswered questions.","type":"integer","format":"int32","minimum":0,"maximum":100},"maxGHSearchResults":{"description":"Maximum number of guided help results to return.","type":"integer","format":"int32","minimum":0,"maximum":10},"isSearchAutocompleteEnabled":{"description":"Whether the autocomplete interface should be enabled.","type":"boolean"},"isWebSearchEnabled":{"description":"Whether web searches should be performed as part of multi-search.","type":"boolean"},"maxWebSearchResults":{"description":"The maximum number of results from the web search to return.","type":"integer","format":"int32","minimum":5,"maximum":25},"webSearchDomain":{"description":"Use this to restrict web search results to a specific domain.","type":"string","pattern":"^(https?|ftp):\\/\\/[^\\s/$.?#].[^\\s]*$|^$","minimum":0,"maximum":1000},"isIntranetSearchEnabled":{"description":"Whether intranet results should be returned as part of multi-search.","type":"boolean"},"maxIntranetSearchResults":{"description":"The maximum number of results from an intranet search to return.","type":"integer","format":"int32","minimum":5,"maximum":25},"intranetSearchURL":{"description":"The URL for the Intranet Search.","type":"string","minimum":1,"maximum":255},"isSpellcheckEnabled":{"description":"Whether spell-correction should be performed on search queries. The corrected query is returned with the results, but is not automatically used.","type":"boolean"},"questionMatchingEngineURL":{"description":"The URL for the question matching engine.","type":"string","minimum":1,"maximum":255},"isCustomAttributesFilteringEnabled":{"description":"Whether search results should be filtered by custom attribute values.","type":"boolean"},"customAttributesForSearchFilter":{"type":"array","items":{"$ref":"#/components/schemas/SearchFilterAttribute"}},"searchLearningInclusionThreshold":{"description":"The minimum number of accepts and rejects of an article before article ranking is affected.","type":"integer","format":"int32","minimum":1,"maximum":99999},"searchLearningInfluence":{"description":"A ranking multiplier for learned scoring.","type":"integer","format":"int32","minimum":0,"maximum":1000},"searchLearningLevel":{"enum":[0,1,2,3,4],"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Affects the influence of learning on search rankings. 0 = off, 1 = low, 2 = medium, 3 = high, 4 = custom."},"children":[]}]}]}],"type":"integer","format":"int32"},"searchLearningMaxInfluence":{"description":"The maximum influence allowed for learned scoring.","type":"integer","format":"int32","minimum":0,"maximum":1000},"searchRelatedTermWeight":{"description":"The weight assigned to related terms during search.","type":"number","format":"double","minimum":-1,"maximum":1},"searchRelatedTermsMinResultsThreshold":{"description":"If the number of search results is less than or equal to this value, a search with related terms will be used to fill in results.","type":"integer","format":"int32","minimum":1,"maximum":99999},"isArticleSuggestionsEnabled":{"description":"Whether users can make suggestions on an article.","type":"boolean"},"isMySuggestionsEnabled":{"description":"Whether a user can view their suggestions.","type":"boolean"},"isCaptchaEnabled":{"description":"Whether CAPTCHA is enabled or not in the portal.","type":"boolean"},"captchaSiteKey":{"description":"The configured CAPTCHA site key.","type":"string","minimum":1,"maximum":40},"isArticleSharingEnabled":{"description":"Whether the article sharing is enabled.","type":"boolean"},"tagCategoriesForSearchFilter":{"$ref":"#/components/schemas/TagCategoriesForInterest"}}}},"components/schemas/Portal":{"id":"components/schemas/Portal","kind":"json-schema","title":"Portal","data":{"title":"Portal","type":"object","required":["id","name"],"properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The alphanumeric ID of the portal."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"minLength":7,"maxLength":20},"name":{"description":"The name of the portal.","type":"string","pattern":"^[\\w\\W]+$","minLength":1,"maxLength":255},"departmentId":{"description":"The ID of the department.","type":"string","pattern":"^[1-9]\\d*$","minLength":3,"maxLength":10,"example":"1000001035"},"description":{"description":"The description of the portal.","type":"string","pattern":"^[\\w\\W]+$","minLength":1,"maxLength":255},"defaultContentLanguageId":{"description":"The default ID of the language for the portal content.","type":"string","pattern":"^[1-9]\\d*$","minLength":1,"maxLength":10,"example":"1"},"defaultContentLanguageCode":{"description":"The IETF code of the default language for the portal content.","type":"string","pattern":"^[\\w\\W]+$","minLength":1,"maxLength":255},"createdBy":{"$ref":"#/components/schemas/createdBy"},"createdDate":{"description":"The date that the portal was created.","type":"string","format":"DateAndTime","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z$","minLength":19,"maxLength":25},"modifiedBy":{"$ref":"#/components/schemas/modifiedBy"},"modifiedDate":{"description":"The date on which the portal was last modified.","type":"string","format":"DateAndTime","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z$"},"isStructuredAuthoringEnabled":{"description":"Indicates if Structured Authoring is enabled for the portal.","type":"boolean"},"enableDraftSearchInPortal":{"description":"Indicates if Enable Portal Search for Draft and Staging Articles is enabled for the portal.","type":"boolean"},"portalSettings":{"$ref":"#/components/schemas/PortalSettings"},"kbLanguages":{"$ref":"#/components/schemas/KbLanguages"},"link":{"$ref":"#/components/schemas/Link"}}}},"components/schemas/PortalResult":{"id":"components/schemas/PortalResult","kind":"json-schema","title":"Portal Result","data":{"title":"Portal Result","type":"object","properties":{"portal":{"description":"portals","items":{"$ref":"#/components/schemas/Portal"},"type":"array"},"paginationInfo":{"$ref":"#/components/schemas/PaginationInfo"}}}},"components/schemas/Department":{"id":"components/schemas/Department","kind":"json-schema","title":"Department of Portal","data":{"title":"Department of Portal","type":"object","properties":{"id":{"type":"string","pattern":"^[1-9]\\d*$","minLength":3,"maxLength":10,"example":"1000001035","description":"ID of department"},"name":{"type":"string","minLength":0,"maxLength":255,"pattern":"^[\\w\\W]+$","description":"Name of Department"}}}},"components/schemas/ShortURL":{"id":"components/schemas/ShortURL","kind":"json-schema","title":"ShortURL","data":{"title":"ShortURL","type":"object","properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The alphanumeric ID of the short URL."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"minLength":7,"maxLength":20},"templateName":{"type":"string","minLength":0,"maxLength":255,"pattern":"^[\\w\\W]+$","description":"Name of template"},"shortURLName":{"type":"string","minLength":0,"maxLength":255,"pattern":"^[\\w\\W]+$","description":"Name of ShortURL"},"isDefault":{"type":"boolean"}}}},"components/schemas/AccessiblePortal":{"id":"components/schemas/AccessiblePortal","kind":"json-schema","title":"Portals accessible to agent","data":{"title":"Portals accessible to agent","type":"object","properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","minLength":7,"maxLength":20,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ID of portal. "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A Portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}]},"name":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$","description":"Name of portal"},"description":{"type":"string","minLength":0,"maxLength":255,"pattern":"^[\\w\\W]+$","description":"Description of portal"},"department":{"$ref":"#/components/schemas/Department"},"shortURL":{"title":"ShortURLs","items":{"$ref":"#/components/schemas/ShortURL"},"type":"array"}}}},"components/schemas/AllAccessiblePortals":{"id":"components/schemas/AllAccessiblePortals","kind":"json-schema","title":"Portal accessible to agent","data":{"title":"Portal accessible to agent","type":"object","properties":{"portal":{"description":"portals","items":{"$ref":"#/components/schemas/AccessiblePortal"},"type":"array"},"paginationInfo":{"$ref":"#/components/schemas/PaginationInfo"}}}},"components/schemas/AdditionalSnippets":{"id":"components/schemas/AdditionalSnippets","kind":"json-schema","title":"AdditionalSnippets","data":{"type":"object","required":["id","name","docType","snippet","normalizedScore"],"properties":{"id":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article. "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" An Article ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","example":"PROD-2996"},"name":{"type":"string","description":"The name of the Article or source content.","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$","example":"Fair Lending FAQs"},"docType":{"type":"string","enum":["HTML","DOCX","PDF","PPTX","XLSX","XLSM","XLSB"],"description":"Format of the source document.","example":"DOCX"},"docName":{"type":"string","description":"Name of the attachment, if an attachment was used as the source content.","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$","example":"Banking FAQs"},"snippet":{"type":"string","description":"A snippet of the article content.","minLength":0,"maxLength":5000,"pattern":"^[\\w\\W]*$","example":"The following Banking FAQs..."},"keywordSnippet":{"type":"string","description":"A keyword snippet of the article content.","minLength":0,"maxLength":5000,"pattern":"^[\\w\\W]*$","example":"The following Banking FAQs..."},"relevanceScore":{"type":"number","format":"float","description":"Generated confidence score (0.0-1.0) for the snippet's relevance to the query.","minimum":0,"maximum":1,"example":0.7},"normalizedScore":{"type":"number","format":"float","description":"Score (0.0-1.0) normalized across all results, where the top result is 1.0 and the lowest is 0.0.","minimum":0,"maximum":1,"example":0.9}}}},"components/schemas/AITopicSummary":{"id":"components/schemas/AITopicSummary","kind":"json-schema","title":"Topic Summary","data":{"title":"Topic Summary","type":"object","description":"This schema contains the topic ID and name of the topics. This is used by TopicBreadcrumb.","properties":{"id":{"type":"string","pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The alphanumeric ID of the topic."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A topic ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"minLength":7,"maxLength":20,"example":"PROD-1921"},"name":{"type":"string","description":"The name of the topic.","pattern":"^[\\w\\W]*$","minLength":1,"maxLength":255,"example":"Banking Regulations"}}}},"components/schemas/AITopicBreadcrumb":{"id":"components/schemas/AITopicBreadcrumb","kind":"json-schema","title":"Topic Breadcrumb","data":{"title":"Topic Breadcrumb","type":"object","description":"This schema contains one or more TopicSummary instances.","properties":{"topicSummary":{"items":{"$ref":"#/components/schemas/AITopicSummary"},"description":"An instance of TopicSummary.","type":"array","minItems":1,"maxItems":50}}}},"components/schemas/schemas-Tags":{"id":"components/schemas/schemas-Tags","kind":"json-schema","title":"Tags","data":{"title":"Tags","type":"object","properties":{"id":{"type":"string","description":"Tag Category ID","minLength":6,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$"},"tags":{"type":"array","items":{"type":"string","description":"Tag ID","minLength":6,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$"},"minItems":1,"maxItems":20}}}},"components/schemas/ArticleAISearchResult":{"id":"components/schemas/ArticleAISearchResult","kind":"json-schema","title":"ArticleAISearchResult","data":{"type":"object","required":["id","name","docType","source","snippet","normalizedScore","topicBreadcrumb"],"description":"Represents a single document or snippet returned by search, along with its metadata and relevance score.","properties":{"id":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article. "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" An Article ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","example":"PROD-2996"},"name":{"type":"string","description":"The name of the Article or source content.","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$","example":"Fair Lending FAQs"},"docType":{"type":"string","enum":["HTML","DOCX","PDF","PPTX","XLSX","XLSM","XLSB"],"description":"Format of the source document.","example":"PDF"},"docName":{"type":"string","description":"Name of the attachment, if an attachment was used as the source content.","minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$","example":"Lending FAQs"},"source":{"type":"string","enum":["eGain Article","eGain Attachment"],"description":"The source type.","example":"eGain Article"},"customAttributes":{"type":"array","description":"Custom attributes assigned to an article","items":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":4000,"pattern":"^[\\w\\W]+$","description":"The custom attribute's name.","example":"loan_id"},"value":{"type":"array","items":{"type":"string"},"description":"The custom attribute's values.","example":["78391"]},"type":{"type":"string","enum":["STRING","INTEGER","BOOLEAN","DATETIME"],"description":"The custom attribute's type.","example":"STRING"}}},"minItems":0,"maxItems":25},"snippet":{"type":"string","description":"A semantic snippet of the article content.","minLength":0,"maxLength":5000,"pattern":"^[\\w\\W]*$","example":"What is fair lending..."},"keywordSnippet":{"type":"string","description":"A keyword search snippet of article content.","minLength":0,"maxLength":5000,"pattern":"^[\\w\\W]*$","example":"What is fair lending..."},"additionalSnippets":{"type":"array","items":{"$ref":"#/components/schemas/AdditionalSnippets"},"minItems":0,"maxItems":5,"description":"An array of snippets belonging to the same article."},"additionalSnippetCount":{"type":"integer","minimum":0,"maximum":5,"description":"Number of additional snippets.","example":1},"contextualSummary":{"type":"string","description":"Contextual Summary generated as part of metadata for the chunk content.","minLength":0,"maxLength":1000,"pattern":"^[\\w\\W]*$","example":"The summary of the lending FAQ..."},"modifiedDate":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z$","minLength":20,"maxLength":25,"description":"The date on which the Article was last modified.","example":"2025-01-28T19:53:58Z"},"headerPath":{"type":"string","minLength":0,"maxLength":100,"description":"The header path of the snippet retrieved.","pattern":"^[\\w\\W]*$","example":"FAQs"},"topicBreadcrumb":{"type":"array","items":{"$ref":"#/components/schemas/AITopicBreadcrumb"},"minItems":1,"maxItems":50,"description":"A list of topics from the root topic to this Article. There may be multiple paths."},"tagCategories":{"type":"array","items":{"$ref":"#/components/schemas/schemas-Tags"},"description":"An array of tag categories. Note that the total number of tag categories cannot exceed 20.","minItems":0,"maxItems":20},"articleTypeAttributes":{"type":"object","description":"The type of the Article and its attributes.","properties":{"typeName":{"type":"string","example":"General","description":"Indicates the article category name.","minLength":1,"maxLength":255},"articleTypeId":{"description":"The ID of the Article Type.","minLength":15,"maxLength":15,"pattern":"^[0-9]+$","example":243500000023393}}},"relevanceScore":{"type":"number","format":"float","description":"Query-specific relevance score (0.0-1.0) that reflects how well the result matches the user query. This score is only available when a re-ranker is enabled and represents a direct relevance comparison between the query and the returned snippet.\n","minimum":0,"maximum":1,"example":0.8},"normalizedScore":{"type":"number","format":"float","description":"Relative ranking score (0.0-1.0) normalized across all returned results, based on a combination of BM25 and semantic similarity scores. This score indicates how a result ranks compared to others in the same response, not its absolute relevance to the query. As a result, a high score does not necessarily imply strong query relevance.\n","minimum":0,"maximum":1,"example":0.9}}}},"components/schemas/AISPaginationInfo":{"id":"components/schemas/AISPaginationInfo","kind":"json-schema","title":"PaginationInfo","data":{"type":"object","title":"PaginationInfo","required":["count","pagenum","pagesize"],"properties":{"count":{"title":"count","description":"The total number of pages.","type":"integer","minimum":0,"maximum":1,"default":1},"pagenum":{"title":"pagenum","description":"The page number requested. Page numbers start from 1.","type":"integer","minimum":1,"maximum":1,"default":1},"pagesize":{"title":"pagesize","description":"The number of objects requested per page. The maximum number of objects per page is 75.","type":"integer","minimum":1,"maximum":30,"default":20},"link":{"title":"link","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Can include the "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"prev"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"next"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" link."},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/Link"},"maxItems":2,"minItems":0}}}},"components/schemas/AISearchResponse":{"id":"components/schemas/AISearchResponse","kind":"json-schema","title":"AISearchResponse","data":{"type":"object","required":["searchResults"],"properties":{"searchResults":{"type":"object","description":"Top search results with relevance scores","properties":{"article":{"type":"array","items":{"$ref":"#/components/schemas/ArticleAISearchResult"},"minItems":1,"maxItems":50}}},"paginationInfo":{"$ref":"#/components/schemas/AISPaginationInfo"}}}},"components/schemas/Suggestion":{"id":"components/schemas/Suggestion","kind":"json-schema","title":"suggestion","data":{"description":"This schema contains information about a Suggestion.","title":"suggestion","type":"object","required":["id","name"],"properties":{"id":{"description":"The ID of the Suggestion. A Suggestion ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits.","type":"string","pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","example":"PROD-0623","minLength":7,"maxLength":20},"link":{"$ref":"#/components/schemas/Link"},"name":{"description":"The name of the Suggestion.","type":"string","pattern":"^[\\s\\S]*\\S[\\s\\S]*$","minLength":1,"maxLength":255},"description":{"description":"The description of the Suggestion.","type":"string","pattern":"^[\\w\\W]*$","minLength":0,"maxLength":255},"content":{"description":"The content of the Suggestion.","type":"string","pattern":"^[\\s\\S]*\\S[\\s\\S]*$","minLength":1,"maxLength":10000},"hasRelatedArticles":{"type":"boolean","description":"If true, the Suggestion has one or more Related Articles."},"status":{"type":"object","title":"L10NString","properties":{"value":{"title":"value","description":"A string that indicates the value.","type":"string"},"displayValue":{"title":"displayValue","description":"Localized string of the value element.","type":"string"}},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The status of the Suggestion."},"children":[]}]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"1 : suggested."},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"2 : pending"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"3 : declined"},"children":[]}]},{"$$mdtype":"Node","type":"tag","tag":"html","attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","attributes":{"content":"4 : approved"},"children":[]}]}],"pattern":"^[1-4]$","minLength":1,"maxLength":1},"modifiedBy":{"$ref":"#/components/schemas/modifiedBy"},"modifiedDate":{"description":"The last modified date and last modifying user of the Suggestion.","type":"string","format":"date-time","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z$","minLength":20,"maxLength":25},"hasAttachments":{"description":"Indicates whether the Suggestion has any Attachments.","type":"boolean"},"hasComments":{"description":"Indicates whether the Suggestion has any comments.","type":"boolean"},"language":{"type":"object","title":"Language","required":["code"],"properties":{"code":{"title":"code","description":"The language that describes the details of the resource. Resources available in different languages may differ from each other.","type":"string","enum":["en-US","en-GB","fr-FR","es-ES","it-IT","de-DE","nl-NL","pt-BR","pt-PT","da-DK","sv-SE","ru-RU","zh-CN","ja-JP","ko-KR","de-AT","th-TH","vi-VN","id-ID","ms-MY","fil-PH","fr-CA","hi-IN","uk-UA","bg-BG","sk-SK","sl-SI"]},"label":{"title":"label","description":"The name of the language.","type":"string","enum":["English","French","Spanish","Italian","German","Dutch","Portuguese","Danish","Swedish","Russian","Chinese","Japanese","Korean","Thai","Vietnamese","Indonesian","Malay","Filipino","Hindi","Ukrainian","Bulgarian","Slovak","Slovene","Serbian"]}},"description":"The knowledge base language in which the Suggestion was created."},"customAttributes":{"items":{"$ref":"#/components/schemas/CustomAttribute"},"type":"array","minItems":0,"maxItems":15,"description":"Custom Attributes of the Suggestion."}}}},"components/schemas/Suggestions":{"id":"components/schemas/Suggestions","kind":"json-schema","title":"suggestions","data":{"title":"suggestions","type":"object","description":"One or more instances of Suggestion.","properties":{"Suggestion":{"type":"array","items":{"$ref":"#/components/schemas/Suggestion"}},"paginationInfo":{"$ref":"#/components/schemas/PaginationInfo"}}}},"components/schemas/AttachmentForCreateSuggestion":{"id":"components/schemas/AttachmentForCreateSuggestion","kind":"json-schema","title":"attachment","data":{"description":"This schema contains the definition of an Attachment.","title":"attachment","type":"object","properties":{"altId":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The alternate Id of the Attachment that was obtained after calling "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"../../../../../apis/v3/core/filemgr/api-bundled/storageservice/generatepreuploadurl"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Generate signed URL to upload an attachment"},"children":[]}]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","minLength":36,"maxLength":36}}}},"components/schemas/ModifySuggestion":{"id":"components/schemas/ModifySuggestion","kind":"json-schema","title":"suggestion","data":{"description":"This schema contains information about modifying a Suggestion.","title":"suggestion","type":"object","required":["id","modifiedDate"],"properties":{"id":{"description":"The ID of the Suggestion. A Suggestion ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits.","type":"string","pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","example":"PROD-3259","minLength":7,"maxLength":20},"name":{"description":"The name of the Suggestion.","type":"string","pattern":"^[\\s\\S]*\\S[\\s\\S]*$","minLength":1,"maxLength":255},"description":{"description":"The description of the Suggestion.","type":"string","pattern":"^[\\w\\W]*$","minLength":0,"maxLength":255},"content":{"description":"The content of the Suggestion.","type":"string","pattern":"^[\\s\\S]*\\S[\\s\\S]*$","minLength":1,"maxLength":10000},"modifiedDate":{"description":"The date on which the Suggestion was last modified.","type":"string","format":"DateAndTime","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z$","minLength":20,"maxLength":25},"attachments":{"title":"attachments","type":"object","properties":{"attachment":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The list of Attachments."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Required if "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"content"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Attachments.unlink"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are both "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"_"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"not"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" provided."},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/AttachmentForCreateSuggestion"},"maxItems":250},"unlink":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If provided with references to Attachments, "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"unlink"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" removes the Attachment from the Suggestion."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the Attachment has no associated objects, it will be deleted."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Required if "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"content"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Attachments.Attachment"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are both "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"_"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"not"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" provided."},"children":[]}]}]}],"type":"array","items":{"$ref":"#/components/schemas/Link"},"maxItems":250}},"description":"Details of Attachments for the Suggestion."},"customAttributes":{"items":{"$ref":"#/components/schemas/CustomAttribute"},"type":"array","minItems":0,"maxItems":15,"description":"Custom Attributes of the Suggestion."}}}},"components/schemas/CreateSuggestion":{"id":"components/schemas/CreateSuggestion","kind":"json-schema","title":"CreateSuggestion","data":{"description":"This schema contains information about a Suggestion.","title":"CreateSuggestion","type":"object","required":["name","content","language"],"properties":{"name":{"description":"The name of the Suggestion.","type":"string","pattern":"^[\\s\\S]*\\S[\\s\\S]*$","minLength":1,"maxLength":255},"description":{"description":"The description of the Suggestion.","type":"string","pattern":"^[\\w\\W]*$","minLength":0,"maxLength":255},"content":{"description":"The content of the Suggestion.","type":"string","pattern":"^[\\s\\S]*\\S[\\s\\S]*$","minLength":1,"maxLength":10000},"feedbackArticle":{"title":"RelatedArticleForCreateUpdateDeleteSuggestion","type":"object","properties":{"id":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of a Related Article."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An Article ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"type":"string","pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","example":"PROD-9821","minLength":7,"maxLength":20}},"description":"The Article that the Suggestion was created for."},"attachments":{"title":"attachments","type":"object","properties":{"attachment":{"type":"array","items":{"$ref":"#/components/schemas/AttachmentForCreateSuggestion"},"maxItems":20,"description":"The list of Attachments."}},"description":"Details of Attachments for the Suggestion."},"language":{"type":"object","title":"Language","required":["code"],"properties":{"code":{"description":"The code of the language.","allOf":[{"$ref":"#/components/schemas/LegacyKBLanguageCodes"}]}},"description":"The knowledge base language in which the Suggestion is created."},"customAttributes":{"description":"The Custom Attributes of the Suggestion.","minItems":0,"maxItems":15,"type":"array","items":{"$ref":"#/components/schemas/CustomAttribute"}}}}},"components/schemas/FeedbackArticleForSuggestion":{"id":"components/schemas/FeedbackArticleForSuggestion","kind":"json-schema","title":"suggestion","data":{"description":"This schema contains information about a Suggestion.","title":"suggestion","type":"object","properties":{"id":{"description":"The ID of the Suggestion. A Suggestion ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits.","type":"string","pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","example":"PROD-3259","minLength":7,"maxLength":20},"name":{"description":"The name of the Suggestion.","type":"string","pattern":"^[\\s\\S]*\\S[\\s\\S]*$","minLength":1,"maxLength":255},"relatedArticles":{"description":"Related Articles for the Suggestion.","type":"array","items":{"$ref":"#/components/schemas/ArticleResult"}}}}},"components/schemas/Comment":{"id":"components/schemas/Comment","kind":"json-schema","title":"Comment","data":{"description":"This schema contains the definition of a comment object.","title":"Comment","type":"object","properties":{"id":{"properties":{},"description":"The ID of the comment.","type":"string","minLength":1,"maxLength":9,"pattern":"^[1-9]\\d*$"},"content":{"properties":{},"description":"The content of the comment.","type":"string","pattern":"^[\\s\\S]*\\S[\\s\\S]*$","minLength":1,"maxLength":2000},"createdBy":{"$ref":"#/components/schemas/createdBy"},"createdDate":{"type":"string","format":"DateAndTime","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z$","minLength":20,"maxLength":25}}}},"components/schemas/Comments":{"id":"components/schemas/Comments","kind":"json-schema","title":"Comments","data":{"description":"This schema contains the definition of an array of comments.","title":"Comments","type":"object","properties":{"count":{"properties":{},"description":"The number of comments.","type":"integer","format":"int32","minimum":0,"maximum":75},"comments":{"type":"array","items":{"$ref":"#/components/schemas/Comment"},"minItems":1,"maxItems":75,"description":"The list of comments."}}}},"components/schemas/CreateComment":{"id":"components/schemas/CreateComment","kind":"json-schema","title":"Comment","data":{"description":"This schema contains the definition for comment creation.","title":"Comment","type":"object","properties":{"content":{"description":"Content of the Comment","type":"string","pattern":"^[\\s\\S]*\\S[\\s\\S]*$","minLength":1,"maxLength":2000}}}},"components/schemas/AttachmentSummary":{"id":"components/schemas/AttachmentSummary","kind":"json-schema","title":"attachment","data":{"description":"Summary attributes for an Attachment.","title":"attachment","type":"object","properties":{"id":{"properties":{},"description":"The ID of the Attachment.","type":"string","minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","example":"PROD-1001"},"link":{"$ref":"#/components/schemas/Link"},"fileName":{"properties":{},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name of the Attachment file."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This must not exceed 255 characters."},"children":[]}]}]}]}],"type":"string","maxLength":255,"minLength":1},"size":{"properties":{},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The size of the Attachment."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Limited to 25MB."},"children":[]}]}]}]}],"type":"integer","format":"int32","minimum":1,"maximum":26214400}}}},"components/schemas/Attachments":{"id":"components/schemas/Attachments","kind":"json-schema","title":"attachments","data":{"description":"This schema contains the definition of Attachments.","title":"attachments","type":"object","properties":{"count":{"properties":{},"description":"The number of Attachments in the list.","type":"integer","format":"int32","minimum":1,"maximum":25},"link":{"$ref":"#/components/schemas/Link"},"attachments":{"description":"The list of Attachments.","type":"array","items":{"$ref":"#/components/schemas/AttachmentSummary"},"minItems":1,"maxItems":25}}}},"components/schemas/SuggestionAttachment":{"id":"components/schemas/SuggestionAttachment","kind":"json-schema","title":"attachment","data":{"description":"This schema contains the definition of an Attachment.","title":"attachment","type":"object","properties":{"id":{"properties":{},"description":"The ID of the Attachment.","type":"string","minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","example":"PROD-1001"},"link":{"$ref":"#/components/schemas/Link"},"fileName":{"properties":{},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name of the Attachment file."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This must not exceed 255 characters."},"children":[]}]}]}]}],"type":"string","maxLength":255,"minLength":1},"size":{"properties":{},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The size of the Attachment."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"li","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Limited to 25MB."},"children":[]}]}]}]}],"type":"integer","format":"int32","minimum":1,"maximum":26214400},"contentUrl":{"properties":{},"description":"The content URL of the Attachment. Download immediately, as this unique URL exists temporarily and can only be retrieved once before deletion. \n","type":"string","maxLength":1024,"minLength":1}}}},"components/schemas/Milestones":{"id":"components/schemas/Milestones","kind":"json-schema","title":"Milestones","data":{"type":"object","title":"Milestones","properties":{"milestone":{"description":"milestones","items":{"$ref":"#/components/schemas/Milestone"},"type":"array"}}}},"components/schemas/ArticlePermissions":{"id":"components/schemas/ArticlePermissions","kind":"json-schema","title":"ArticlePermissions","data":{"type":"object","description":"User permissions on the parent folder.","properties":{"view":{"type":"boolean","description":"User has 'View Folder' permission on the parent folder."},"edit":{"type":"boolean","description":"User has 'Edit Article' permission on the parent folder."}}}},"components/schemas/ArticlePermissionsResult":{"id":"components/schemas/ArticlePermissionsResult","kind":"json-schema","title":"ArticlePermissions","data":{"title":"ArticlePermissions","type":"object","description":"User permissions on the parent folder.","properties":{"articleID":{"type":"string","description":"ID of Article","minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","example":"EGSP-2433"},"permissions":{"$ref":"#/components/schemas/ArticlePermissions"}}}},"components/schemas/CreateFederatedSearchEvent":{"id":"components/schemas/CreateFederatedSearchEvent","kind":"json-schema","title":"CreateFederatedSearchEvent","data":{"title":"CreateFederatedSearchEvent","type":"object","required":["q","resultType","url","title","languageCode"],"properties":{"q":{"type":"string","pattern":"^[\\w\\W]+$","minLength":1,"maxLength":1024,"example":"India","description":"The search string that was entered by the user"},"resultType":{"type":"string","enum":["external","internal"],"description":"Only \"external\" or \"internal\" allowed","example":"external"},"url":{"type":"string","pattern":"^(https?|ftp):\\/\\/([a-zA-Z0-9-]+\\.)+[a-zA-Z]{2,6}(:\\d+)?(\\/[^\\s]*)?$","minLength":10,"maxLength":2000,"example":"https://egain.com/"},"title":{"type":"string","pattern":"^[\\w\\W]+$","minLength":1,"maxLength":255,"example":"Welcome to eGain"},"languageCode":{"$ref":"#/components/schemas/LegacyKBLanguageCodes"}}}},"components/schemas/createSearchResultEventForConnectors":{"id":"components/schemas/createSearchResultEventForConnectors","kind":"json-schema","title":"createViewedSearchResultEventForConnectors","data":{"type":"object","title":"createViewedSearchResultEventForConnectors","required":["languageCode","q","numberOfSearchResults"],"properties":{"languageCode":{"$ref":"#/components/schemas/LegacyKBLanguageCodes"},"q":{"type":"string","example":"India","description":"The string to use for the search.","minLength":1,"maxLength":1024},"numberOfSearchResults":{"type":"integer","format":"int32","minimum":1,"maximum":25,"example":10}}}},"components/schemas/createViewedSearchResultEventForConnectors":{"id":"components/schemas/createViewedSearchResultEventForConnectors","kind":"json-schema","title":"createSearchResultEventForConnectors","data":{"type":"object","title":"createSearchResultEventForConnectors","required":["q","url","title","languageCode"],"properties":{"languageCode":{"$ref":"#/components/schemas/LegacyKBLanguageCodes"},"q":{"description":"The string to use for the search.","type":"string","example":"India","pattern":"^[\\w\\W]+$","minLength":1,"maxLength":1024},"url":{"type":"string","description":"The URL of the search result.","pattern":"^(https?|ftp):\\/\\/([a-zA-Z0-9-]+\\.)+[a-zA-Z]{2,6}(:\\d+)?(\\/[^\\s]*)?$","minLength":10,"maxLength":2000,"example":"https://egain.com/"},"title":{"type":"string","description":"The title of the search result.","pattern":"^[\\w\\W]+$","minLength":1,"maxLength":255,"example":"Welcome to India"}}}},"components/schemas/AttachmentUpload":{"id":"components/schemas/AttachmentUpload","kind":"json-schema","title":"AttachmentUpload","data":{"required":["name","size"],"title":"AttachmentUpload","type":"object","properties":{"name":{"description":"The name of the attachment.","type":"string","minLength":1,"maxLength":200,"pattern":"^[\\w\\W]+$"},"size":{"type":"integer","format":"int64","description":"The size of the attachment in bytes. The maximum size is limited to 25MB.","minimum":1,"maximum":26214400}}}},"components/schemas/Attachment":{"id":"components/schemas/Attachment","kind":"json-schema","title":"Attachment","data":{"title":"Attachment","type":"object","properties":{"altId":{"description":"The ID of the attachment.","type":"string","minLength":36,"maxLength":36,"pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$","example":"f665fb41-6485-43c3-a2c8-c72857c29f74"},"name":{"description":"The name of the attachment.","type":"string","minLength":1,"maxLength":200,"pattern":"^[\\w\\W]+$","example":"article.png"},"contentUrl":{"description":"The content URL to upload an attachment.","type":"string","pattern":"^(https?|ftp):\\/\\/[^\\s/$.?#].[^\\s]*$","maxLength":1000,"example":"https://EG5842ain.ezdev.net/knowledge/portalmgr/v4/attachmnet/upload?signature=3552656867434671616F6C51786335674B764E7848586E786B383255555A41574F6B656F542B396258677A334341322F2B32336F434D6D6E47637955714C6A6E4D527476666C534E4C6232520D0A4F6F70637259773043515A6778596949586F3247666B6E624350386336563446624C5446746C546B2F324A734E425939634758507465722B6C584435685747734C4A2B6C626342732F426E640D0A4D7965456452564A6670525069536D2B43423232384A67724F636C4161654F39336F42784942354C6776462F50724D67674A3248527253504C53457551596A7A6D4B347A4F7A63416C7047450D0A39556133495776504A4875336D77757330773D3D"}}}},"components/schemas/SftpConfig":{"id":"components/schemas/SftpConfig","kind":"json-schema","title":"SftpConfig","data":{"type":"object","properties":{"username":{"type":"string","maxLength":128,"example":"rtka-user"},"password":{"type":"string","maxLength":128,"example":"xyz1234"},"host":{"type":"string","description":"The hostname of the SFTP server","pattern":"^(?!:\\/\\/)([a-zA-Z0-9-]{1,63}\\.)+[a-zA-Z]{2,63}$","maxLength":128,"example":"sftp.yourcompany.com"},"port":{"type":"integer","description":"The server port number","format":"int32","default":22}},"required":["username","host"]}},"components/schemas/S3Config":{"id":"components/schemas/S3Config","kind":"json-schema","title":"S3Config","data":{"type":"object","properties":{"region":{"description":"Region of the data destination","type":"string","maxLength":20,"example":"us-west-2"},"accessKey":{"type":"string","maxLength":128,"example":"s3-access-key"},"secretKey":{"type":"string","maxLength":128,"example":"s3-access-secret"}},"required":["region","accessKey","secretKey"]}},"components/schemas/KnowledgeExport":{"id":"components/schemas/KnowledgeExport","kind":"json-schema","title":"KnowledgeExport","data":{"title":"KnowledgeExport","type":"object","required":["portalID","language","resourceTypes","dataDestination"],"properties":{"articleCategories":{"description":"Category of articles to return. If all is selected, it includes both browsable and searchable articles.","type":"string","enum":["searchable","all"],"default":"searchable"},"portalID":{"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the portal being accessed."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits."},"children":[]}]}]}],"type":"string","minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","example":"PROD-1000"},"language":{"description":"The Knowledge Base language in which the content is created.","type":"object","title":"language","required":["code"],"properties":{"code":{"description":"The code of the language.","allOf":[{"$ref":"#/components/schemas/LegacyKBLanguageCodes"}],"example":"en-US"}}},"exportUnpublishedOnly":{"description":"Determines which article version to export. If true, the latest unpublished version will be exported for each article where available, and articles that do not have an unpublished version will be omitted from the export. If this property is false or omitted, the latest published version will be exported for each article where available. Each request exports either all published or all unpublished article versions in a portal; never both.","type":"boolean","default":false},"resourceTypes":{"type":"array","items":{"type":"string","enum":["articles","topics","portals","all"],"example":"articles"},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Types of Knowledge Hub resources to export. Use 'all' to specify all resource types at once."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Below are the attributes that are returned for each resource type specified."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":5},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Portal Resource Type Attributes"},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Portal Attribute Name"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"id"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Portal in Readable format."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"alternateId"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The system-generated ID of the Portal in long format."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"name"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name of the Portal."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"description"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Portal's description."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"departmentId"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ID of the department this Portal belongs to."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"defaultContentLanguageId"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The default ID of the language for the portal content."},"children":[]}]}]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":5},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Topic Resource Type Attributes"},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Topic Attribute Name"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Description"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"id"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Topic in Readable form."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"alternateId"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The system-generated ID of the Topic in long form."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"name"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The name of the Topic."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"departmentId"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ID of the department this Topic belongs to."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"modifiedDate"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date when the Topic was last modified on."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"topicHomeArticleId"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of the Article used as the home page of this Topic."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"childCount"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Total number of children sub-topis below the current Topic."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"subTopicIds"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Array with the list of sub-topics (all levels of the topic hierarchy)."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"parentTopicId"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ID of the parent Topic. -1 if it is the root Topic."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"imageURL"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"URL of the inline Topic image."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"customAttributes"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"One or more comma-separated names for Topic custom attributes defined by the user to be returned."},"children":[]}]}]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":5},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Article Resource Type Attributes"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Export article's attributes returned are aligned with the response of the "},"children":[]},{"$$mdtype":"Node","type":"link","inline":true,"attributes":{"href":"../apis/v4/knowledge/portalmgr/api-bundled/article/getarticlebyidwitheditions"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Get Article By ID with Editions"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" API."},"children":[]}]}]}]},"dataDestination":{"type":"object","properties":{"destinationType":{"type":"string","description":"Type of data destination","enum":["AWS S3 bucket","SFTP server"],"example":"AWS S3 bucket"},"path":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Path of the data destination. For S3 bucket, it can be root or a folder. For SFTP, it can be target directory on the server."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Examples:"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For S3:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"\"s3://amzn-s3-demo-bucket/mydeptfolder\""},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For SFTP:"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"\"exports/mydeptfolder\""},"children":[]}]}]}]}],"maxLength":1024,"example":"s3://amzn-s3-demo-bucket/mydeptfolder"},"sftpDetails":{"$ref":"#/components/schemas/SftpConfig"},"s3Details":{"$ref":"#/components/schemas/S3Config"}},"required":["destinationType","path"]}}}},"components/schemas/ExportStatus":{"id":"components/schemas/ExportStatus","kind":"json-schema","title":"ExportStatus","data":{"type":"object","properties":{"status":{"type":"string","enum":["Pending","In Progress","Successful","Failed"],"example":"In Progress"},"progress":{"type":"object","description":"Details about the job's progress.","properties":{"processed":{"type":"integer","description":"The number of items processed so far.","example":1500},"total":{"type":"integer","description":"The total number of items to process.","example":4500},"percentage":{"type":"number","format":"float","description":"The percentage of the job that is complete.","example":30}}},"startTime":{"type":"string","format":"date-time","description":"The timestamp when the job started.","example":"2025-09-15T10:00:00.000Z"},"estimatedCompletion":{"type":"string","format":"date-time","description":"The estimated timestamp when the job is expected to finish.","example":"2025-09-15T11:30:00.000Z"},"completionTime":{"type":"string","format":"date-time","description":"The timestamp when the job completed.","example":"2025-09-15T11:25:00.000Z"},"failureTime":{"type":"string","format":"date-time","description":"The timestamp when the job failed.","example":"2025-09-15T10:45:00.000Z"},"results":{"type":"object","description":"Breakdown of completed job results.","properties":{"successful":{"type":"integer","description":"The count of successfully processed items.","example":4485},"warnings":{"type":"integer","description":"The count of items with warnings.","example":10},"errors":{"type":"integer","description":"The count of items with errors.","example":5}}},"error":{"type":"string","description":"A description of the job failure reason.","example":"Connection timeout after processing 1500 items."}},"required":["status"]}},"components/schemas/TagCategoryForExport":{"id":"components/schemas/TagCategoryForExport","kind":"json-schema","title":"TagCategory","data":{"title":"TagCategory","type":"object","properties":{"id":{"description":"ID of the tag category.","type":"string","example":"PROD-1046","minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$"},"name":{"minLength":1,"maxLength":255,"pattern":"^[\\w\\W]+$","type":"string","description":"name of the tag category."},"tagGroup":{"items":{"$ref":"#/components/schemas/schemas-TagGroup"},"type":"array"},"tag":{"items":{"$ref":"#/components/schemas/schemas-Tag"},"type":"array"},"created":{"type":"object","title":"DateAndTime","required":["date"],"properties":{"user":{"$ref":"#/components/schemas/UserView"},"date":{"title":"date","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date in the format "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"YYYY-MM-DDTHH:MM:SS"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"string","format":"date-time","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z$"}},"description":"Date the Tag Category was created."},"lastModified":{"type":"object","title":"DateAndTime","required":["date"],"properties":{"user":{"$ref":"#/components/schemas/UserView"},"date":{"title":"date","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The date in the format "},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"code","attrs":{}},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"YYYY-MM-DDTHH:MM:SS"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"type":"string","format":"date-time","pattern":"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z$"}},"description":"Date of last modification."}}}},"schema_510":{"kind":"json-schema","data":{"type":"string","minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","example":"PROD-1000"},"id":"schema_510"},"schema_511":{"kind":"json-schema","data":{"type":"string","pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","minLength":7,"maxLength":20,"example":"PROD-2996"},"id":"schema_511"},"schema_512":{"kind":"json-schema","data":{"$ref":"#/components/schemas/LegacyKBLanguageCodes"},"id":"schema_512"},"schema_513":{"kind":"json-schema","data":{"type":"array","items":{"type":"string","enum":["content","articleMacro","availabilityDate","availableEditions","averageRating","bookmarkStatus","contentText","compliance","timesRated","createdBy.userName","modifiedBy.userName","ownedBy","ownedBy.userName","workflow","all"]}},"id":"schema_513"},"schema_514":{"kind":"json-schema","data":{"type":"string","pattern":"^([a-zA-Z0-9_-]+)(?:,[a-zA-Z0-9_-]+)*$","minLength":1,"maxLength":4000,"description":"One or more comma-separated names for custom attributes defined by the user to be returned."},"id":"schema_514"},"schema_515":{"kind":"json-schema","data":{"type":"string","enum":["article_view","article_view_more_related_Article","article_view_basic_search","article_view_adv_search","article_view_guided_help","article_view_browse_topic","article_view_browse_tree","article_view_popular_articles","article_view_useful_items","article_view_widget","article_view_announcement","article_view_bookmarked","article_view_subscription_notification","article_view_guided_help_additional_info","view_articles_pending_compliance","type_ahead_Suggestion","semantic_Suggestion","instant_answer","instant_answer_reference"],"default":"article_view"},"id":"schema_515"},"schema_516":{"kind":"json-schema","data":{"type":"string","minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$"},"id":"schema_516"},"schema_517":{"kind":"json-schema","data":{"type":"string","enum":["authoring","staging","publish"],"example":"publish"},"id":"schema_517"},"schema_518":{"kind":"json-schema","data":{"type":"string","minLength":4,"maxLength":9,"pattern":"^[0-9]{4,9}$"},"id":"schema_518"},"schema_519":{"kind":"json-schema","data":{"type":"string","maxLength":40,"pattern":"^[\\w\\W]+$"},"id":"schema_519"},"schema_520":{"kind":"json-schema","data":{"type":"string","enum":["en-US","es-ES","fr-FR","it-IT","de-DE","nl-NL","pt-BR","pt-PT","da-DK","ru-RU","fr-CA","zh-CN","ja-JP","ko-KR","sv-SE"],"example":"en-US"},"id":"schema_520"},"schema_521":{"kind":"json-schema","data":{"type":"string","minLength":7,"maxLength":20,"example":"PROD-2996"},"id":"schema_521"},"schema_522":{"kind":"json-schema","data":{"type":"string","pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","minLength":7,"maxLength":20,"example":"PROD-3020"},"id":"schema_522"},"schema_523":{"kind":"json-schema","data":{"type":"string","pattern":"^999$|^[1-9][0-9]{3,8}$","minLength":3,"maxLength":8,"example":"999"},"id":"schema_523"},"schema_524":{"kind":"json-schema","data":{"type":"array","items":{"type":"string","enum":["useForCertifiedAnswers"]}},"id":"schema_524"},"schema_525":{"kind":"json-schema","data":{"type":"string","default":"application/json","enum":["application/json"]},"id":"schema_525"},"schema_526":{"kind":"json-schema","data":{"type":"string","minLength":1,"maxLength":15,"example":"959500000204621"},"id":"schema_526"},"schema_527":{"kind":"json-schema","data":{"type":"array","items":{"type":"string","enum":["averageRating","customAttributes","description","articleSummary","imageURL","isSubscribed","timesRated","topicBreadcrumb","ownedBy","ownedBy.userName","workflow","compliance","personalization","all"]}},"id":"schema_527"},"schema_528":{"kind":"json-schema","data":{"type":"string","pattern":"^([a-zA-Z0-9]{2,4}-\\d{4,15})(,([a-zA-Z0-9]{2,4}-\\d{4,15})){0,19}$","minLength":7,"maxLength":2048,"example":"PROD-5381"},"id":"schema_528"},"schema_529":{"kind":"json-schema","data":{"type":"integer","format":"int64","minimum":1,"maximum":999,"default":1},"id":"schema_529"},"schema_530":{"kind":"json-schema","data":{"type":"integer","format":"int64","minimum":1,"maximum":75,"default":10},"id":"schema_530"},"schema_531":{"kind":"json-schema","data":{"type":"string","enum":["availabilityDate","popularity","name"],"example":"name"},"id":"schema_531"},"schema_532":{"kind":"json-schema","data":{"type":"string","enum":["asc","desc"],"example":"asc","description":"Sort order of articles."},"id":"schema_532"},"schema_533":{"kind":"json-schema","data":{"type":"integer","format":"int32","minimum":1,"maximum":100,"example":10},"id":"schema_533"},"schema_534":{"kind":"json-schema","data":{"type":"string","pattern":"^[\\w\\W]+$","minLength":1,"maxLength":255},"id":"schema_534"},"schema_535":{"kind":"json-schema","data":{"type":"array","items":{"type":"string","enum":["averageRating","articleSummary","customAttributes","description","imageURL","isSubscribed","timesRated","topicBreadcrumb","ownedBy","ownedBy.userName","workflow","compliance","personalization","all"]}},"id":"schema_535"},"schema_536":{"kind":"json-schema","data":{"type":"string","pattern":"^[\\w\\W]*$"},"id":"schema_536"},"schema_537":{"kind":"json-schema","data":{"type":"string","enum":["authoring","publish","staging"],"default":"publish","description":"workflow milestone of the Article","example":"publish"},"id":"schema_537"},"schema_538":{"kind":"json-schema","data":{"type":"string","pattern":"^[0-9]{4}$|^[a-zA-Z0-9]{2,4}-\\d{4,15}$","minLength":4,"maxLength":20,"example":"PROD-12345"},"id":"schema_538"},"schema_539":{"kind":"json-schema","data":{"type":"string","pattern":"^[1-9]\\d*$","minLength":4,"maxLength":19,"example":"4759"},"id":"schema_539"},"schema_540":{"kind":"json-schema","data":{"type":"string","pattern":"^[1-9]\\d{14}$","example":"202201000000002"},"id":"schema_540"},"schema_541":{"kind":"json-schema","data":{"type":"boolean","default":true},"id":"schema_541"},"schema_542":{"kind":"json-schema","data":{"type":"string","pattern":"^question\\.custom\\.[^,]+(?:,question\\.custom\\.[^,]+)*$","minLength":1,"maxLength":4000,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Custom attributes to be fetched."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Possible values are:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"question.custom.<name> where <name> is the internal name of custom attribute of question. 'question' is used as a prefix to distinguish question's custom attribute from other objects custom attributes."},"children":[]}]}]}]}]},"id":"schema_542"},"schema_543":{"kind":"json-schema","data":{"type":"object","properties":{"X-RateLimit-Limit":{"type":"integer","maxLength":3600,"description":"Request limit per minute."},"X-RateLimit-Remaining":{"type":"integer","maxLength":3600,"description":"The number of requests left for the time window."},"X-RateLimit-Reset":{"type":"string","format":"date-time","description":"The UTC date/time at which the current rate limit window resets."}}},"id":"schema_543"},"schema_544":{"kind":"json-schema","data":{"type":"string","pattern":"^[1-9]\\d*$","minLength":10,"maxLength":10,"example":"1000000402"},"id":"schema_544"},"schema_545":{"kind":"json-schema","data":{"type":"string","pattern":"^[1-9]\\d*$","minLength":10,"maxLength":15,"example":"1000001085"},"id":"schema_545"},"schema_546":{"kind":"json-schema","data":{"type":"array","items":{"type":"string","enum":["questionDetail","actions","all"],"example":"all"}},"id":"schema_546"},"schema_547":{"kind":"json-schema","data":{"type":"boolean"},"id":"schema_547"},"schema_548":{"kind":"json-schema","data":{"type":"string","pattern":"^[1-9]\\d*$","minLength":1,"maxLength":19,"example":"11"},"id":"schema_548"},"schema_549":{"kind":"json-schema","data":{"type":"string","example":"service","pattern":"^[\\w\\W]+$","minLength":0,"maxLength":255},"id":"schema_549"},"schema_550":{"kind":"json-schema","data":{"type":"string","example":"master","pattern":"^[\\w\\W]+$","minLength":0,"maxLength":255},"id":"schema_550"},"schema_551":{"kind":"json-schema","data":{"type":"string","example":"silver","pattern":"^[\\w\\W]+$","minLength":0,"maxLength":255},"id":"schema_551"},"schema_552":{"kind":"json-schema","data":{"type":"string","enum":["id","name","departmentName"]},"id":"schema_552"},"schema_553":{"kind":"json-schema","data":{"type":"string","enum":["asc","desc"],"example":"asc"},"id":"schema_553"},"schema_554":{"kind":"json-schema","data":{"type":"integer","format":"int64","minimum":1,"maximum":75,"default":25},"id":"schema_554"},"schema_555":{"kind":"json-schema","data":{"pattern":"^[\\w\\W]+$","type":"string","minLength":1,"maxLength":1024,"example":"What is a loan?"},"id":"schema_555"},"schema_556":{"kind":"json-schema","data":{"type":"string","pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","minLength":7,"maxLength":20,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Readable ID of the user profile."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]}]}]}],"example":"PROD-1030"},"id":"schema_556"},"schema_557":{"kind":"json-schema","data":{"type":"object","minProperties":1,"maxProperties":20,"additionalProperties":{"type":"array","description":"Tag Category IDs","minItems":0,"maxItems":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","items":{"type":"string","description":"Tag IDs","minLength":7,"maxLength":20,"pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$"}}},"id":"schema_557"},"schema_558":{"kind":"json-schema","data":{"type":"array","items":{"type":"string","pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$"},"minItems":1,"maxItems":20},"id":"schema_558"},"schema_559":{"kind":"json-schema","data":{"type":"string","minLength":1,"maxLength":4000},"id":"schema_559"},"schema_560":{"kind":"json-schema","data":{"type":"integer","format":"int64","minimum":1,"maximum":1,"default":1},"id":"schema_560"},"schema_561":{"kind":"json-schema","data":{"type":"integer","format":"int64","minimum":1,"maximum":30,"default":20},"id":"schema_561"},"schema_562":{"kind":"json-schema","data":{"type":"string","enum":["suggested","pending","declined","approved"],"example":"suggested"},"id":"schema_562"},"schema_563":{"kind":"json-schema","data":{"type":"string","enum":["id","name"],"example":"id"},"id":"schema_563"},"schema_564":{"kind":"json-schema","data":{"type":"array","items":{"type":"string","enum":["content","modifiedBy.userName","all"]}},"id":"schema_564"},"schema_565":{"kind":"json-schema","data":{"type":"array","items":{"type":"string","enum":["contentUrl","all"]}},"id":"schema_565"},"schema_566":{"kind":"json-schema","data":{"type":"string","pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","minLength":7,"maxLength":20,"example":"PROD-1069"},"id":"schema_566"},"schema_567":{"kind":"json-schema","data":{"type":"integer","format":"int64","minimum":-1,"maximum":20,"example":1},"id":"schema_567"},"schema_568":{"kind":"json-schema","data":{"type":"array","items":{"type":"string","enum":["description","createdBy.userName","createdBy.firstName","createdBy.lastName","createdBy.middleName","modifiedBy.userName","modifiedBy.firstName","modifiedBy.lastName","modifiedBy.middleName","imageUrl","textMetaData","all"]}},"id":"schema_568"},"schema_569":{"kind":"json-schema","data":{"type":"integer","format":"int32","minimum":1,"maximum":999,"default":1},"id":"schema_569"},"schema_570":{"kind":"json-schema","data":{"type":"integer","format":"int32","minimum":1,"maximum":75,"default":10},"id":"schema_570"},"schema_571":{"kind":"json-schema","data":{"type":"string","pattern":"^[a-zA-Z0-9]{2,4}-\\d{4,15}$","minLength":7,"maxLength":20,"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The Readable ID of the user profile."},"children":[]},{"$$mdtype":"Node","type":"tag","tag":"html","inline":true,"attributes":{"name":"br","attrs":{}},"children":[]}]}]}],"example":"PROD-3210"},"id":"schema_571"},"schema_572":{"kind":"json-schema","data":{"type":"object","properties":{"location":{"type":"string","example":"/knowledge/portalmgr/v4/content/export/7A84B875-6F75-4C7B-B137-0632B62DB0BD","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Location Header"},"children":[]}]},{"$$mdtype":"Node","type":"hardbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This header contains the URL to check the status of your validation job. The jobID (as in this example) is the unique identifier for tracking this operation.               ```"},"children":[]}]}]}]}}},"id":"schema_572"},"schema_573":{"kind":"json-schema","data":{"type":"string","example":"7A84B875-6F75-4C7B-B137-0632B62DB0BD"},"id":"schema_573"}},"exampleStore":{"components/examples/Required_Attribute_Missing":{"id":"components/examples/Required_Attribute_Missing","value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"description":"Required query parameter is missing."},"components/examples/Unallowed_Attribute_Value":{"id":"components/examples/Unallowed_Attribute_Value","value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"description":"One of the attributes has a value which is not allowed."},"components/examples/Invalid_Authorization":{"id":"components/examples/Invalid_Authorization","value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"description":"Invalid or expired authorization. Generate a new authorization header and try again.\n"},"components/examples/Scope_Not_Assigned":{"id":"components/examples/Scope_Not_Assigned","value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n"},"components/examples/Resource_Not_Found":{"id":"components/examples/Resource_Not_Found","value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"description":"Resource not found."},"components/examples/NotAcceptable":{"id":"components/examples/NotAcceptable","value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."}},"components/examples/InternalServerError":{"id":"components/examples/InternalServerError","value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."}},"components/examples/Precondition_Failed":{"id":"components/examples/Precondition_Failed","value":{"code":"412-100","developerMessage":"Precondition failed: <prerequisite requirement>."},"description":"A prerequisite condition for this request has not been met.\n"},"components/examples/Unable_Delete_Approved_Suggestion":{"id":"components/examples/Unable_Delete_Approved_Suggestion","value":{"code":"400-113","developerMessage":"The Suggestion you are trying to delete has been approved and cannot be removed."},"description":"The resource cannot be deleted."},"components/examples/Too_Many_Request":{"id":"components/examples/Too_Many_Request","value":{"code":"429-001","developerMessage":"Too many requests."},"description":"Too many requests. Try again at a later time.\n"},"components/examples/SftpDestinationExample":{"id":"components/examples/SftpDestinationExample","value":{"articleCategories":"searchable","portalID":"PROD-1000","language":{"code":"en-US"},"resourceTypes":["articles"],"dataDestination":{"destinationType":"SFTP server","path":"exports/mydeptfolder","sftpDetails":{"username":"rtka-user","password":"xyz1234","host":"sftp.yourcompany.com","port":22}}},"summary":"Export configuration using an SFTP destination"},"components/examples/S3DestinationExample":{"id":"components/examples/S3DestinationExample","value":{"articleCategories":"searchable","portalID":"PROD-1000","language":{"code":"en-US"},"resourceTypes":["articles"],"dataDestination":{"destinationType":"AWS S3 bucket","path":"s3://amzn-s3-demo-bucket/mydeptfolder","s3Details":{"region":"us-west-2","accessKey":"s3-access-key","secretKey":"s3-access-secret"}}},"summary":"Export configuration using an AWS S3 bucket destination"},"components/examples/UnsupportedParameters":{"id":"components/examples/UnsupportedParameters","value":{"code":"400-101","developerMessage":"Unsupported query parameter(s) supplied: '<query_parameter>'."}},"components/examples/InvalidValue":{"id":"components/examples/InvalidValue","value":{"code":"400-152","developerMessage":"Invalid value is provided in the request body for the following attribute:'<attribute_name>'."}},"components/examples/MissingParameter":{"id":"components/examples/MissingParameter","value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: '<query_parameter>'."}},"components/examples/Unauthorized":{"id":"components/examples/Unauthorized","value":{"code":"401-101","developerMessage":"Invalid or expired 'Authorization' header provided. New login is required."}},"components/examples/Forbidden":{"id":"components/examples/Forbidden","value":{"code":"403-178","developerMessage":"User is not allowed to perform the following action: <action_name>."}},"components/examples/NotFound":{"id":"components/examples/NotFound","value":{"code":"404-100","developerMessage":"The following IDs supplied in the URI path were not found: '<resource_id>'."}},"paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/200/content/application~1json/examples/Summary Attributes":{"value":{"id":"PROD-2996","name":"Fair Lending FAQs","additionalInfo":"Can be shared to public.","articleType":{"articleCategoryId":0,"typeName":"General","useStructuredAuthoring":false,"articleTypeId":"999900000002020"},"articleKeywords":"Fair lending, Fair Housing Act, Discrimination protection, Residential mortgage loans, Equal opportunity housing","articleState":"P","articleSummary":"Fair lending ensures that lenders do not discriminate based on race, color,national origin, religion, sex, familial status, or disability when applying forresidential mortgage loans. The federal Fair Housing Act protects individuals'fair lending rights, enforced by the Office of Fair Housing and Equal Opportunity,along with state and local agencies. This law applies to U.S. citizens, greencard holders, and undocumented residents, ensuring equal opportunities in homesales, rentals, and financing.","attachments":[{"name":"eightbank.png","type":"INTERNAL","size":45152,"link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/articles/attachments/PROD-1000?q=fair%2Blending&%articleAdditionalAttributes=allonalArticleResult&workflowMilestone=publish&%24lang=en-US"},"id":"PROD-1000"}],"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-06-30T14:54:55Z","departmentID":"1001","description":"Common questions and answers regarding Fair Lending.","expirationDate":"2031-01-02T10:56:00Z","imageURL":"https://hd.egain.com/images/km-for-dummies-24.jpg","includeInGenAI":true,"isSubscribed":true,"languageCode":"en-US","modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2025-01-28T19:53:58Z","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/articles/PROD-2996?%&workflowMilestone=publish&accessSource=article_view&publishViewId=PROD-3203&%24lang=en-US"},"topicBreadcrumb":[{"topicSummary":[{"name":"Banking Regulations","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/topics/PROD-1080"}}]}],"versionId":"PROD-2884"},"key":"Summary Attributes","summary":"Summary Attributes","id":"paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/200/content/application~1json/examples/Summary Attributes"},"paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/200/content/application~1json/examples/Summary Attributes with Structured Authoring enabled":{"value":{"id":"PROD-2996","name":"Fair Lending FAQs","additionalInfo":"Can be shared to public.","articleType":{"articleCategoryId":0,"typeName":"General","useStructuredAuthoring":true,"articleTypeId":"999800000002020"},"articleKeywords":"Fair lending, Fair Housing Act, Discrimination protection, Residential mortgage loans, Equal opportunity housing","articleState":"P","articleSummary":"Fair lending ensures that lenders do not discriminate based on race, color,national origin, religion, sex, familial status, or disability when applying forresidential mortgage loans. The federal Fair Housing Act protects individuals'fair lending rights, enforced by the Office of Fair Housing and Equal Opportunity,along with state and local agencies. This law applies to U.S. citizens, greencard holders, and undocumented residents, ensuring equal opportunities in homesales, rentals, and financing.","attachments":[{"name":"eightbank.png","type":"INTERNAL","size":45152,"link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/articles/attachments/PROD-1000?q=fair%2Blending&%articleAdditionalAttributes=allonalArticleResult&workflowMilestone=publish&%24lang=en-US"},"id":"PROD-1000"}],"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-06-30T14:54:55Z","departmentID":"1001","description":"Common questions and answers regarding Fair Lending.","expirationDate":"2031-01-02T10:56:00Z","hasAttachments":true,"imageURL":"https://hd.egain.com/images/km-for-dummies-24.jpg","includeInGenAI":true,"languageCode":"en-US","structuredAuthoringFields":{"confidenceLevel":{"value":"","displayValue":""},"issue":"","environment":"","cause":""},"modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2025-01-28T19:53:58Z","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/articles/PROD-2996?workflowMilestone=publish&accessSource=article_view&publishViewId=PROD-3203&%24lang=en-US"},"topicBreadcrumb":[{"topicSummary":[{"name":"Banking Regulations","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/topics/PROD-1080"}}]}],"versionId":"PROD-2884"},"key":"Summary Attributes with Structured Authoring enabled","summary":"Summary Attributes with Structured Authoring enabled","id":"paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/200/content/application~1json/examples/Summary Attributes with Structured Authoring enabled"},"paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/200/content/application~1json/examples/All Attributes":{"value":{"id":"PROD-2996","name":"Fair Lending FAQs","additionalInfo":"Can be shared to public.","articleType":{"articleCategoryId":0,"typeName":"General","useStructuredAuthoring":false,"articleTypeId":"999700000002020"},"articleKeywords":"Fair lending, Fair Housing Act, Discrimination protection, Residential mortgage loans, Equal opportunity housing","articleMacro":"","articleState":"P","articleSummary":"Fair lending ensures that lenders do not discriminate based on race, color,national origin, religion, sex, familial status, or disability when applying forresidential mortgage loans. The federal Fair Housing Act protects individuals'fair lending rights, enforced by the Office of Fair Housing and Equal Opportunity,along with state and local agencies. This law applies to U.S. citizens, greencard holders, and undocumented residents, ensuring equal opportunities in homesales, rentals, and financing.","attachments":[{"name":"eightbank.png","type":"INTERNAL","size":45152,"link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/articles/attachments/PROD-1000?q=fair%2Blending&%articleAdditionalAttributes=allonalArticleResult&workflowMilestone=publish&%24lang=en-US"},"id":"PROD-1000"}],"availabilityDate":"2025-01-28T19:53:58Z","availableEditions":[{"id":"PROD-2886","name":"Customers","isContentEdition":true,"publishProfile":{"id":"PROD-3203","name":"default"},"link":{"rel":"article","href":"/knowledge/portalmgr/v4/portals/PROD-1000/articles/PROD-2996?%articleResultAdditionalAttributes=allonalArticleResult&workflowMilestone=publish&%24lang=en-US&edition=PROD-2886"}}],"averageRating":0,"bookmarkStatus":{"isBookmarked":true,"bookmarkID":777700000001234,"folderBreadcrumb":{"folderSummary":[{"name":"content","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-0001/bookmarks/folders/1001"},"id":1001}]}},"compliance":{"startDate":{"date":"2022-06-30T14:54:55Z"},"dueDate":{"date":"2025-07-30T14:54:55Z"}},"content":"<h1>What is fair lending?</h1>\\n\\n<p>Fair lending prohibits lenders from considering your race, color, national origin, religion, sex, familial status, or disability when applying for residential mortgage loans. Fair lending guarantees the same lending opportunities to everyone.</p>\\n\\n\\n\\n\\n\\n<h1>If I am not from the United States, does the federal Fair Housing Act protect me?</h1>\\n\\n<p>Yes, whether you are a U.S. citizen, registered alien (a “green card” holder), or an undocumented resident of the U.S., you are protected by the federal Fair Housing Act.</p>\\n\\n<h1>How can the Fair Housing Act protect me when I purchase a home?</h1>\\n\\n<p>The federal Fair Housing Act makes it unlawful to discriminate in the sale, rental, or financing of homes because of race, color, national origin, religion, sex, familial status, or disability</p>\\n","contentText":"What is fair lending?\r\n\n\n\r\nFair lending prohibits lenders from considering your race, color, national origin, religion, sex, familial status, or disability when applying for residential mortgage loans. Fair lending guarantees the same lending opportunities to everyone.\n\n\n\n\n\n\r\nIf I am not from the United States, does the federal Fair Housing Act protect me?\r\n\n\n\r\nYes, whether you are a U.S. citizen, registered alien (a “green card” holder), or an undocumented resident of the U.S., you are protected by the federal Fair Housing Act.\n\n\r\nHow can the Fair Housing Act protect me when I purchase a home?\r\n\n\n\r\nThe federal Fair Housing Act makes it unlawful to discriminate in the sale, rental, or financing of homes because of race, color, national origin, religion, sex, familial status, or disability\n","createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-06-30T14:54:55Z","departmentID":"1001","description":"Common questions and answers regarding Fair Lending.","expirationDate":"2031-01-02T10:56:00Z","hasAttachments":true,"imageURL":"https://hd.egain.com/images/km-for-dummies-24.jpg","includeInGenAI":true,"isSubscribed":true,"languageCode":"en-US","structuredAuthoringFields":{"confidenceLevel":{"value":"","displayValue":""},"issue":"","environment":"","cause":""},"modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2025-01-28T19:53:58Z","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/articles/PROD-2996?q=fair%2Blending&%articleAdditionalAttributes=all&workflowMilestone=publish&accessSource=article_view&publishViewId=PROD-3203&%24lang=en-US"},"ownedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"timesRated":0,"topicBreadcrumb":[{"topicSummary":[{"name":"Banking Regulations","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/topics/PROD-1080"}}]}],"customAttributes":[{"name":"region","value":["north_america"],"type":"STRING"},{"name":"target_audience","value":["retail_banking","mortgage_advisors"],"type":"STRING"},{"name":"review_cycle_months","value":["12"],"type":"INTEGER"},{"name":"next_compliance_review","value":["2026-05-05 11:53:47.0"],"type":"DATETIME"}],"versionId":"PROD-2884","workflow":{"stages":[{"name":"publish","milestone":{"name":{"value":"publish","displayValue":"Published"}}}]}},"key":"All Attributes","summary":"All Attributes","id":"paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/200/content/application~1json/examples/All Attributes"},"paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1articles~1{articleID}/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1articles~1{articleID}~1witheditions/get/responses/200/content/application~1json/examples/Article with Editions":{"value":{"id":"PROD-2996","additionalInfo":"Can be shared to public.","articleType":{"articleCategoryId":0,"typeName":"General","useStructuredAuthoring":false,"articleTypeId":"100100000002020"},"articleKeywords":"Fair lending, Fair Housing Act, Discrimination protection, Residential mortgage loans, Equal opportunity housing","articleSummary":"Fair lending ensures that lenders do not discriminate based on race, color, national origin, religion, sex, familial status, or disability when applying for residential mortgage loans. The federal Fair Housing Act protects individuals' fair lending rights, enforced by the Office of Fair Housing and Equal Opportunity, along with state and local agencies. This law applies to U.S. citizens, green card holders, and undocumented residents, ensuring equal opportunities in home sales, rentals, and financing.","attachments":[{"id":"PROD-1000","name":"eightbank.png","size":45152,"type":"INTERNAL","link":{"rel":"self","href":"/knowledge/portalmgr/v4/articles/attachments/PROD-1000"}}],"availabilityDate":"2025-01-28T19:53:58.000Z","availableEditions":[{"id":"PROD-2940","publishProfile":{"id":"PROD-3020","name":"Internal"},"link":{"rel":"self","href":"/knowledge/portalmgr/v4/articles/PROD-2996/editions/PROD-3020?%24lang=en-US"}},{"id":"PROD-2941","publishProfile":{"id":"PROD-3203","name":"Customers"},"link":{"rel":"self","href":"/knowledge/portalmgr/v4/articles/PROD-2996/editions/PROD-3203?%24lang=en-US"}}],"averageRating":0,"createdBy":{"id":"1013","userName":"jdoe","firstName":"John","middleName":"","lastName":"Doe"},"modifiedBy":{"id":"1013","userName":"jdoe","firstName":"John","middleName":"","lastName":"Doe"},"ownedBy":{"id":"1013","userName":"jdoe","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-06-30T07:54:55.000Z","customAttributes":[{"name":"region","value":["north_america"],"type":"STRING"},{"name":"target_audience","value":["retail_banking","mortgage_advisors"],"type":"STRING"},{"name":"review_cycle_months","value":["12"],"type":"INTEGER"},{"name":"next_compliance_review","value":["2026-05-05 11:53:47.0"],"type":"DATETIME"}],"departmentID":"1001","description":"Common questions and answers regarding Fair Lending.","expirationDate":"2031-01-02T18:56:15.000Z","imageURL":"https://hd.egain.com/images/km-for-dummies-24.jpg","includeInGenAI":true,"isSubscribed":false,"modifiedDate":"2025-01-28T19:53:58.000Z","languageCode":"en-US","link":{"rel":"self","href":"/knowledge/portalmgr/v4/articles/PROD-2996/witheditions?%24lang=en-US"},"name":"Fair Lending FAQs","articleState":"P","timesRated":0,"versionId":"PROD-2939","workflow":{"stages":[{"name":"publish","milestone":{"name":{"value":"publish","displayValue":"Published"}}}]},"personalization":{"filters":{"tagCategory":[{"name":"Banking","id":"PROD-1014","tags":{"tag":[{"name":"Fair Lending","id":"PROD-5381"},{"name":"Banking Industry Regulations","id":"PROD-2930"}]},"tagGroups":{"tagGroup":[{"name":"Banking","id":"PROD-2745"}]}}]}}},"key":"Article with Editions","summary":"Article with Editions","id":"paths/~1articles~1{articleID}~1witheditions/get/responses/200/content/application~1json/examples/Article with Editions"},"paths/~1articles~1{articleID}~1witheditions/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1articles~1{articleID}~1witheditions/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1articles~1{articleID}~1witheditions/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1articles~1{articleID}~1witheditions/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1articles~1{articleID}~1witheditions/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1articles~1{articleID}~1witheditions/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1articles~1{articleID}~1witheditions/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1articles~1{articleID}~1witheditions/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1articles~1{articleID}~1witheditions/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1articles~1{articleID}~1witheditions/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1articles~1{articleID}~1witheditions/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1articles~1{articleID}~1witheditions/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1articles~1{articleID}~1witheditions/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1articles~1{articleID}~1witheditions/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/200/content/application~1json/example":{"value":{"id":"PROD-2940","name":"Internal","publishProfile":{"id":"PROD-3020","name":"Internal"},"content":"<h1>What is fair lending?</h1>\n\n<p>Fair lending prohibits lenders from considering your race, color, national origin, religion, sex, familial status, or disability when applying for residential mortgage loans. Fair lending guarantees the same lending opportunities to everyone.</p>\n\n\n\n\n\n<h1>If I am not from the United States, does the federal Fair Housing Act protect me?</h1>\n\n<p>Yes, whether you are a U.S. citizen, registered alien (a “green card” holder), or an undocumented resident of the U.S., you are protected by the federal Fair Housing Act.</p>\n\n<h1>How can the Fair Housing Act protect me when I purchase a home?</h1>\n\n<p>The federal Fair Housing Act makes it unlawful to discriminate in the sale, rental, or financing of homes because of race, color, national origin, religion, sex, familial status, or disability</p>\n\n<p></p>\n","contentText":"What is fair lending?\r\n\n\n\r\nFair lending prohibits lenders from considering your race, color, national origin, religion, sex, familial status, or disability when applying for residential mortgage loans. Fair lending guarantees the same lending opportunities to everyone.\n\n\n\n\n\n\r\nIf I am not from the United States, does the federal Fair Housing Act protect me?\r\n\n\n\r\nYes, whether you are a U.S. citizen, registered alien (a “green card” holder), or an undocumented resident of the U.S., you are protected by the federal Fair Housing Act.\n\n\r\nHow can the Fair Housing Act protect me when I purchase a home?\r\n\n\n\r\nThe federal Fair Housing Act makes it unlawful to discriminate in the sale, rental, or financing of homes because of race, color, national origin, religion, sex, familial status, or disability\n\n\r\n\n","accessTags":{"tagCategory":[{"name":"Channel","tag":[{"id":"PROD-1010","name":"Internal"}]},{"name":"Banking","tag":[{"id":"PROD-2196","name":"FAQs"}]}]},"link":{"rel":"self","href":"/knowledge/portalmgr/v4/articles/PROD-2996/editions/PROD-3020?%24lang=en-US"}},"id":"paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/200/content/application~1json/example"},"paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1articles~1{articleID}~1editions~1{publishViewId}/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1articletypes/get/responses/200/content/application~1json/example":{"value":[{"articleTypeId":"100100000000001","typeName":"General","description":"Knowledge","imageURL":"https://hd.egain.com/images/km-for-dummies-24.jpg","articleCategoryId":0,"useStructuredAuthoring":true,"isSearchable":true,"isBrowsable":true},{"articleTypeId":"100100000000002","typeName":"General","description":"FAQ","articleCategoryId":0,"useStructuredAuthoring":true,"isSearchable":true,"isBrowsable":true},{"articleTypeId":"100100000000003","typeName":"Suggestion","description":"Suggestions","articleCategoryId":4,"useStructuredAuthoring":true,"isSearchable":true,"isBrowsable":true}],"id":"paths/~1articletypes/get/responses/200/content/application~1json/example"},"paths/~1articletypes/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1articletypes/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1articletypes/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1articletypes/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1articletypes/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1articletypes/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1articletypes/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1articletypes/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1articletypes/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1articletypes/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1articletypes/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1articletypes/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1articletypes/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1articletypes/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1addtoreply/put/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1addasreference/put/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1articles/get/responses/200/content/application~1json/examples/Summary Attributes":{"value":{"articles":[{"id":"PROD-2996","name":"Fair Lending FAQs","articleType":{"articleCategoryId":0,"typeName":"General","useStructuredAuthoring":false,"articleTypeId":"999200000002020"},"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-06-30T14:54:55Z","hasAttachments":true,"languageCode":"en-US","modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2025-01-28T19:53:58Z","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/articles/PROD-2996?filter%5Btopic%5D=PROD-1069&workflowMilestone=publish&%24lang=en-US"},"versionId":"PROD-2884"}],"paginationInfo":{"count":1,"pagenum":1,"pagesize":10}},"key":"Summary Attributes","summary":"Summary Attributes","id":"paths/~1portals~1{portalID}~1articles/get/responses/200/content/application~1json/examples/Summary Attributes"},"paths/~1portals~1{portalID}~1articles/get/responses/200/content/application~1json/examples/All Attributes":{"value":{"articles":[{"id":"PROD-2996","name":"Fair Lending FAQs","articleType":{"articleCategoryId":0,"typeName":"General","useStructuredAuthoring":false,"articleTypeId":"999100000002020"},"articleSummary":"Fair lending ensures that lenders do not discriminate based on race, color,national origin, religion, sex, familial status, or disability when applying forresidential mortgage loans. The federal Fair Housing Act protects individuals'fair lending rights, enforced by the Office of Fair Housing and Equal Opportunity,along with state and local agencies. This law applies to U.S. citizens, greencard holders, and undocumented residents, ensuring equal opportunities in homesales, rentals, and financing.","averageRating":0,"compliance":{"startDate":{"date":"2022-06-30T14:54:55Z"},"dueDate":{"date":"2025-07-30T14:54:55Z"}},"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe","userName":"jdoe"},"createdDate":"2022-06-30T14:54:55Z","description":"Common questions and answers regarding Fair Lending.","hasAttachments":true,"imageURL":"https://hd.egain.com/images/km-for-dummies-24.jpg","isSubscribed":true,"languageCode":"en-US","modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe","userName":"jdoe"},"modifiedDate":"2025-01-28T19:53:58Z","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/articles/PROD-2996?24articleResultAdditionalAttributes=all&filter%5Btopic%5D=PROD-1069&workflowMilestone=publish&%24lang=en-US"},"ownedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe","userName":"jdoe"},"timesRated":0,"topicBreadcrumb":[{"topicSummary":[{"name":"Banking Regulations","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/topics/PROD-1080"}}]}],"versionId":"PROD-2884","customAttributes":[{"name":"region","value":["north_america"],"type":"STRING"},{"name":"target_audience","value":["retail_banking","mortgage_advisors"],"type":"STRING"},{"name":"review_cycle_months","value":["12"],"type":"INTEGER"},{"name":"next_compliance_review","value":["2026-05-05T11:53:47.000Z"],"type":"DATETIME"}],"workflow":{"stages":[{"name":"publish","milestone":{"name":{"value":"publish","displayValue":"Published"}}}]}}],"paginationInfo":{"count":1,"pagenum":1,"pagesize":10}},"key":"All Attributes","summary":"All Attributes","id":"paths/~1portals~1{portalID}~1articles/get/responses/200/content/application~1json/examples/All Attributes"},"paths/~1portals~1{portalID}~1articles/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1articles/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1articles/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1articles/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1articles/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1articles/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1articles/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1articles/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1articles/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1articles/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1articles/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1articles/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1articles/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1articles/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1articles~1attachments~1{attachmentID}/get/responses/200/content/application~1json/examples/GetAttachmentById":{"value":{"attachmentContent":[{"attachmentId":"PROD-1000","name":"eightbank.png","type":"INTERNAL","attachmentContentType":"image/png","streamingUrl":"https://developerv3api.egain.cloud/system/ws/v11/internal/stream/23a8f919-f9be-4d66-b717-69f51d6044c9","size":45152,"link":{"rel":"self","href":"/knowledge/portalmgr/v3/portals/PROD-1000/articles/attachments/PROD-1000?%24attribute=all&%24lang=en-US"}}]},"key":"GetAttachmentById","summary":"GetAttachmentById","id":"paths/~1articles~1attachments~1{attachmentID}/get/responses/200/content/application~1json/examples/GetAttachmentById"},"paths/~1articles~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1articles~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1articles~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1articles~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1articles~1attachments~1{attachmentID}/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1articles~1attachments~1{attachmentID}/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1articles~1attachments~1{attachmentID}/get/responses/403/content/application~1json/examples/Actor Not Allowed":{"value":{"code":"403-112","developerMessage":"Unauthorized URL access: <actor> are not allowed to access this URL."},"key":"Actor Not Allowed","summary":"Actor Not Allowed","description":"This actor is not allowed to access this API. Refer to Authorization section of API description to know \nwhich actors are allowed to access this API.\n","id":"paths/~1articles~1attachments~1{attachmentID}/get/responses/403/content/application~1json/examples/Actor Not Allowed"},"paths/~1articles~1attachments~1{attachmentID}/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Unauthorized URL access: Logged in actor must have '<required_scopes>' scope to access this URL."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"This actor does not have required scope to call this API. Refer to Authorization section of API \ndescription to know which scope needs to be assigned to actor.\n","id":"paths/~1articles~1attachments~1{attachmentID}/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1articles~1attachments~1{attachmentID}/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1articles~1attachments~1{attachmentID}/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1articles~1attachments~1{attachmentID}/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1articles~1attachments~1{attachmentID}/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1articles~1attachments~1{attachmentID}/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1articles~1attachments~1{attachmentID}/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/200/content/application~1json/examples/All Attributes":{"value":{"attachmentContent":[{"attachmentId":"PROD-1000","name":"eightbank.png","type":"INTERNAL","attachmentContentType":"image/png","streamingUrl":"https://developerv3api.egain.cloud/system/ws/v11/internal/stream/23a8f919-f9be-4d66-b717-69f51d6044c9","size":45152,"link":{"rel":"self","href":"/knowledge/portalmgr/v3/portals/PROD-1000/articles/attachments/PROD-1000?%24attribute=all&%24lang=en-US"}}]},"key":"All Attributes","summary":"All Attributes","id":"paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/200/content/application~1json/examples/All Attributes"},"paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1articles~1attachments~1{attachmentID}/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/200/content/application~1json/examples/Summary Attributes":{"value":{"articles":[{"id":"PROD-3002","name":"Fair Lending","articleType":{"articleCategoryId":0,"typeName":"General","useStructuredAuthoring":false,"articleTypeId":"988500000002020"},"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-06-30T18:25:22Z","hasAttachments":false,"languageCode":"en-US","modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2025-01-28T20:58:11Z","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/articles/PROD-3002?%&workflowMilestone=publish&filter%5Btags%5D=PROD-5381&%24lang=en-US"},"versionId":"PROD-2897"}],"paginationInfo":{"count":1,"pagenum":1,"pagesize":10}},"key":"Summary Attributes","summary":"Summary Attributes","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/200/content/application~1json/examples/Summary Attributes"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/200/content/application~1json/examples/All Attributes":{"value":{"articles":[{"id":"PROD-3002","name":"Fair Lending","articleType":{"articleCategoryId":0,"typeName":"General","useStructuredAuthoring":false,"articleTypeId":"988200000002020"},"articleSummary":"Fair lending ensures that lenders do not discriminate based on race, color, national origin, religion, sex, familial status, or disability when offering residential mortgage loans, guaranteeing equal opportunities for all. The Office of Fair Housing and Equal Opportunity enforces the federal Fair Housing Act, with state and local agencies ensuring similar protections. Additional laws, such as the Equal Credit Opportunities Act, also safeguard your rights. For more information, visit the U.S. Department of Housing and Urban Development website.","averageRating":0,"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe","userName":"jdoe"},"createdDate":"2022-06-30T18:25:22Z","description":"Article detailing Fair Lending.","hasAttachments":false,"imageURL":"","isSubscribed":false,"languageCode":"en-US","modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe","userName":"jdoe"},"modifiedDate":"2025-01-28T20:58:11Z","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/articles/PROD-3002?%articleResultAdditionalAttributes=all&workflowMilestone=publish&filter%5Btags%5D=PROD-5381&%24lang=en-US"},"ownedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe","userName":"jdoe"},"timesRated":0,"topicBreadcrumb":[{"topicSummary":[{"name":"Banking Regulations","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/topics/PROD-1080"}}]}],"customAttributes":[{"name":"region","value":["north_america"],"type":"STRING"},{"name":"target_audience","value":["retail_banking","mortgage_advisors"],"type":"STRING"},{"name":"review_cycle_months","value":["12"],"type":"INTEGER"},{"name":"next_compliance_review","value":["2026-05-05T11:53:47.000Z"],"type":"DATETIME"}],"versionId":"PROD-2897","workflow":{"stages":[{"name":"publish","milestone":{"name":{"value":"publish","displayValue":"Published"}}}]}}],"paginationInfo":{"count":1,"pagenum":1,"pagesize":10}},"key":"All Attributes","summary":"All Attributes","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/200/content/application~1json/examples/All Attributes"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1related/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1articles~1announcements/get/responses/200/content/application~1json/examples/Summary Attributes":{"value":{"articles":[{"id":"PROD-2996","name":"Fair Lending FAQs","articleType":{"articleCategoryId":0,"typeName":"General","useStructuredAuthoring":false,"articleTypeId":"988100000002020"},"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-06-30T14:54:55Z","hasAttachments":true,"languageCode":"en-US","modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2025-01-28T19:53:58Z","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/articles/PROD-2996?filter%5Btopic%5D=PROD-1069&workflowMilestone=publish&%24lang=en-US"},"versionId":"PROD-2884"}],"paginationInfo":{"count":1,"pagenum":1,"pagesize":10}},"key":"Summary Attributes","summary":"Summary Attributes","id":"paths/~1portals~1{portalID}~1articles~1announcements/get/responses/200/content/application~1json/examples/Summary Attributes"},"paths/~1portals~1{portalID}~1articles~1announcements/get/responses/200/content/application~1json/examples/All Attributes":{"value":{"articles":[{"id":"PROD-2996","name":"Fair Lending FAQs","articleType":{"articleCategoryId":0,"typeName":"General","useStructuredAuthoring":false,"articleTypeId":"987100000002020"},"articleSummary":"Fair lending ensures that lenders do not discriminate based on race, color,national origin, religion, sex, familial status, or disability when applying forresidential mortgage loans. The federal Fair Housing Act protects individuals'fair lending rights, enforced by the Office of Fair Housing and Equal Opportunity,along with state and local agencies. This law applies to U.S. citizens, greencard holders, and undocumented residents, ensuring equal opportunities in homesales, rentals, and financing.","averageRating":0,"compliance":{"startDate":{"date":"2022-06-30T14:54:55Z"},"dueDate":{"date":"2025-07-30T14:54:55Z"}},"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe","userName":"jdoe"},"createdDate":"2022-06-30T14:54:55Z","description":"Common questions and answers regarding Fair Lending.","hasAttachments":true,"imageURL":"https://hd.egain.com/images/km-for-dummies-24.jpg","isSubscribed":true,"languageCode":"en-US","modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe","userName":"jdoe"},"modifiedDate":"2025-01-28T19:53:58Z","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/articles/PROD-2996?24articleResultAdditionalAttributes=all&filter%5Btopic%5D=PROD-1069&workflowMilestone=publish&%24lang=en-US"},"ownedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe","userName":"jdoe"},"timesRated":0,"topicBreadcrumb":[{"topicSummary":[{"name":"Banking Regulations","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/topics/PROD-1080"}}]}],"versionId":"PROD-2884","customAttributes":[{"name":"region","value":["north_america"],"type":"STRING"},{"name":"target_audience","value":["retail_banking","mortgage_advisors"],"type":"STRING"},{"name":"review_cycle_months","value":["12"],"type":"INTEGER"},{"name":"next_compliance_review","value":["2026-05-05T11:53:47.000Z"],"type":"DATETIME"}],"workflow":{"stages":[{"name":"publish","milestone":{"name":{"value":"publish","displayValue":"Published"}}}]}}],"paginationInfo":{"count":1,"pagenum":1,"pagesize":10}},"key":"All Attributes","summary":"All Attributes","id":"paths/~1portals~1{portalID}~1articles~1announcements/get/responses/200/content/application~1json/examples/All Attributes"},"paths/~1portals~1{portalID}~1articles~1announcements/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1articles~1announcements/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1articles~1announcements/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1articles~1announcements/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1articles~1announcements/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1articles~1announcements/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1articles~1announcements/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1articles~1announcements/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1articles~1announcements/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1articles~1announcements/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1articles~1announcements/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1articles~1announcements/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1articles~1announcements/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1articles~1announcements/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/200/content/application~1json/example":{"value":{"articleRatings":[{"id":"1000","articleId":"PROD-29028","ratingValue":85,"ratingComments":"Good article","userId":"1002","ratingTimestamp":"2024-09-16T14:30:00Z"},{"id":"1001","articleId":"PROD-29028","ratingValue":80,"ratingComments":"Good article","userId":"1005","ratingTimestamp":"2024-11-16T14:30:00Z"}],"paginationInfo":{"count":2,"pagenum":1,"pagesize":10,"link":[{"rel":"next","href":"/knowledge/portalmgr/v4/portals/PROD-1000/articles/PROD-2996/ratings?$pagenum=2"}]}},"id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/200/content/application~1json/example"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1ratings/put/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/200/content/application~1json/examples/Summary Article":{"value":{"article":[{"id":"PROD-2996","name":"Fair Lending FAQs","articleType":{"articleCategoryId":0,"typeName":"General","useStructuredAuthoring":false,"articleTypeId":"999500000002020"},"updateSummary":"","createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-06-30T14:54:55Z","hasAttachments":true,"languageCode":"en-US","modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2025-01-28T19:53:58Z","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/articles/PROD-2996?filter%5Btopic%5D=PROD-1069&workflowMilestone=publish&%24lang=en-US"},"versionId":"PROD-2884"}],"paginationInfo":{"count":1,"pagenum":1,"pagesize":10}},"key":"Summary Article","summary":"Summary Article","id":"paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/200/content/application~1json/examples/Summary Article"},"paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/200/content/application~1json/examples/All Attributes":{"value":{"article":[{"id":"PROD-2996","name":"Fair Lending FAQs","articleType":{"articleCategoryId":0,"typeName":"General","useStructuredAuthoring":false,"articleTypeId":"999400000002020"},"articleSummary":"Fair lending ensures that lenders do not discriminate based on race, color,national origin, religion, sex, familial status, or disability when applying forresidential mortgage loans. The federal Fair Housing Act protects individuals'fair lending rights, enforced by the Office of Fair Housing and Equal Opportunity,along with state and local agencies. This law applies to U.S. citizens, greencard holders, and undocumented residents, ensuring equal opportunities in homesales, rentals, and financing.","updateSummary":"","averageRating":0,"compliance":{"startDate":{"date":"2022-06-30T14:54:55Z"},"dueDate":{"date":"2025-07-30T14:54:55Z"}},"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe","userName":"jdoe"},"createdDate":"2022-06-30T14:54:55Z","description":"Common questions and answers regarding Fair Lending.","hasAttachments":true,"imageURL":"https://hd.egain.com/images/km-for-dummies-24.jpg","isSubscribed":true,"languageCode":"en-US","modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe","userName":"jdoe"},"modifiedDate":"2025-01-28T19:53:58Z","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/articles/PROD-2996?24articleResultAdditionalAttributes=all&filter%5Btopic%5D=PROD-1069&workflowMilestone=publish&%24lang=en-US"},"ownedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe","userName":"jdoe"},"timesRated":0,"topicBreadcrumb":[{"topicSummary":[{"name":"Banking Regulations","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/topics/PROD-1080"}}]}],"versionId":"PROD-2884","customAttributes":[{"name":"region","value":["north_america"],"type":"STRING"},{"name":"target_audience","value":["retail_banking","mortgage_advisors"],"type":"STRING"},{"name":"review_cycle_months","value":["12"],"type":"INTEGER"},{"name":"next_compliance_review","value":["2026-05-05T11:53:47.000Z"],"type":"DATETIME"}],"workflow":{"stages":[{"name":"publish","milestone":{"name":{"value":"publish","displayValue":"Published"}}}]}}],"paginationInfo":{"count":1,"pagenum":1,"pagesize":10}},"key":"All Attributes","summary":"All Attributes","id":"paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/200/content/application~1json/examples/All Attributes"},"paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1articles~1compliance~1pending/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/200/content/application~1json/examples/Summary Article":{"value":{"article":[{"id":"PROD-2996","name":"Fair Lending FAQs","articleType":{"articleCategoryId":0,"typeName":"General","useStructuredAuthoring":false,"articleTypeId":"999500000002020"},"updateSummary":"","createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-06-30T14:54:55Z","hasAttachments":true,"languageCode":"en-US","modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2025-01-28T19:53:58Z","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/articles/PROD-2996?filter%5Btopic%5D=PROD-1069&workflowMilestone=publish&%24lang=en-US"},"versionId":"PROD-2884"}],"paginationInfo":{"count":1,"pagenum":1,"pagesize":10}},"key":"Summary Article","summary":"Summary Article","id":"paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/200/content/application~1json/examples/Summary Article"},"paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/200/content/application~1json/examples/All Attributes":{"value":{"article":[{"id":"PROD-2996","name":"Fair Lending FAQs","articleType":{"articleCategoryId":0,"typeName":"General","useStructuredAuthoring":false,"articleTypeId":"999400000002020"},"articleSummary":"Fair lending ensures that lenders do not discriminate based on race, color,national origin, religion, sex, familial status, or disability when applying forresidential mortgage loans. The federal Fair Housing Act protects individuals'fair lending rights, enforced by the Office of Fair Housing and Equal Opportunity,along with state and local agencies. This law applies to U.S. citizens, greencard holders, and undocumented residents, ensuring equal opportunities in homesales, rentals, and financing.","updateSummary":"","averageRating":0,"compliance":{"startDate":{"date":"2022-06-30T14:54:55Z"},"dueDate":{"date":"2025-07-30T14:54:55Z"}},"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe","userName":"jdoe"},"createdDate":"2022-06-30T14:54:55Z","description":"Common questions and answers regarding Fair Lending.","hasAttachments":true,"imageURL":"https://hd.egain.com/images/km-for-dummies-24.jpg","isSubscribed":true,"languageCode":"en-US","modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe","userName":"jdoe"},"modifiedDate":"2025-01-28T19:53:58Z","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/articles/PROD-2996?24articleResultAdditionalAttributes=all&filter%5Btopic%5D=PROD-1069&workflowMilestone=publish&%24lang=en-US"},"ownedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe","userName":"jdoe"},"timesRated":0,"topicBreadcrumb":[{"topicSummary":[{"name":"Banking Regulations","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/topics/PROD-1080"}}]}],"versionId":"PROD-2884","customAttributes":[{"name":"region","value":["north_america"],"type":"STRING"},{"name":"target_audience","value":["retail_banking","mortgage_advisors"],"type":"STRING"},{"name":"review_cycle_months","value":["12"],"type":"INTEGER"},{"name":"next_compliance_review","value":["2026-05-05T11:53:47.000Z"],"type":"DATETIME"}],"workflow":{"stages":[{"name":"publish","milestone":{"name":{"value":"publish","displayValue":"Published"}}}]}}],"paginationInfo":{"count":1,"pagenum":1,"pagesize":10}},"key":"All Attributes","summary":"All Attributes","id":"paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/200/content/application~1json/examples/All Attributes"},"paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1articles~1compliance~1acknowledged/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1comply/put/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/200/content/application~1json/examples/Summary Article":{"value":{"articles":[{"id":"PROD-2996","name":"Fair Lending FAQs","articleType":{"articleCategoryId":0,"typeName":"General","useStructuredAuthoring":false,"articleTypeId":"999300000002020"},"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-06-30T14:54:55Z","hasAttachments":true,"languageCode":"en-US","modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2025-01-28T19:53:58Z","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/articles/PROD-2996?filter%5Btopic%5D=PROD-1069&workflowMilestone=publish&%24lang=en-US"},"versionId":"PROD-2884"}],"paginationInfo":{"count":1,"pagenum":1,"pagesize":10}},"key":"Summary Article","summary":"Summary Article","id":"paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/200/content/application~1json/examples/Summary Article"},"paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/200/content/application~1json/examples/All Attributes":{"value":{"articles":[{"id":"PROD-2996","name":"Fair Lending FAQs","articleType":{"articleCategoryId":0,"typeName":"General","useStructuredAuthoring":false,"articleTypeId":"999200000002020"},"articleSummary":"Fair lending ensures that lenders do not discriminate based on race, color,national origin, religion, sex, familial status, or disability when applying forresidential mortgage loans. The federal Fair Housing Act protects individuals'fair lending rights, enforced by the Office of Fair Housing and Equal Opportunity,along with state and local agencies. This law applies to U.S. citizens, greencard holders, and undocumented residents, ensuring equal opportunities in homesales, rentals, and financing.","averageRating":0,"compliance":{"startDate":{"date":"2022-06-30T14:54:55Z"},"dueDate":{"date":"2025-07-30T14:54:55Z"}},"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe","userName":"jdoe"},"createdDate":"2022-06-30T14:54:55Z","description":"Common questions and answers regarding Fair Lending.","hasAttachments":true,"imageURL":"https://hd.egain.com/images/km-for-dummies-24.jpg","isSubscribed":true,"languageCode":"en-US","modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe","userName":"jdoe"},"modifiedDate":"2025-01-28T19:53:58Z","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/articles/PROD-2996?24articleResultAdditionalAttributes=all&filter%5Btopic%5D=PROD-1069&workflowMilestone=publish&%24lang=en-US"},"ownedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe","userName":"jdoe"},"timesRated":0,"topicBreadcrumb":[{"topicSummary":[{"name":"Banking Regulations","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/topics/PROD-1080"}}]}],"versionId":"PROD-2884","customAttributes":[{"name":"region","value":["north_america"],"type":"STRING"},{"name":"target_audience","value":["retail_banking","mortgage_advisors"],"type":"STRING"},{"name":"review_cycle_months","value":["12"],"type":"INTEGER"},{"name":"next_compliance_review","value":["2026-05-05T11:53:47.000Z"],"type":"DATETIME"}],"workflow":{"stages":[{"name":"publish","milestone":{"name":{"value":"publish","displayValue":"Published"}}}]}}],"paginationInfo":{"count":1,"pagenum":1,"pagesize":10}},"key":"All Attributes","summary":"All Attributes","id":"paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/200/content/application~1json/examples/All Attributes"},"paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1articles~1subscribed/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1subscribe/put/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1unsubscribe/put/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/200/content/application~1json/example":{"value":{"articleID":"EGSP-2433","permissions":{"view":true,"edit":false}},"id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/200/content/application~1json/example"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1permissions/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/200/content/application~1json/example":{"value":{"accessTags":{"tagCategory":[]},"filters":{"tagCategory":[{"name":"Banking","tags":{"tag":[{"name":"Fair Lending","id":"PROD-5381"},{"name":"Banking Industry Regulations","id":"PROD-2930"}]},"tagGroups":{"tagGroup":[{"name":"Banking","id":"PROD-2745"}]},"id":"PROD-1014"}]},"publishViews":{"publishView":[{"name":"Internal","tagCategories":[{"tagCategory":[{"name":"Channel","tags":{"tag":[{"name":"Internal","id":"PROD-1010"}]},"id":"PROD-1004"},{"name":"Banking","tags":{"tag":[{"name":"FAQs","id":"PROD-2196"}]},"id":"PROD-1014"}]}],"id":"PROD-5520"},{"name":"Customers","id":"PROD-5521"}]}},"id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/200/content/application~1json/example"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/400/content/application~1json/examples/Invalid Article Id":{"value":{"code":"400-108","developerMessage":"Invalid path parameter value: '0'. A numeric or a readable ID is expected."},"key":"Invalid Article Id","summary":"Invalid Article Id","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/400/content/application~1json/examples/Invalid Article Id"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/400/content/application~1json/examples/Invalid Portal Id":{"value":{"code":"400-105","developerMessage":"Invalid query parameter value: '0'. A positive integer is expected."},"key":"Invalid Portal Id","summary":"Invalid Portal Id","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/400/content/application~1json/examples/Invalid Portal Id"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/400/content/application~1json/examples/Invalid workflow milestone":{"value":{"code":"400-102","developerMessage":"Unsupported value for query parameter 'workflowMilestone'. Only the following values are supported: 'publish,staging,authoring'."},"key":"Invalid workflow milestone","summary":"Invalid workflow milestone","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/400/content/application~1json/examples/Invalid workflow milestone"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/400/content/application~1json/examples/Invalid $lang":{"value":{"code":"400-1132","developerMessage":"KB language sample_language is not available in the system."},"key":"Invalid $lang","summary":"Invalid $lang","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/400/content/application~1json/examples/Invalid $lang"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/401/content/application~1json/example":{"value":{"code":"401-101","developerMessage":"Invalid or expired 'X-egain-session' header provided. New login is required."},"id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/401/content/application~1json/example"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/403/content/application~1json/examples/User Not Allowed":{"value":{"code":"403-105","developerMessage":"User is not allowed to perform this action."},"key":"User Not Allowed","summary":"User Not Allowed","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/403/content/application~1json/examples/User Not Allowed"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/403/content/application~1json/examples/Customer Not Allowed on Portal":{"value":{"code":"403-568","developerMessage":"Portal 999900000000000 does not allow customer access."},"key":"Customer Not Allowed on Portal","summary":"Customer Not Allowed on Portal","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/403/content/application~1json/examples/Customer Not Allowed on Portal"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/403/content/application~1json/examples/Milestone not assigned":{"value":{"code":"403-193","developerMessage":"Article milestone staging is not assigned to user"},"key":"Milestone not assigned","summary":"Milestone not assigned","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/403/content/application~1json/examples/Milestone not assigned"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/403/content/application~1json/examples/Personalization disabled":{"value":{"code":"403-9007","developerMessage":"Personalisation is currently disabled on this setup."},"key":"Personalization disabled","summary":"Personalization disabled","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/403/content/application~1json/examples/Personalization disabled"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/404/content/application~1json/examples/Portal Id Not Found":{"value":{"code":"404-470","developerMessage":"The following IDs supplied in the URI path were not found: '999900000012345'"},"key":"Portal Id Not Found","summary":"Portal Id Not Found","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/404/content/application~1json/examples/Portal Id Not Found"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/404/content/application~1json/examples/Article Id Not Found":{"value":{"code":"404-470","developerMessage":"The following IDs supplied in the URI path were not found: '409600000012345'"},"key":"Article Id Not Found","summary":"Article Id Not Found","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/404/content/application~1json/examples/Article Id Not Found"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/406/content/application~1json/example":{"value":{"code":"406-100","developerMessage":"Invalid Accept-Language header value."},"id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/406/content/application~1json/example"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/500/content/application~1json/example":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1personalization/get/responses/500/content/application~1json/example"},"paths/~1portals~1{portalID}~1articlelists/get/responses/200/content/application~1json/example":{"value":{"articleList":[{"name":"New Articles","typeId":"10","description":"Recently added articles in KB","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/articlelists/1003?%24lang=en-US"},"id":"PROD-1003"},{"name":"Updated Articles","typeId":"11","description":"Recently  changed articles in KB","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/articlelists/1004?%24lang=en-US"},"id":"PROD-1004"},{"name":"Lending","typeId":"50","description":"Lending related articles in KB","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/articlelists/PROD-3258?%24lang=en-US"},"id":"PROD-3258"}]},"id":"paths/~1portals~1{portalID}~1articlelists/get/responses/200/content/application~1json/example"},"paths/~1portals~1{portalID}~1articlelists/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1articlelists/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1articlelists/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1articlelists/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1articlelists/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1articlelists/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1articlelists/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1articlelists/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1articlelists/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1articlelists/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1articlelists/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1articlelists/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1articlelists/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1articlelists/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/200/content/application~1json/examples/Summary Attributes":{"value":{"name":"Lending","typeId":"50","description":"Lending related articles in KB","articles":[{"id":"PROD-3002","name":"Fair Lending","articleType":{"id":0,"typeName":"General","useStructuredAuthoring":false},"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-06-30T18:25:22Z","hasAttachments":false,"languageCode":"en-US","modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2025-01-28T20:58:11Z","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/articles/PROD-3002?%&workflowMilestone=publish&filter%5Btags%5D=PROD-5381&%24lang=en-US"},"versionId":"PROD-2897"}],"link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/articlelists/PROD-3258?%24lang=en-US"},"id":"PROD-3258"},"key":"Summary Attributes","summary":"Summary Attributes","id":"paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/200/content/application~1json/examples/Summary Attributes"},"paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/200/content/application~1json/examples/All Attributes":{"value":{"name":"Lending","typeId":"50","description":"Lending related articles in KB","articles":[{"id":"PROD-3002","name":"Fair Lending","articleSummary":"Fair lending ensures that lenders do not discriminate based on race, color, national origin, religion, sex, familial status, or disability when offering residential mortgage loans, guaranteeing equal opportunities for all. The Office of Fair Housing and Equal Opportunity enforces the federal Fair Housing Act, with state and local agencies ensuring similar protections. Additional laws, such as the Equal Credit Opportunities Act, also safeguard your rights. For more information, visit the U.S. Department of Housing and Urban Development website.","articleType":{"id":0,"typeName":"General","useStructuredAuthoring":false},"averageRating":0,"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe","userName":"jdoe"},"createdDate":"2022-06-30T18:25:22Z","description":"Article detailing Fair Lending.","hasAttachments":false,"imageURL":"","isSubscribed":false,"languageCode":"en-US","modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe","userName":"jdoe"},"modifiedDate":"2025-01-28T20:58:11Z","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/articles/PROD-3002?%articleResultAdditionalAttributes=all&workflowMilestone=publish&filter%5Btags%5D=PROD-5381&%24lang=en-US"},"ownedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe","userName":"jdoe"},"timesRated":0,"topicBreadcrumb":[{"topicSummary":[{"name":"Banking Regulations","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/topics/PROD-1080"}}]}],"customAttributes":[],"versionId":"PROD-2897","workflow":{"stages":[{"name":"publish","milestone":{"name":{"value":"publish","displayValue":"Published"}}}]}}],"link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/articlelists/PROD-3258?%24lang=en-US"},"id":"PROD-3258"},"key":"All Attributes","summary":"All Attributes","id":"paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/200/content/application~1json/examples/All Attributes"},"paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1articlelists~1{listID}/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1bookmarks/post/requestBody/content/application~1json/examples/Bookmark Topic With Bookmark Name Provided":{"value":{"resourceId":"PROD-9274782","resourceType":2,"bookmarkName":"DemoBookmark"},"key":"Bookmark Topic With Bookmark Name Provided","summary":"Bookmark Topic With Bookmark Name Provided","id":"paths/~1portals~1{portalID}~1bookmarks/post/requestBody/content/application~1json/examples/Bookmark Topic With Bookmark Name Provided"},"paths/~1portals~1{portalID}~1bookmarks/post/requestBody/content/application~1json/examples/Bookmark Article Without Bookmark Name":{"value":{"resourceId":"PROD-9296739"},"key":"Bookmark Article Without Bookmark Name","summary":"Bookmark Article Without Bookmark Name","id":"paths/~1portals~1{portalID}~1bookmarks/post/requestBody/content/application~1json/examples/Bookmark Article Without Bookmark Name"},"paths/~1portals~1{portalID}~1bookmarks/post/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1bookmarks/post/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1bookmarks/post/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1bookmarks/post/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1bookmarks/post/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1bookmarks/post/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1bookmarks/post/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1bookmarks/post/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1bookmarks/post/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1bookmarks/post/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1bookmarks/post/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1bookmarks/post/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1bookmarks/post/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1bookmarks/post/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1bookmarks/get/responses/200/content/application~1json/examples/Summary Attributes":{"value":{"bookmark":[{"resourceId":"PROD-2996","resourceType":1,"portalId":"PROD-1000","resourceName":"Fair Lending FAQs","bookmarkName":"","externalContentId":"","id":1002}],"paginationInfo":{"count":1,"pagenum":1,"pagesize":10}},"key":"Summary Attributes","summary":"Summary Attributes","id":"paths/~1portals~1{portalID}~1bookmarks/get/responses/200/content/application~1json/examples/Summary Attributes"},"paths/~1portals~1{portalID}~1bookmarks/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1bookmarks/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1bookmarks/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1bookmarks/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1bookmarks/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1bookmarks/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1bookmarks/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1bookmarks/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1bookmarks/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1bookmarks/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1bookmarks/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1bookmarks/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1bookmarks/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1bookmarks/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1bookmarks~1{bookmarkID}/delete/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/200/content/application~1json/example":{"value":{"casebase":[{"name":"Financial Vertical Bot","id":"202201000000002","status":"live","casebaseId":"202201000000002","profiles":[{"profile":[{"name":"system profile","id":"100100000000001"}]}],"languages":{"kbLanguage":[{"name":"English (US)","code":"en-US"}]},"link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/gh/casebasereleases/202201000000002?%24lang=en-US"}}],"paginationInfo":{"count":1,"pagenum":1,"pagesize":10}},"id":"paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/200/content/application~1json/example"},"paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/200/content/application~1json/example":{"value":{"casebase":[{"name":"Financial Vertical Bot","id":"202201000000002","status":"author","casebaseId":"202201000000002","profiles":[{"profile":[{"name":"system profile","id":"100100000000001"}]}],"languages":{"kbLanguage":[{"name":"English (US)","code":"en-US"}]},"link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/gh/casebasereleases/202201000000002?%24lang=en-US"}},{"name":"Live","id":"202201000000005","status":"live","casebaseId":"202201000000002","profiles":[{"profile":[{"name":"system profile","id":"100100000000001"}]}],"languages":{"kbLanguage":[{"name":"English (US)","code":"en-US"}]},"link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/gh/casebasereleases/202201000000005?%24lang=en-US"}}]},"id":"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/200/content/application~1json/example"},"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/412/content/application~1json/examples/Precondition Failed":{"value":{"code":"412-100","developerMessage":"Precondition failed: <prerequisite requirement>."},"key":"Precondition Failed","summary":"Precondition Failed","description":"A prerequisite condition for this request has not been met.\n","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/412/content/application~1json/examples/Precondition Failed"},"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/200/content/application~1json/example":{"value":{"cluster":[{"name":"Root Cluster","depth":0,"shortName":"Root Cluster","startup":false,"id":"1000000257"},{"name":"","depth":1,"shortName":"C1:Process the Intent","startup":true,"id":"1000000258"},{"name":"","depth":2,"shortName":"C2:High Intent Confidence","startup":false,"id":"1000000259"},{"name":"","depth":3,"shortName":"C3:Medium Intent Confidence","startup":false,"id":"1000000260"},{"name":"","depth":4,"shortName":"C13: Low Confidence Intent","startup":false,"id":"1000002133"},{"name":"","depth":1,"shortName":"C4: Chat Escalation","startup":false,"id":"1000000261"},{"name":"Online Banking","depth":1,"shortName":"C7","startup":false,"id":"1000000401"},{"name":"Membership","depth":1,"shortName":"C6","startup":false,"id":"1000000402"},{"name":"Checking and Savings Accounts","depth":1,"shortName":"C8","startup":false,"id":"1000000403"},{"name":"Debit Card","depth":1,"shortName":"C9","startup":false,"id":"1000000404"}],"paginationInfo":{"count":13,"pagenum":1,"pagesize":10,"link":[{"rel":"next","href":"/knowledge/portalmgr/v4/portals/PROD-1000/gh/casebasereleases/202201000000002/clusters&$pagenum=2&$pagesize=10"}]}},"id":"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/200/content/application~1json/example"},"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1gh~1profiles/get/responses/200/content/application~1json/example":{"value":{"profile":[{"name":"system profile","id":"100100000000001"}],"paginationInfo":{"count":1,"pagenum":1,"pagesize":10}},"id":"paths/~1portals~1{portalID}~1gh~1profiles/get/responses/200/content/application~1json/example"},"paths/~1portals~1{portalID}~1gh~1profiles/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1gh~1profiles/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1gh~1profiles/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1gh~1profiles/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1gh~1profiles/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1gh~1profiles/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1gh~1profiles/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1gh~1profiles/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1gh~1profiles/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1gh~1profiles/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1gh~1profiles/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1gh~1profiles/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1gh~1profiles/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1gh~1profiles/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1gh~1search/post/requestBody/content/application~1json/examples/Start Search With Casebase":{"value":{"casebaseId":"202201000000002"},"key":"Start Search With Casebase","summary":"Start Search With Casebase","id":"paths/~1portals~1{portalID}~1gh~1search/post/requestBody/content/application~1json/examples/Start Search With Casebase"},"paths/~1portals~1{portalID}~1gh~1search/post/requestBody/content/application~1json/examples/Start Search With GHS ArticleId":{"value":{"casebaseId":"202201000000002","ghsArticleId":"123456000000000"},"key":"Start Search With GHS ArticleId","summary":"Start Search With GHS ArticleId","id":"paths/~1portals~1{portalID}~1gh~1search/post/requestBody/content/application~1json/examples/Start Search With GHS ArticleId"},"paths/~1portals~1{portalID}~1gh~1search/post/responses/200/content/application~1json/example":{"value":{"casebase":{"name":"Financial Vertical Bot","status":"author","casebaseId":"202201000000002","profiles":[{"profile":[{"name":"system profile","id":"100100000000001"}]}],"id":"202201000000002","searchSettings":{"closeSessionOnAccept":true,"closeSessionOnReject":true}},"actionSearch":[],"answeredQuestion":[],"caseSearch":[],"dynamicSearch":[],"unansweredQuestion":[{"title":"[ML]Label Confidence","type":"enumerated","format":"dropdown","shortName":"ML1","hasAdditionalInfo":true,"hasAction":true,"validAnswer":[{"depth":1,"isInvisible":false,"text":"HIGH","id":"1000000303"},{"depth":1,"isInvisible":false,"text":"MEDIUM","id":"1000000304"},{"depth":1,"isInvisible":false,"text":"LOW","id":"1000000305"},{"depth":1,"isInvisible":false,"text":"NA","id":"1000000306"}],"metadata":[{"title":"","additionalInformation":"","action":""}],"customAttribute":[],"id":"1000000322"},{"title":"[ML]Label","type":"enumerated","format":"dropdown","shortName":"Classifier","hasAdditionalInfo":true,"hasAction":true,"validAnswer":[{"depth":1,"isInvisible":false,"text":"None","id":"1000000272"},{"depth":1,"isInvisible":false,"text":"Membership","id":"1000000842"},{"depth":1,"isInvisible":false,"text":"Online Banking","id":"1000000843"},{"depth":1,"isInvisible":false,"text":"Checking and Savings","id":"1000000844"},{"depth":1,"isInvisible":false,"text":"Debit Card","id":"1000000845"},{"depth":1,"isInvisible":false,"text":"Credit Card","id":"1000000846"},{"depth":1,"isInvisible":false,"text":"Loans","id":"1000000847"},{"depth":1,"isInvisible":false,"text":"Something Else","id":"1000000848"},{"depth":1,"isInvisible":false,"text":"Chat with an Agent","id":"1000002048"}],"metadata":[{"title":"","additionalInformation":"","action":""}],"customAttribute":[],"id":"1000000327"}],"startupQuestion":[{"title":"[ML]Label Confidence","type":"enumerated","format":"dropdown","shortName":"ML1","hasAdditionalInfo":true,"hasAction":true,"validAnswer":[{"depth":1,"isInvisible":false,"text":"HIGH","id":"1000000303"},{"depth":1,"isInvisible":false,"text":"MEDIUM","id":"1000000304"},{"depth":1,"isInvisible":false,"text":"LOW","id":"1000000305"},{"depth":1,"isInvisible":false,"text":"NA","id":"1000000306"}],"metadata":[{"title":"","additionalInformation":"","action":""}],"customAttribute":[],"id":"1000000322"},{"title":"[ML]Label","type":"enumerated","format":"dropdown","shortName":"Classifier","hasAdditionalInfo":true,"hasAction":true,"validAnswer":[{"depth":1,"isInvisible":false,"text":"None","id":"1000000272"},{"depth":1,"isInvisible":false,"text":"Membership","id":"1000000842"},{"depth":1,"isInvisible":false,"text":"Online Banking","id":"1000000843"},{"depth":1,"isInvisible":false,"text":"Checking and Savings","id":"1000000844"},{"depth":1,"isInvisible":false,"text":"Debit Card","id":"1000000845"},{"depth":1,"isInvisible":false,"text":"Credit Card","id":"1000000846"},{"depth":1,"isInvisible":false,"text":"Loans","id":"1000000847"},{"depth":1,"isInvisible":false,"text":"Something Else","id":"1000000848"},{"depth":1,"isInvisible":false,"text":"Chat with an Agent","id":"1000002048"}],"metadata":[{"title":"","additionalInformation":"","action":""}],"customAttribute":[],"id":"1000000327"}],"targetClusters":[{"id":"1000000258"}]},"id":"paths/~1portals~1{portalID}~1gh~1search/post/responses/200/content/application~1json/example"},"paths/~1portals~1{portalID}~1gh~1search/post/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1gh~1search/post/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1gh~1search/post/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1gh~1search/post/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1gh~1search/post/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1gh~1search/post/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1gh~1search/post/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1gh~1search/post/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1gh~1search/post/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1gh~1search/post/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1gh~1search/post/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1gh~1search/post/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1gh~1search/post/responses/429/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-113","developerMessage":"The Suggestion you are trying to delete has been approved and cannot be removed."},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"The resource cannot be deleted.","id":"paths/~1portals~1{portalID}~1gh~1search/post/responses/429/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1gh~1search/post/responses/429/content/application~1json/examples/Too Many Request":{"value":{"code":"429-001","developerMessage":"Too many requests."},"key":"Too Many Request","summary":"Too Many Request","description":"Too many requests. Try again at a later time.\n","id":"paths/~1portals~1{portalID}~1gh~1search/post/responses/429/content/application~1json/examples/Too Many Request"},"paths/~1portals~1{portalID}~1gh~1search/post/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1gh~1search/post/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1gh~1search/put/requestBody/content/application~1json/examples/PerformStepWithGHSearch":{"value":{"casebaseId":"202201000000002","questions":[{"id":"1000000322","answers":[{"id":"1000000303"}]},{"id":"1000000327","answers":[{"id":"1000000842"}]},{"id":"1000001006","answers":[{"id":"1000001001"}]}],"useLiveRelease":true},"key":"PerformStepWithGHSearch","summary":"PerformStepWithGHSearch","id":"paths/~1portals~1{portalID}~1gh~1search/put/requestBody/content/application~1json/examples/PerformStepWithGHSearch"},"paths/~1portals~1{portalID}~1gh~1search/put/responses/200/content/application~1json/example":{"value":{"casebase":{"name":"Financial Vertical Bot","status":"author","casebaseId":"202201000000002","profiles":[{"profile":[{"name":"system profile","id":"100100000000001"}]}],"id":"202201000000002","searchSettings":{"closeSessionOnAccept":true,"closeSessionOnReject":true}},"actionSearch":[{"acceptCount":0,"additionalInfo":true,"metadata":[{"title":"","additionalInformation":"","action":"<?xml version=\"1.0\" encoding=\"UTF-8\"?>\r\n<iAutomatedAction><iContextSwitchCommandList><iContextSwitchAdd><iTargetClusterIdList><iId>1000000259</iId></iTargetClusterIdList></iContextSwitchAdd></iContextSwitchCommandList></iAutomatedAction>"}],"articleId":"","caseId":"1000000332","passedThreshold":true,"rejectCount":0,"score":100,"type":"control","articleTypeAttributes":{"typeName":"General","useStructuredAuthoring":false},"id":"1000000265"},{"acceptCount":0,"additionalInfo":true,"metadata":[{"title":"","additionalInformation":"","action":"<?xml version=\"1.0\" encoding=\"UTF-8\"?>\r\n<iAutomatedAction><iContextSwitchCommandList><iContextSwitchAdd><iTargetClusterIdList><iId>1000000402</iId></iTargetClusterIdList></iContextSwitchAdd></iContextSwitchCommandList></iAutomatedAction>"}],"articleId":"","caseId":"1000000864","passedThreshold":true,"rejectCount":0,"score":100,"type":"control","articleTypeAttributes":{"typeName":"General","useStructuredAuthoring":false},"id":"1000000834"},{"acceptCount":0,"additionalInfo":true,"metadata":[{"title":"","additionalInformation":"","action":"<p>For more information about all of the great benefits of becoming a [Sample Company Name] member, visit Member Benefits via [Sample Link to Account]. You can also connect with a customer service representative via [Sample Main Customer Support Phone Number], our regular business hours are [Insert Customer Hours].</p>"}],"articleId":"PROD-2827","alternateId":"PROD-2827","caseId":"1000001087","passedThreshold":true,"rejectCount":0,"shortName":"Member Benefits Information","score":100,"type":"article","articleTypeAttributes":{"typeName":"General","useStructuredAuthoring":false},"id":"1000001086"}],"answeredQuestion":[{"title":"What about your membership do you want to learn more about?","type":"enumerated","format":"dropdown","shortName":"Q002 - What about membership?","hasAdditionalInfo":false,"hasAction":false,"previousAnswer":[{"depth":-1,"isInvisible":false,"text":"Benefits of Membership","id":"1000001001"}],"validAnswer":[{"depth":1,"isInvisible":false,"text":"Becoming a Member","id":"1000001000"},{"depth":1,"isInvisible":false,"text":"Benefits of Membership","id":"1000001001"},{"depth":1,"isInvisible":false,"text":"Discontinuing Membership","id":"1000001002"}],"metadata":[{"title":"","additionalInformation":"","action":""}],"customAttribute":[],"answerSource":"user","id":"1000001006"},{"title":"[ML]Label","type":"enumerated","format":"dropdown","shortName":"Classifier","hasAdditionalInfo":false,"hasAction":false,"previousAnswer":[{"depth":-1,"isInvisible":false,"text":"Membership","id":"1000000842"}],"validAnswer":[{"depth":1,"isInvisible":false,"text":"None","id":"1000000272"},{"depth":1,"isInvisible":false,"text":"Membership","id":"1000000842"},{"depth":1,"isInvisible":false,"text":"Online Banking","id":"1000000843"},{"depth":1,"isInvisible":false,"text":"Checking and Savings","id":"1000000844"},{"depth":1,"isInvisible":false,"text":"Debit Card","id":"1000000845"},{"depth":1,"isInvisible":false,"text":"Credit Card","id":"1000000846"},{"depth":1,"isInvisible":false,"text":"Loans","id":"1000000847"},{"depth":1,"isInvisible":false,"text":"Something Else","id":"1000000848"},{"depth":1,"isInvisible":false,"text":"Chat with an Agent","id":"1000002048"}],"action":[{"type":"article","shortName":"AnswerAs label","rejectCount":0,"articleId":"202200000002790","acceptCount":0,"metadata":[{"title":"","additionalInformation":"","action":"{    \"function\": \"auto-answer\",\n    \"var-name\": \"label\",\n    \"action\": {\n        \"action-type\": \"\",\n        \"name\": \"\",\n        \"_comment\": \"modify the number and type of parameters below to match the arguments that you want to pass to the data link\",\n        \"parameters\": []\n    }\n}"}]}],"metadata":[{"title":"","additionalInformation":"","action":""}],"customAttribute":[],"answerSource":"user","id":"1000000327"},{"title":"[ML]Label Confidence","type":"enumerated","format":"dropdown","shortName":"ML1","hasAdditionalInfo":false,"hasAction":false,"previousAnswer":[{"depth":-1,"isInvisible":false,"text":"HIGH","id":"1000000303"}],"validAnswer":[{"depth":1,"isInvisible":false,"text":"HIGH","id":"1000000303"},{"depth":1,"isInvisible":false,"text":"MEDIUM","id":"1000000304"},{"depth":1,"isInvisible":false,"text":"LOW","id":"1000000305"},{"depth":1,"isInvisible":false,"text":"NA","id":"1000000306"}],"metadata":[{"title":"","additionalInformation":"","action":""}],"customAttribute":[],"answerSource":"user","id":"1000000322"}],"caseSearch":[{"acceptCount":0,"action":[{"type":"article","shortName":"Member Benefits Information","rejectCount":0,"articleId":"202200000002827","acceptCount":0,"metadata":[{"title":"","additionalInformation":"","action":"<p>For more information about all of the great benefits of becoming a [Sample Company Name] member, visit Member Benefits via [Sample Link to Account]. You can also connect with a customer service representative via [Sample Main Customer Support Phone Number], our regular business hours are [Insert Customer Hours].</p>"}]}],"additionalInfo":false,"metadata":[],"passedThreshold":true,"rejectCount":0,"score":100,"shortName":"Case56","title":"Member Benefits Information","id":"1000001087"}],"dynamicSearch":[],"unansweredQuestion":[],"startupQuestion":[],"targetClusters":[{"id":"1000000258"},{"id":"1000000259"},{"id":"1000000402"}]},"id":"paths/~1portals~1{portalID}~1gh~1search/put/responses/200/content/application~1json/example"},"paths/~1portals~1{portalID}~1gh~1search/put/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1gh~1search/put/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1gh~1search/put/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1gh~1search/put/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1gh~1search/put/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1gh~1search/put/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1gh~1search/put/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1gh~1search/put/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1gh~1search/put/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1gh~1search/put/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1gh~1search/put/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1gh~1search/put/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1gh~1search/put/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1gh~1search/put/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/200/content/application~1json/example":{"value":{"case":[{"shortName":"Case55","title":"Becoming a Member","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/gh/casebasereleases/202201000000002/cases/1000001085?%24lang=en-US"},"id":"1000001085"},{"shortName":"Case56","title":"Member Benefits Information","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/gh/casebasereleases/202201000000002/cases/1000001087?%24lang=en-US"},"id":"1000001087"},{"shortName":"Case57","title":"How to Discontinue Membership","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/gh/casebasereleases/202201000000002/cases/1000001089?%24lang=en-US"},"id":"1000001089"}],"paginationInfo":{"count":3,"pagenum":1,"pagesize":10}},"id":"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/200/content/application~1json/example"},"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1clusters~1{clusterID}~1cases/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/200/content/application~1json/examples/Summary Attribute":{"value":{"shortName":"Case55","title":"Becoming a Member","acceptCount":0,"rejectCount":0,"comments":"","profileId":"1","releaseId":"202201000000002","clusterId":"1000000402","isVisible":true,"thresholdValue":50,"thresholdType":"Default","caseType":"Content","createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-06-26T11:11:00Z","modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2022-06-26T11:11:00Z","thresholdValueFromCluster":90,"metadata":[{"title":"","additionalInformation":"","action":""}],"link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/gh/casebasereleases/202201000000002/cases/1000001085?%24lang=en-US"},"id":"1000001085"},"key":"Summary Attribute","summary":"Summary Attribute","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/200/content/application~1json/examples/Summary Attribute"},"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/200/content/application~1json/examples/All Attributes":{"value":{"shortName":"Case55","title":"Becoming a Member","acceptCount":0,"rejectCount":0,"comments":"","profileId":"1","releaseId":"202201000000002","clusterId":"1000000402","isVisible":true,"thresholdValue":50,"thresholdType":"Default","caseType":"Content","createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-06-26T11:11:00Z","modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2022-06-26T11:11:00Z","thresholdValueFromCluster":90,"action":[{"type":"2","shortName":"Becoming a Member","rejectCount":0,"articleId":"202200000002824","acceptCount":0,"annotation":[],"articleType":{"articleCategoryId":0,"typeName":"General","useStructuredAuthoring":false,"articleTypeId":"999500000002020"}}],"metadata":[{"title":"","additionalInformation":"","action":""}],"questionDetail":[{"question":{"id":"1000000322"},"answer":[{"text":"HIGH","id":"1000000303"}],"scoringValue":50},{"question":{"id":"1000000322"},"answer":[{"text":"HIGH","id":"1000000303"}],"scoringValue":50}],"link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/gh/casebasereleases/202201000000002/cases/1000001085?%24attribute=questionDetails%2Cactions%2Ccustom&%24lang=en-US"},"id":"1000001085"},"key":"All Attributes","summary":"All Attributes","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/200/content/application~1json/examples/All Attributes"},"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/412/content/application~1json/examples/Precondition Failed":{"value":{"code":"412-100","developerMessage":"Precondition failed: <prerequisite requirement>."},"key":"Precondition Failed","summary":"Precondition Failed","description":"A prerequisite condition for this request has not been met.\n","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/412/content/application~1json/examples/Precondition Failed"},"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1gh~1casebasereleases~1{casebaseReleaseID}~1cases~1{caseID}/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/requestBody/content/application~1json/example":{"value":{"id":"120000001201010","name":"HPE Solution Article","profileId":"120450120000001"},"id":"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/requestBody/content/application~1json/example"},"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/412/content/application~1json/examples/Precondition Failed":{"value":{"code":"412-100","developerMessage":"Precondition failed: <prerequisite requirement>."},"key":"Precondition Failed","summary":"Precondition Failed","description":"A prerequisite condition for this request has not been met.\n","id":"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/412/content/application~1json/examples/Precondition Failed"},"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1accept/post/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/requestBody/content/application~1json/example":{"value":{"id":"123101210000102","name":"HPE Solution Article","profileId":"100101210000002"},"id":"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/requestBody/content/application~1json/example"},"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/412/content/application~1json/examples/Precondition Failed":{"value":{"code":"412-100","developerMessage":"Precondition failed: <prerequisite requirement>."},"key":"Precondition Failed","summary":"Precondition Failed","description":"A prerequisite condition for this request has not been met.\n","id":"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/412/content/application~1json/examples/Precondition Failed"},"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1gh~1cases~1{caseID}~1reject/post/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1gh~1quickpicks/post/requestBody/content/application~1json/examples/Create Quickpick":{"value":{"casebaseReleaseId":"102312010000000","name":"QuickPick82700245","comment":"demo quickpick","linkToActivity":false},"key":"Create Quickpick","summary":"Create Quickpick","id":"paths/~1portals~1{portalID}~1gh~1quickpicks/post/requestBody/content/application~1json/examples/Create Quickpick"},"paths/~1portals~1{portalID}~1gh~1quickpicks/post/requestBody/content/application~1json/examples/Create Quickpick And Link With Activity":{"value":{"casebaseReleaseId":"123459870010120","name":"QuickPick8270033","comment":"demo quickpick","linkToActivity":true},"key":"Create Quickpick And Link With Activity","summary":"Create Quickpick And Link With Activity","id":"paths/~1portals~1{portalID}~1gh~1quickpicks/post/requestBody/content/application~1json/examples/Create Quickpick And Link With Activity"},"paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1gh~1quickpicks/post/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/200/content/application~1json/examples/Singular Quickpick":{"value":{"quickpick":[{"comment":"demo%20quickpick","name":"QuickPick82700245","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/gh/quickpicks/11?casebaseId=202201000000002&%24lang=en-US"},"id":"11","linkToActivity":false,"casebaseReleaseId":"202201000000002"}],"paginationInfo":{"count":1,"pagenum":1,"pagesize":10}},"key":"Singular Quickpick","summary":"Singular Quickpick","id":"paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/200/content/application~1json/examples/Singular Quickpick"},"paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/200/content/application~1json/examples/Multiple Quickpick":{"value":{"quickpick":[{"comment":"demo%20quickpick","name":"QuickPick82700245","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/gh/quickpicks/11?casebaseId=202201000000002&%24lang=en-US"},"id":"11","linkToActivity":false,"casebaseReleaseId":"202201000000002"},{"comment":"demo%20quickpick2","name":"QuickPick82700246","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/gh/quickpicks/11?casebaseId=202201000000002&%24lang=en-US"},"id":"11","linkToActivity":false,"casebaseReleaseId":"202201000000002"}],"paginationInfo":{"count":3,"pagenum":1,"pagesize":2,"link":[{"rel":"next","href":"/knowledge/portalmgr/v4/portals/PROD-1000/gh/quickpicks/11?casebaseId=202201000000002&%24lang=en-US&$pagesize=2&$pagenum=2"}]}},"key":"Multiple Quickpick","summary":"Multiple Quickpick","id":"paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/200/content/application~1json/examples/Multiple Quickpick"},"paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1gh~1quickpicks/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/200/content/application~1json/example":{"value":{"casebase":{"name":"Financial Vertical Bot","id":"202201000000002","status":"live","casebaseId":"202201000000002","profiles":[{"profile":[{"name":"system profile","id":"100100000000001"}]}]},"actionSearch":[{"acceptCount":0,"hasAdditionalInfo":true,"metadata":[],"caseId":"1000003892","passedThresholdValue":false,"rejectCount":0,"score":50,"type":"control"},{"acceptCount":0,"hasAdditionalInfo":true,"metadata":[],"articleId":"PROD-2202","caseId":"1000003897","passedThresholdValue":false,"rejectCount":0,"shortName":"Main Article","score":50,"type":"article","articleTypeAttributes":{"typeName":"General"}}],"answeredQuestion":[{"title":"Question 1","type":"list","format":"radioButton","hasAdditionalInfo":false,"hasAction":false,"previousAnswer":[{"depth":-1,"isInvisible":false,"text":"Benefits of Membership","id":"1000001001"}],"validAnswer":[{"depth":1,"isInvisible":false,"text":"yes","id":"1000003848"},{"depth":1,"isInvisible":false,"text":"no","id":"1000003849"}],"metadata":[],"customAttributes":[],"id":"100000385200000"}],"caseSearch":[{"acceptCount":0,"action":[],"additionalInfo":true,"metadata":[],"answeredQuestion":[],"passedThresholdValue":false,"rejectCount":0,"score":50,"shortName":"Case4","title":"Main Article","caseId":"1000003897"},{"acceptCount":0,"action":[],"additionalInfo":true,"metadata":[],"answeredQuestion":[],"passedThresholdValue":false,"rejectCount":0,"score":50,"shortName":"Case1","title":"Action","caseId":"1000003892"}],"dynamicSearch":[],"unansweredQuestion":[{"title":"Question 2","type":"list","format":"radioButton","shortName":"Q2","hasAdditionalInfo":true,"hasAction":false,"validAnswer":[{"depth":1,"isInvisible":false,"text":"yes","id":"1000003854"},{"depth":1,"isInvisible":false,"text":"no","id":"1000003855"}],"metadata":[],"customAttributes":[],"id":"100000385800000"}],"startupQuestion":[],"targetClusters":[{"id":"100000384300000"},{"id":"100000384400000"}]},"id":"paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/200/content/application~1json/example"},"paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1gh~1quickpicks~1{quickpickID}/post/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1populararticles/get/responses/200/content/application~1json/examples/Summary Attributes":{"value":{"articles":[{"id":"PROD-2996","name":"Fair Lending FAQs","createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-06-30T14:54:55Z","hasAttachments":true,"languageCode":"en-US","modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2025-01-28T19:53:58Z","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/articles/PROD-2996?filter%5Btopic%5D=PROD-1069&workflowMilestone=publish&%24lang=en-US"},"versionId":"PROD-2884"}],"paginationInfo":{"count":1,"pagenum":1,"pagesize":10}},"key":"Summary Attributes","summary":"Summary Attributes","id":"paths/~1portals~1{portalID}~1populararticles/get/responses/200/content/application~1json/examples/Summary Attributes"},"paths/~1portals~1{portalID}~1populararticles/get/responses/200/content/application~1json/examples/All Attributes":{"value":{"articles":[{"id":"PROD-2996","name":"Fair Lending FAQs","articleSummary":"Fair lending ensures that lenders do not discriminate based on race, color,national origin, religion, sex, familial status, or disability when applying forresidential mortgage loans. The federal Fair Housing Act protects individuals'fair lending rights, enforced by the Office of Fair Housing and Equal Opportunity,along with state and local agencies. This law applies to U.S. citizens, greencard holders, and undocumented residents, ensuring equal opportunities in homesales, rentals, and financing.","articleType":{"articleCategoryId":0,"typeName":"General","useStructuredAuthoring":false,"articleTypeId":"987600000002020"},"averageRating":0,"compliance":{"startDate":{"date":"2022-06-30T14:54:55Z"},"dueDate":{"date":"2025-07-30T14:54:55Z"}},"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe","userName":"jdoe"},"createdDate":"2022-06-30T14:54:55Z","description":"Common questions and answers regarding Fair Lending.","hasAttachments":true,"imageURL":"https://hd.egain.com/images/km-for-dummies-24.jpg","isSubscribed":true,"languageCode":"en-US","modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe","userName":"jdoe"},"modifiedDate":"2025-01-28T19:53:58Z","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/articles/PROD-2996?24articleResultAdditionalAttributes=all&filter%5Btopic%5D=PROD-1069&workflowMilestone=publish&%24lang=en-US"},"ownedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe","userName":"jdoe"},"timesRated":0,"topicBreadcrumb":[{"topicSummary":[{"name":"Banking Regulations","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/topics/PROD-1080"}}]}],"versionId":"PROD-2884","customAttributes":[],"workflow":{"stages":[{"name":"publish","milestone":{"name":{"value":"publish","displayValue":"Published"}}}]}}],"paginationInfo":{"count":1,"pagenum":1,"pagesize":10}},"key":"All Attributes","summary":"All Attributes","id":"paths/~1portals~1{portalID}~1populararticles/get/responses/200/content/application~1json/examples/All Attributes"},"paths/~1portals~1{portalID}~1populararticles/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1populararticles/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1populararticles/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1populararticles/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1populararticles/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1populararticles/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1populararticles/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1populararticles/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1populararticles/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1populararticles/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1populararticles/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1populararticles/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1populararticles/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1populararticles/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals/get/responses/200/content/application~1json/example":{"value":{"portal":[{"id":"PZ-9999","name":"Master Portal","departmentId":"999","description":"Automatically created portal allowing access to all published articles","defaultContentLanguageId":"1","defaultContentLanguageCode":"en-US","createdBy":{"id":"1004","firstName":"pa","middleName":"","lastName":"developer","userName":"pa_Developer"},"createdDate":"2022-03-09T00:22:14Z","modifiedBy":{"id":"1004","firstName":"pa","middleName":"","lastName":"developer","userName":"pa_Developer"},"modifiedDate":"2023-10-18T16:13:53Z","isStructuredAuthoringEnabled":false,"isManageDraftVisibilityEnabled":false,"portalSettings":{"isAnnoucementsEnabled":false,"isAgentsSSOEnabled":false,"isAgentsDelegatedAuthenticationEnabled":false,"isPopularArticlesListEnabled":false,"popularArticlesListInfluenceWeight":10,"popularArticlesListInfluencePeriod":1,"appendSessionJourneyToEmail":false,"isArticleSuggestionsBeforeEscalationEnabled":false,"isEscalationToEmailEnabled":false,"numberOfSuggestedArticlesBeforeEscalation":0,"isGHInSearchResultsEnabled":false,"webSearchDomain":"","intranetSearchURL":"","questionMatchingEngineURL":"","isCaptchaEnabled":false,"captchaSiteKey":"","isArticleSharingEnabled":false,"tagCategoriesForSearchFilter":{"tagCategory":[]},"maxWebSearchResults":5,"maxIntranetSearchResults":5,"isSearchAutocompleteEnabled":true,"isWebSearchEnabled":false,"isIntranetSearchEnabled":false,"isCustomAttributesFilteringEnabled":true,"isSpellcheckEnabled":true,"searchLearningInclusionThreshold":5,"searchLearningInfluence":0,"searchLearningMaxInfluence":300,"searchLearningLevel":0,"searchRelatedTermsMinResultsThreshold":10,"searchRelatedTermWeight":0.25,"customAttributesForSearchFilter":[],"isGHEnabled":false,"isGHStartupQuestionsBeforeUnansweredQuestionsEnabled":true,"isGHDetailsForSearchEnabled":false,"isGHShortNameInSearchEnabled":false,"GHFailureSuccessThreshold":0,"maxGHAnsweredQuestions":10,"maxGHUnansweredQuestions":10,"maxGHSearchResults":0,"isGHResultsShownOnSuccessfulSearch":false,"isGHControlActionDiagnosticsEnabled":false,"isGHClusterScopeDiagnosticsEnabled":false,"isRelatedArticlesEnabled":true,"isArticleFeedbackEnabled":true,"isArticleFeedbackCommentsEnabled":false,"isArticleFeedbackSummaryEnabled":false,"isRelatedArticlesInSameTopicEnabled":true,"isAuthenticationRequired":true,"isArticleSuggestionsEnabled":true,"isMySuggestionsEnabled":true,"customerProfileAttributes":{"attribute":[{"name":"firstName","mandatory":false,"editable":true},{"name":"lastName","mandatory":false,"editable":true},{"name":"emailAddress","mandatory":false,"editable":true}]}},"kbLanguages":{"kbLanguage":[{"name":"English (US)","code":"en-US"}]},"link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PZ-9999?departmentId=999&%24lang=en-US"}}],"paginationInfo":{"count":1,"pagenum":1,"pagesize":10}},"id":"paths/~1portals/get/responses/200/content/application~1json/example"},"paths/~1portals/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1myportals/get/responses/200/content/application~1json/examples/All Portal with only default Short URL":{"value":{"portal":[{"name":"Master Portal","description":"Automatically created portal allowing access to all published articles","department":{"name":"Service","id":"999"},"shortURL":[{"id":"PROD-1000","templateName":"silver","shortURLName":"9BAED8","isDefault":true}],"link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PZ-9999?filterText=master&department=service&shortUrlTemplate=silver&%24lang=en-US"},"id":"PZ-9999"}],"paginationInfo":{"count":1,"pagenum":1,"pagesize":25}},"key":"All Portal with only default Short URL","summary":"All Portal with only default Short URL","description":"By default, shortURL only contains single object","id":"paths/~1myportals/get/responses/200/content/application~1json/examples/All Portal with only default Short URL"},"paths/~1myportals/get/responses/200/content/application~1json/examples/All Portal with default~1non-default Short URL":{"value":{"portal":[{"id":"PROD-2278","name":"Support Portal","description":"Portal Description","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-2278"},"department":{"id":"999","name":"service"},"shortURL":[{"id":"PROD-1008","templateName":"silver","shortURLName":"XEMrao","isDefault":false}]},{"id":"PROD-2279","name":"Escalation Portal","description":"Portal Description","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-2279"},"department":{"id":"1005","name":"escalation"},"shortURL":[{"id":"PROD-1002","templateName":"silver","shortURLName":"XEMrao","isDefault":true},{"id":"PROD-1001","templateName":"silver","shortURLName":"XEMrap","isDefault":false}],"paginationInfo":{"count":6,"pagenum":2,"pagesize":2,"link":[{"rel":"prev","href":"/knowledge/portalmgr/v4/portals?$pagenum=1&$pagesize=2"},{"rel":"next","href":"/knowledge/portalmgr/v4/portals?$pagenum=3&$pagesize=2"}]}}]},"key":"All Portal with default/non-default Short URL","summary":"All Portal with default/non-default Short URL","description":"If shortUrlTemplate name is passed in parameter then shortURL might contains multiple objects","id":"paths/~1myportals/get/responses/200/content/application~1json/examples/All Portal with default~1non-default Short URL"},"paths/~1myportals/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1myportals/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1myportals/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1myportals/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1myportals/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1myportals/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1myportals/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1myportals/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1myportals/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1myportals/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1myportals/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1myportals/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1myportals/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1myportals/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}/get/responses/200/content/application~1json/example":{"value":{"id":"PZ-9999","name":"Master Portal","departmentId":"999","description":"Automatically created portal allowing access to all published articles","defaultContentLanguageId":"1","defaultContentLanguageCode":"en-US","createdBy":{"id":"1004","firstName":"pa","middleName":"","lastName":"developer","userName":"pa_Developer"},"createdDate":"2022-03-09T00:22:14Z","modifiedBy":{"id":"1004","firstName":"pa","middleName":"","lastName":"developer","userName":"pa_Developer"},"modifiedDate":"2023-10-18T16:13:53Z","isStructuredAuthoringEnabled":false,"isManageDraftVisibilityEnabled":false,"portalSettings":{"isAnnoucementsEnabled":false,"isAgentsSSOEnabled":false,"isAgentsDelegatedAuthenticationEnabled":false,"isPopularArticlesListEnabled":false,"popularArticlesListInfluenceWeight":10,"popularArticlesListInfluencePeriod":1,"appendSessionJourneyToEmail":false,"isArticleSuggestionsBeforeEscalationEnabled":false,"isEscalationToEmailEnabled":false,"numberOfSuggestedArticlesBeforeEscalation":0,"isGHInSearchResultsEnabled":false,"webSearchDomain":"","intranetSearchURL":"","questionMatchingEngineURL":"","isCaptchaEnabled":false,"captchaSiteKey":"","isArticleSharingEnabled":false,"tagCategoriesForSearchFilter":{"tagCategory":[]},"maxWebSearchResults":5,"maxIntranetSearchResults":5,"isSearchAutocompleteEnabled":true,"isWebSearchEnabled":false,"isIntranetSearchEnabled":false,"isCustomAttributesFilteringEnabled":true,"isSpellcheckEnabled":true,"searchLearningInclusionThreshold":5,"searchLearningInfluence":0,"searchLearningMaxInfluence":300,"searchLearningLevel":0,"searchRelatedTermsMinResultsThreshold":10,"searchRelatedTermWeight":0.25,"customAttributesForSearchFilter":[],"isGHEnabled":false,"isGHStartupQuestionsBeforeUnansweredQuestionsEnabled":true,"isGHDetailsForSearchEnabled":false,"isGHShortNameInSearchEnabled":false,"GHFailureSuccessThreshold":0,"maxGHAnsweredQuestions":10,"maxGHUnansweredQuestions":10,"maxGHSearchResults":0,"isGHResultsShownOnSuccessfulSearch":false,"isGHControlActionDiagnosticsEnabled":false,"isGHClusterScopeDiagnosticsEnabled":false,"isRelatedArticlesEnabled":true,"isArticleFeedbackEnabled":true,"isArticleFeedbackCommentsEnabled":false,"isArticleFeedbackSummaryEnabled":false,"isRelatedArticlesInSameTopicEnabled":true,"isAuthenticationRequired":true,"isArticleSuggestionsEnabled":true,"isMySuggestionsEnabled":true,"customerProfileAttributes":{"attribute":[{"name":"firstName","mandatory":false,"editable":true},{"name":"lastName","mandatory":false,"editable":true},{"name":"emailAddress","mandatory":false,"editable":true}]}},"kbLanguages":{"kbLanguage":[{"name":"English (US)","code":"en-US"}]},"link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PZ-9999?departmentId=999&%24lang=en-US"}},"id":"paths/~1portals~1{portalID}/get/responses/200/content/application~1json/example"},"paths/~1portals~1{portalID}/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}/get/responses/412/content/application~1json/examples/Precondition Failed":{"value":{"code":"412-100","developerMessage":"Precondition failed: <prerequisite requirement>."},"key":"Precondition Failed","summary":"Precondition Failed","description":"A prerequisite condition for this request has not been met.\n","id":"paths/~1portals~1{portalID}/get/responses/412/content/application~1json/examples/Precondition Failed"},"paths/~1portals~1{portalID}/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/200/content/application~1json/example":{"value":{"tagCategory":[{"name":"Banking","tagGroup":[{"name":"Banking","tag":[{"name":"Buying a Home","id":"PROD-1016"},{"name":"Interest Rate","id":"PROD-1018"},{"name":"Checking and Savings Accounts","id":"PROD-1020"},{"name":"Loans","id":"PROD-1022"},{"name":"Credit and Debit Cards","id":"PROD-1024"},{"name":"Online Banking","id":"PROD-1756"},{"name":"Alerts","id":"PROD-1797"},{"name":"Claims","id":"PROD-1911"},{"name":"Applications and Forms","id":"PROD-2048"},{"name":"FAQs","id":"PROD-2196"}],"id":"PROD-2745"}],"tag":[{"name":"Banking Industry Regulations","id":"PROD-2930"},{"name":"Fees","id":"PROD-3809"},{"name":"Fair Lending","id":"PROD-5381"}],"id":"PROD-1014"}]},"id":"paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/200/content/application~1json/example"},"paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1tagcategoriesforinterest/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1{portalID}~1search/get/responses/200/content/application~1json/example":{"value":{"searchResults":{"article":[{"id":"PROD-2731","name":"What Does Loan Closing Mean?","docType":"HTML","source":"eGain Article","snippet":"Closing, generally, is when you sign your <span class=\"hc\" style=\"background: #FFFF00\">loan</span> documents and become obligated on the mortgage <span class=\"hc\" style=\"background: #FFFF00\">loan</span>, and, in a purchase transaction, when the seller signs documents to transfer you title to the property. The timing may depend on state laws and local practices.","keywordSnippet":"Closing, generally, is when you sign your <span class=\"hc\" style=\"background: #FFFF00\">loan</span> documents and become obligated on the mortgage <span class=\"hc\" style=\"background: #FFFF00\">loan</span>, and, in a purchase transaction, when the seller signs documents to transfer you title to the property. The timing may depend on state laws and local practices.","additionalSnippets":[],"additionalSnippetCount":0,"contextualSummary":"","modifiedDate":"2022-10-20T15:11:33.000Z","headerPath":"","topicBreadcrumb":[{"topicSummary":[{"name":"Loans","id":"PROD-1070"}]}],"tagCategories":[{"id":"PROD-1014","tags":["PROD-1022","PROD-2196"]}],"articleTypeAttributes":{"typeName":"General","articleTypeId":"100100000002020"},"normalizedScore":0.8953199783507835},{"id":"PROD-2680","name":"What Information Will I Need to Apply for a Loan?","docType":"HTML","source":"eGain Article","snippet":"Please have your personal information, annual income and any applicable collateral information available to apply.","keywordSnippet":"Please have your personal information, annual income and any applicable collateral information available to apply.","additionalSnippets":[],"additionalSnippetCount":0,"contextualSummary":"","modifiedDate":"2022-10-20T15:12:21.000Z","headerPath":"","topicBreadcrumb":[{"topicSummary":[{"name":"Loans","id":"PROD-1070"}]}],"tagCategories":[{"id":"PROD-1014","tags":["PROD-2196","PROD-1022"]}],"articleTypeAttributes":{"typeName":"General","articleTypeId":"100100000002020"},"normalizedScore":0.8881018533023683},{"id":"PROD-2679","name":"Can I have a Co-Signer?","docType":"HTML","source":"eGain Article","snippet":"...Yes, A Co-Signer is <span class=\"hc\" style=\"background-color: #FFFF00\">someone who agrees to be responsible for someone else’s debt</span>. If you cosign someone’s loan and that person doesn’t make payments on the loan or defaults, you’ll have to repay the l...","keywordSnippet":"","additionalSnippets":[{"id":"PROD-2679","name":"Can I have a Co-Signer?","docType":"HTML","snippet":"...Yes, A Co-Signer is <span class=\"hc\" style=\"background-color: #FFFF00\">someone who agrees to be responsible for someone else’s debt</span>. If you cosign someone’s loan and that person doesn’t make payments on the loan or defaults, you’ll have to repay the l...","keywordSnippet":"","normalizedScore":0.8472550848151883},{"id":"PROD-2679","name":"Can I have a Co-Signer?","docType":"HTML","snippet":"...Yes, A Co-Signer is <span class=\"hc\" style=\"background-color: #FFFF00\">someone who agrees to be responsible for someone else’s debt</span>. If you cosign someone’s loan and that person doesn’t make payments on the loan or defaults, you’ll have to repay the l...","keywordSnippet":"","normalizedScore":0.8472550848151883}],"additionalSnippetCount":2,"contextualSummary":"","modifiedDate":"2022-10-20T15:09:06.000Z","headerPath":"","topicBreadcrumb":[{"topicSummary":[{"name":"Loans","id":"PROD-1070"}]}],"tagCategories":[{"id":"PROD-1014","tags":["PROD-2196","PROD-1022"]}],"articleTypeAttributes":{"typeName":"General","articleTypeId":"100100000002020"},"normalizedScore":0.8485992046672263},{"id":"PROD-2681","name":"What is a Co-Signer? Requirements for a Co-Signer?","docType":"HTML","source":"eGain Article","snippet":"...A co-signer is <span class=\"hc\" style=\"background-color: #FFFF00\">a person who is obligated to pay back the loan</span> just as you, the borrower, are obligated to pay.","keywordSnippet":"","additionalSnippets":[],"additionalSnippetCount":0,"contextualSummary":"","modifiedDate":"2022-12-08T21:15:56.000Z","headerPath":"","topicBreadcrumb":[{"topicSummary":[{"name":"Loans","id":"PROD-1070"}]}],"tagCategories":[{"id":"PROD-1014","tags":["PROD-1022","PROD-2196"]}],"articleTypeAttributes":{"typeName":"General","articleTypeId":"100100000002020"},"normalizedScore":0.760438771174426},{"id":"PROD-2575","name":"Glossary of Terms","docType":"HTML","source":"eGain Article","snippet":"...Glossary of Terms A B C D E F G H I J K L M N O P Q R S T U V W X Y Z A Account A type of <span class=\"hc\" style=\"background-color: #FFFF00\">financial property or financial obligation that is held and owned under your name</span>. When you open a financial account—whether it’s a checking account, savings account, CD or money market accou...","keywordSnippet":"","additionalSnippets":[{"id":"PROD-2575","name":"Glossary of Terms","docType":"HTML","snippet":"...Glossary of Terms A B C D E F G H I J K L M N O P Q R S T U V W X Y Z A Account A type of <span class=\"hc\" style=\"background-color: #FFFF00\">financial property or financial obligation that is held and owned under your name</span>. When you open a financial account—whether it’s a checking account, savings account, CD or money market accou...","keywordSnippet":"","normalizedScore":0.7319947071366003},{"id":"PROD-2575","name":"Glossary of Terms","docType":"HTML","snippet":"...Glossary of Terms A B C D E F G H I J K L M N O P Q R S T U V W X Y Z A Account A type of <span class=\"hc\" style=\"background-color: #FFFF00\">financial property or financial obligation that is held and owned under your name</span>. When you open a financial account—whether it’s a checking account, savings account, CD or money market accou...","keywordSnippet":"","normalizedScore":0.7312969754401869},{"id":"PROD-2575","name":"Glossary of Terms","docType":"HTML","snippet":"...pay it back later. <span class=\"hc\" style=\"background-color: #FFFF00\">Deposit Funds added to your account. Direct deposit An automatic deposit to your account made by your employer or an outside agency (such as a pension or government benefit payment). These are usually recurring and spare you the hassle of depositing a paper check</span>. Online transfers ...","keywordSnippet":"","normalizedScore":0.590190242899371},{"id":"PROD-2575","name":"Glossary of Terms","docType":"HTML","snippet":"...e checks and make deposits into the same shared account. M Maturity date This is the date of expiration for the contractual obligation of a <span class=\"hc\" style=\"background-color: #FFFF00\">financial instrument</span>. For example, certificates of deposit have a maturity date that depends on the length of the CD term. When the CD matures, you have the opt...","keywordSnippet":"","normalizedScore":0.5901298016434594},{"id":"PROD-2575","name":"Glossary of Terms","docType":"HTML","snippet":"...e checks and make deposits into the same shared account. M Maturity date This is the date of expiration for the contractual obligation of a <span class=\"hc\" style=\"background-color: #FFFF00\">financial instrument</span>. For example, certificates of deposit have a maturity date that depends on the length of the CD term. When the CD matures, you have the opt...","keywordSnippet":"","normalizedScore":0.5901298016434594}],"additionalSnippetCount":5,"contextualSummary":"","modifiedDate":"2022-10-20T15:04:42.000Z","headerPath":"","topicBreadcrumb":[{"topicSummary":[{"name":"Using Online Banking","id":"PROD-1072"}]}],"tagCategories":[{"id":"PROD-1014","tags":["PROD-2196"]}],"articleTypeAttributes":{"typeName":"General","articleTypeId":"100100000002020"},"normalizedScore":0.7319947071366003},{"id":"PROD-2732","name":"What is The Amortization Period?","docType":"HTML","source":"eGain Article","snippet":"...This is <span class=\"hc\" style=\"background-color: #FFFF00\">the repayment period</span> of a loan during which payments of both principal and interest are required to be made to pay down the balance on the loan according to the...","keywordSnippet":"","additionalSnippets":[{"id":"PROD-2732","name":"What is The Amortization Period?","docType":"HTML","snippet":"...This is <span class=\"hc\" style=\"background-color: #FFFF00\">the repayment period</span> of a loan during which payments of both principal and interest are required to be made to pay down the balance on the loan according to the...","keywordSnippet":"","normalizedScore":0.6721146426033902}],"additionalSnippetCount":1,"contextualSummary":"","modifiedDate":"2022-10-20T15:13:19.000Z","headerPath":"","topicBreadcrumb":[{"topicSummary":[{"name":"Loans","id":"PROD-1070"}]}],"tagCategories":[{"id":"PROD-1014","tags":["PROD-2196","PROD-1022"]}],"articleTypeAttributes":{"typeName":"General","articleTypeId":"100100000002020"},"normalizedScore":0.6721146426033902},{"id":"PROD-2615","name":"Talk to a Banker - Home Loans","docType":"HTML","source":"eGain Article","snippet":"Whether you have questions about buying or refinancing a home, applying for or paying off a mortgage or home equity line of credit, or how the home lending process works in general, we've got answers.\nMake an appointment with a [Sample Company Name] Bank today by visiting [Sample Website Address]...","keywordSnippet":"Whether you have questions about buying or refinancing a home, applying for or paying off a mortgage or home equity line of credit, or how the home lending process works in general, we've got answers.\nMake an appointment with a [Sample Company Name] Bank today by visiting [Sample Website Address]...","additionalSnippets":[],"additionalSnippetCount":0,"contextualSummary":"","modifiedDate":"2022-12-08T21:15:34.000Z","headerPath":"","topicBreadcrumb":[{"topicSummary":[{"name":"Loans","id":"PROD-1070"}]}],"tagCategories":[{"id":"PROD-1014","tags":["PROD-1022"]}],"articleTypeAttributes":{"typeName":"General","articleTypeId":"100100000002020"},"normalizedScore":0.45921719114211856},{"id":"PROD-2997","name":"Discriminitatory Lending Practices","docType":"HTML","source":"eGain Article","snippet":"<span class=\"hc\" style=\"background: #FFFF00\">What</span> are some of the warning signs of lending discrimination?\nThe signs of lending discrimination may be blatant or subtle. They can occur in the marketing of mortgage <span class=\"hc\" style=\"background: #FFFF00\">loan</span> products, mortgage <span class=\"hc\" style=\"background: #FFFF00\">loan</span> transactions, terms and conditions of the <span class=\"hc\" style=\"background: #FFFF00\">loan</span>, in the appraisal of a home, and in <span class=\"hc\" style=\"background: #FFFF00\">loan</span> servicing.","keywordSnippet":"<span class=\"hc\" style=\"background: #FFFF00\">What</span> are some of the warning signs of lending discrimination?\nThe signs of lending discrimination may be blatant or subtle. They can occur in the marketing of mortgage <span class=\"hc\" style=\"background: #FFFF00\">loan</span> products, mortgage <span class=\"hc\" style=\"background: #FFFF00\">loan</span> transactions, terms and conditions of the <span class=\"hc\" style=\"background: #FFFF00\">loan</span>, in the appraisal of a home, and in <span class=\"hc\" style=\"background: #FFFF00\">loan</span> servicing.","additionalSnippets":[],"additionalSnippetCount":0,"contextualSummary":"","modifiedDate":"2022-10-20T14:20:44.000Z","headerPath":"","topicBreadcrumb":[{"topicSummary":[{"name":"Banking Regulations","id":"PROD-1080"}]},{"topicSummary":[{"name":"Banking Regulations","id":"PROD-1065"}]}],"tagCategories":[{"id":"PROD-1014","tags":["PROD-2930"]}],"articleTypeAttributes":{"typeName":"General","articleTypeId":"100100000002020"},"normalizedScore":0.2830405804592237},{"id":"PROD-2733","name":"What is the Difference Between Prequalification and Preapproval?","docType":"HTML","source":"eGain Article","snippet":"Prequalification\nThe Banker collects estimates of your income and liabilities to determine <span class=\"hc\" style=\"background: #FFFF00\">what</span> mortgage products may be available to you and <span class=\"hc\" style=\"background: #FFFF00\">what</span> you can afford to borrow. Our Mortgage Bankers can prequalify you by phone, in some cases.","keywordSnippet":"Prequalification\nThe Banker collects estimates of your income and liabilities to determine <span class=\"hc\" style=\"background: #FFFF00\">what</span> mortgage products may be available to you and <span class=\"hc\" style=\"background: #FFFF00\">what</span> you can afford to borrow. Our Mortgage Bankers can prequalify you by phone, in some cases.","additionalSnippets":[],"additionalSnippetCount":0,"contextualSummary":"","modifiedDate":"2022-10-20T15:13:59.000Z","headerPath":"","topicBreadcrumb":[{"topicSummary":[{"name":"Loans","id":"PROD-1070"}]}],"tagCategories":[{"id":"PROD-1014","tags":["PROD-1022","PROD-2196"]}],"articleTypeAttributes":{"typeName":"General","articleTypeId":"100100000002020"},"normalizedScore":0.18605361669534096},{"id":"PROD-2583","name":"Using Zelle","docType":"HTML","source":"eGain Article","snippet":"...lle you can send money to friends, family and almost anyone you know and trust, no matter where they bank in the U.S. Why Use Zelle It’s <span class=\"hc\" style=\"background-color: #FFFF00\">a fast and secure transfer</span> where money is deposited directly into your recipient’s bank account typically within minutes. You can also request money from others us...","keywordSnippet":"","additionalSnippets":[],"additionalSnippetCount":0,"contextualSummary":"","modifiedDate":"2022-10-25T14:07:19.000Z","headerPath":"","topicBreadcrumb":[{"topicSummary":[{"name":"Online Access","id":"PROD-1001"},{"name":"Zelle","id":"PROD-1084"}]},{"topicSummary":[{"name":"Using Online Banking","id":"PROD-1072"},{"name":"Zelle","id":"PROD-1075"}]}],"tagCategories":[{"id":"PROD-1014","tags":["PROD-1756"]}],"articleTypeAttributes":{"typeName":"General","articleTypeId":"100100000002020"},"normalizedScore":0.18394147762849983},{"id":"PROD-2554","name":"Banking Regulations","docType":"HTML","source":"eGain Article","snippet":"Some individual cities also enact their own financial regulation laws (for example, defining <span class=\"hc\" style=\"background: #FFFF00\">what</span> constitutes usurious lending).","keywordSnippet":"Some individual cities also enact their own financial regulation laws (for example, defining <span class=\"hc\" style=\"background: #FFFF00\">what</span> constitutes usurious lending).","additionalSnippets":[],"additionalSnippetCount":0,"contextualSummary":"","modifiedDate":"2022-10-20T14:17:48.000Z","headerPath":"","topicBreadcrumb":[{"topicSummary":[{"name":"Banking Regulations","id":"PROD-1080"}]},{"topicSummary":[{"name":"Banking Regulations","id":"PROD-1065"}]}],"tagCategories":[{"id":"PROD-1014","tags":["PROD-2930"]}],"articleTypeAttributes":{"typeName":"General","articleTypeId":"100100000002020"},"normalizedScore":0.16558712775547277},{"id":"PROD-2577","name":"Short Description of Mobile Deposit","docType":"HTML","source":"eGain Article","snippet":"Mobile check deposit allows you to save time by depositing your checks remotely, no matter where you are or <span class=\"hc\" style=\"background: #FFFF00\">what</span> time of day it is. Instead of making a run to the bank, you can simply snap a picture of the front and back of the check on your smartphone and deposit it using the bank's mobile app.","keywordSnippet":"Mobile check deposit allows you to save time by depositing your checks remotely, no matter where you are or <span class=\"hc\" style=\"background: #FFFF00\">what</span> time of day it is. Instead of making a run to the bank, you can simply snap a picture of the front and back of the check on your smartphone and deposit it using the bank's mobile app.","additionalSnippets":[],"additionalSnippetCount":0,"contextualSummary":"","modifiedDate":"2022-10-25T14:10:07.000Z","headerPath":"","topicBreadcrumb":[{"topicSummary":[{"name":"Checking and Savings Accounts","id":"PROD-1066"}]},{"topicSummary":[{"name":"Online Access","id":"PROD-1001"},{"name":"Mobile Banking","id":"PROD-1082"}]},{"topicSummary":[{"name":"Using Online Banking","id":"PROD-1072"}]}],"tagCategories":[{"id":"PROD-1014","tags":["PROD-1020","PROD-1756"]}],"articleTypeAttributes":{"typeName":"General","articleTypeId":"100100000002020"},"normalizedScore":0.13648458089091964},{"id":"PROD-2568","name":"Office of the Comptroller of the Currency (OCC) Banking Regulations","docType":"HTML","source":"eGain Article","snippet":"OCC Bulletins\n\n\nOCC Comptroller’s Handbook\n\n\nPart 2 - Sales of Credit Life Insurance\n\n\nPart 14 - Consumer Protection in Sales of Insurance\n\n\nPart 21 - Minimum Security Devices and Procedures, SAR & BSA Compliance Program\n\n\nPart 22 - <span class=\"hc\" style=\"background: #FFFF00\">Loans</span> in Areas having Special Flood Hazards\n\n\nPart 25 - Community Reinvestment","keywordSnippet":"OCC Bulletins\n\n\nOCC Comptroller’s Handbook\n\n\nPart 2 - Sales of Credit Life Insurance\n\n\nPart 14 - Consumer Protection in Sales of Insurance\n\n\nPart 21 - Minimum Security Devices and Procedures, SAR & BSA Compliance Program\n\n\nPart 22 - <span class=\"hc\" style=\"background: #FFFF00\">Loans</span> in Areas having Special Flood Hazards\n\n\nPart 25 - Community Reinvestment","additionalSnippets":[],"additionalSnippetCount":0,"contextualSummary":"","modifiedDate":"2022-10-20T14:30:06.000Z","headerPath":"","topicBreadcrumb":[{"topicSummary":[{"name":"Banking Regulations","id":"PROD-1080"}]},{"topicSummary":[{"name":"Banking Regulations","id":"PROD-1065"}]}],"tagCategories":[{"id":"PROD-1014","tags":["PROD-2930"]}],"articleTypeAttributes":{"typeName":"General","articleTypeId":"100100000002020"},"normalizedScore":0.13457933361485352},{"id":"PROD-2766","name":"How Do I Apply for a Credit Card?","docType":"HTML","source":"eGain Article","snippet":"...ple Customer Service Phone Number] [Sample Credit Card Extension] / [Sample Text Based Phone Number], Mon–Fri 7 am–5 pm PT. To apply for the <span class=\"hc\" style=\"background-color: #FFFF00\">Secured Credit Card</span>, visit your local branch.","keywordSnippet":"","additionalSnippets":[],"additionalSnippetCount":0,"contextualSummary":"","modifiedDate":"2022-10-20T14:49:19.000Z","headerPath":"","topicBreadcrumb":[{"topicSummary":[{"name":"Checking and Savings Accounts","id":"PROD-1066"},{"name":"Credit Cards","id":"PROD-1068"}]}],"tagCategories":[{"id":"PROD-1014","tags":["PROD-1024","PROD-2048","PROD-2196"]}],"articleTypeAttributes":{"typeName":"General","articleTypeId":"100100000002020"},"normalizedScore":0.1103068233378137}]}},"id":"paths/~1{portalID}~1search/get/responses/200/content/application~1json/example"},"paths/~1{portalID}~1search/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1{portalID}~1search/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1{portalID}~1search/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1{portalID}~1search/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1{portalID}~1search/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1{portalID}~1search/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1{portalID}~1search/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1{portalID}~1search/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1{portalID}~1search/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1{portalID}~1search/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1{portalID}~1search/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1{portalID}~1search/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1{portalID}~1search/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1{portalID}~1search/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1suggestions/post/requestBody/content/application~1json/examples/Mandatory Attributes Only":{"value":{"name":"Proposed Store Phone Number","content":"You should update your website with the new phone number.","language":{"code":"en-US"}},"key":"Mandatory Attributes Only","summary":"Mandatory Attributes Only","id":"paths/~1portals~1{portalID}~1suggestions/post/requestBody/content/application~1json/examples/Mandatory Attributes Only"},"paths/~1portals~1{portalID}~1suggestions/post/requestBody/content/application~1json/examples/Feedback Suggestion":{"value":{"name":"Proposed Store Phone Number","description":"Changing the phone number","content":"I noticed that the phone number is incorrect. Attached is the store's new landline and fax numbers.","language":{"code":"en-US"},"feedbackArticle":{"id":"PROD-2020"}},"key":"Feedback Suggestion","summary":"Feedback Suggestion","id":"paths/~1portals~1{portalID}~1suggestions/post/requestBody/content/application~1json/examples/Feedback Suggestion"},"paths/~1portals~1{portalID}~1suggestions/post/requestBody/content/application~1json/examples/All Attributes":{"value":{"attachments":{"attachment":[{"altId":"0b78095b-9a1c-4303-b3d5-16914f71bf91"}]},"name":"Proposed Store Phone Number","description":"Changing the phone number","content":"Attached is the store's new landline and fax numbers.","language":{"code":"en-US"},"customAttributes":[{"name":"proposal_category","value":["16","25"],"type":"INTEGER"},{"name":"automated_reply_language","value":["es"],"type":"STRING"}]},"key":"All Attributes","summary":"All Attributes","id":"paths/~1portals~1{portalID}~1suggestions/post/requestBody/content/application~1json/examples/All Attributes"},"paths/~1portals~1{portalID}~1suggestions/post/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1suggestions/post/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1suggestions/post/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1suggestions/post/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1suggestions/post/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1suggestions/post/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1suggestions/post/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1suggestions/post/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1suggestions/post/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1suggestions/post/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1suggestions/post/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1suggestions/post/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1suggestions/post/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1suggestions/post/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1suggestions/put/requestBody/content/application~1json/examples/Modify One Attribute (Name)":{"value":{"id":"PROD-5722","name":"Improving Telecommunication Services","modifiedDate":"2024-07-31T14:10:19Z"},"key":"Modify One Attribute (Name)","summary":"Modify One Attribute (Name)","id":"paths/~1portals~1{portalID}~1suggestions/put/requestBody/content/application~1json/examples/Modify One Attribute (Name)"},"paths/~1portals~1{portalID}~1suggestions/put/requestBody/content/application~1json/examples/Modify All Attributes":{"value":{"attachments":{"attachment":[{"altId":"0b78095b-9a1c-4303-b3d5-16914f71bf91"}],"unlink":[{"href":"/knowledge/portalmgr/v4/portals/999900000000000/suggestions/attachments/419200000001044","rel":"attachment"}]},"content":"This text replaces this Suggestion's existing content.","id":"PROD-5722","name":"Improving Telecommunication Services","description":"Proposed changes to increase operational efficiency.","modifiedDate":"2021-03-28T14:29:01.516Z","language":{"code":"en-US"},"customAttributes":[{"name":"phone_queue","value":["8","10"],"type":"INTEGER"},{"name":"automated_agent_language","value":["fr"],"type":"STRING"}]},"key":"Modify All Attributes","summary":"Modify All Attributes","id":"paths/~1portals~1{portalID}~1suggestions/put/requestBody/content/application~1json/examples/Modify All Attributes"},"paths/~1portals~1{portalID}~1suggestions/put/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1suggestions/put/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1suggestions/put/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1suggestions/put/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1suggestions/put/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1suggestions/put/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1suggestions/put/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1suggestions/put/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1suggestions/put/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1suggestions/put/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1suggestions/put/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1suggestions/put/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1suggestions/put/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1suggestions/put/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1suggestions/get/responses/200/content/application~1json/examples/Summary Attributes":{"value":{"suggestion":[{"link":[{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/suggestions/PROD-3259"}],"name":"Missing Article Information","description":"Missing Account Type Information","content":"<p>There should be an article that explains the account types offered. That would be very helpful.<br /></p>","status":{"value":"suggested","displayValue":"Suggested"},"modifiedBy":{"firstName":"John","middleName":"","lastName":"Smith","id":"1067"},"modifiedDate":"2025-01-23T04:16:17.000Z","language":{"code":"en-us","label":"English (US)"},"hasRelatedArticles":false,"hasAttachments":false,"hasComments":true,"customAttribute":[],"id":"PROD-3259"}],"paginationInfo":{"count":1,"pagenum":1,"pagesize":25}},"key":"Summary Attributes","summary":"Summary Attributes","id":"paths/~1portals~1{portalID}~1suggestions/get/responses/200/content/application~1json/examples/Summary Attributes"},"paths/~1portals~1{portalID}~1suggestions/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1suggestions/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1suggestions/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1suggestions/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1suggestions/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1suggestions/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1suggestions/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1suggestions/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1suggestions/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1suggestions/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1suggestions/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1suggestions/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1suggestions/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1suggestions/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/200/content/application~1json/examples/Summary Attributes":{"value":{"link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/suggestions/PROD-3259"},"name":"Missing Article Information","description":"Missing Account Type Information","content":"<p>There should be an article that explains the account types offered. That would be very helpful.<br /></p>","status":{"value":"suggested","displayValue":"Suggested"},"modifiedBy":{"firstName":"John","middleName":"","lastName":"Smith","id":"1067"},"modifiedDate":"2025-01-23T04:16:17.000Z","language":{"code":"en-US","label":"English"},"hasRelatedArticles":false,"hasAttachments":false,"hasComments":true,"customAttribute":[],"id":"PROD-3259"},"key":"Summary Attributes","summary":"Summary Attributes","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/200/content/application~1json/examples/Summary Attributes"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/delete/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/delete/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/delete/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/delete/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/delete/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/delete/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/delete/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/delete/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/delete/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}/delete/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/200/content/application~1json/examples/Summary Attributes":{"value":{"name":"Feedback","id":"PROD-3259","relatedArticles":[{"id":"PROD-3002","name":"Fair Lending","createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-06-30T18:25:22Z","hasAttachments":false,"languageCode":"en-US","modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2025-01-28T20:58:11Z","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/articles/PROD-3002?%&workflowMilestone=publish&filter%5Btags%5D=PROD-5381&%24lang=en-US"},"versionId":"PROD-2897"}]},"key":"Summary Attributes","summary":"Summary Attributes","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/200/content/application~1json/examples/Summary Attributes"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/200/content/application~1json/examples/All Attributes":{"value":{"name":"Feedback","id":"PROD-3259","relatedArticles":[{"id":"PROD-3002","name":"Fair Lending","articleSummary":"Fair lending ensures that lenders do not discriminate based on race, color, national origin, religion, sex, familial status, or disability when offering residential mortgage loans, guaranteeing equal opportunities for all. The Office of Fair Housing and Equal Opportunity enforces the federal Fair Housing Act, with state and local agencies ensuring similar protections. Additional laws, such as the Equal Credit Opportunities Act, also safeguard your rights. For more information, visit the U.S. Department of Housing and Urban Development website.","articleType":{"articleCategoryId":0,"typeName":"General","useStructuredAuthoring":false,"articleTypeId":"999500000001291"},"averageRating":0,"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe","userName":"jdoe"},"createdDate":"2022-06-30T18:25:22Z","description":"Article detailing Fair Lending.","hasAttachments":false,"imageURL":"","isSubscribed":false,"languageCode":"en-US","modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe","userName":"jdoe"},"modifiedDate":"2025-01-28T20:58:11Z","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/articles/PROD-3002?%articleResultAdditionalAttributes=all&workflowMilestone=publish&filter%5Btags%5D=PROD-5381&%24lang=en-US"},"ownedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe","userName":"jdoe"},"timesRated":0,"topicBreadcrumb":[{"topicSummary":[{"name":"Banking Regulations","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/topics/PROD-1080"}}]}],"customAttributes":[],"versionId":"PROD-2897","workflow":{"stages":[{"name":"publish","milestone":{"name":{"value":"publish","displayValue":"Published"}}}]}}]},"key":"All Attributes","summary":"All Attributes","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/200/content/application~1json/examples/All Attributes"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1relatedArticles/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/200/content/application~1json/examples/Summary Attributes":{"value":{"count":1,"comments":[{"content":"Great suggestion! We will put this on our To-Do list.","createdBy":{"firstName":"John","lastName":"Doe","id":"1013"},"createDate":"2025-01-23T04:48:25.000Z","id":"1000"}]},"key":"Summary Attributes","summary":"Summary Attributes","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/200/content/application~1json/examples/Summary Attributes"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/requestBody/content/application~1json/examples/New Comment":{"value":{"content":"I have uploaded the requested documents regarding the new phone numbers. Please review."},"key":"New Comment","summary":"New Comment","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/requestBody/content/application~1json/examples/New Comment"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1comments/post/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/200/content/application~1json/examples/Summary Attributes":{"value":{"attachments":[{"link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/suggestions/attachments/PROD-1001"},"fileName":"eightbank.png","size":45152,"id":"PROD-1001"}]},"key":"Summary Attributes","summary":"Summary Attributes","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/200/content/application~1json/examples/Summary Attributes"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1suggestions~1{suggestionID}~1attachments/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/200/content/application~1json/examples/Summary Attributes":{"value":{"link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/suggestions/attachments/PROD-1001"},"fileName":"eightbank.png","size":45152,"id":"PROD-1001"},"key":"Summary Attributes","summary":"Summary Attributes","id":"paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/200/content/application~1json/examples/Summary Attributes"},"paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/200/content/application~1json/examples/All Attributes":{"value":{"link":{"rel":"self","href":"/knowledge/portalmgr/v3/portals/202200000001000/suggestions/attachments/202200000001001"},"fileName":"eightbank.png","size":45152,"contentUrl":"https://developerv3api.egain.cloud/system/ws/internal/stream/resource/326330575442636564427A74632F776B4A53374F44677530754C546E5862784B6455326B6F64352F6A6C33773049664B37744C76476A665973707937555842504B794E6B667465525A6430630D0A7855456D486B4849444C363463767758557A5579636D6B744A3657634931664D757639775152374769456F654132654667666D68376E314D6B504746784B6B597A5171574E5657454472785A0D0A6E44335370615045524666314141725172485867496650333875314835753445773746675177795657782B5258705779","id":"PROD-1001"},"key":"All Attributes","summary":"All Attributes","id":"paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/200/content/application~1json/examples/All Attributes"},"paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1suggestions~1attachments~1{attachmentID}/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/200/content/application~1json/example":{"value":{"topicBreadcrumb":[{"topicSummary":[{"id":"PROD-1001","name":"Digital Banking","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/topics/PROD-1001"}},{"id":"PROD-1072","name":"Electronic Payments","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/topics/PROD-1072"}},{"id":"PROD-1075","name":"Transfer Funds","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/topics/PROD-1075"}}]},{"topicSummary":[{"id":"PROD-1066","name":"Checking and Savings Accounts","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/topics/PROD-1066"}},{"id":"PROD-1075","name":"Transfer Funds","link":{"rel":"self","href":"/knowledge/portalmgr/v4/portals/PROD-1000/topics/PROD-1075"}}]}]},"id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/200/content/application~1json/example"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1articles~1{articleID}~1breadcrumb/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/200/content/application~1json/examples/Get topic tree with $level value 0":{"value":{"topicTree":[{"topic":{"name":"Debit Cards","articleCountInTopic":4,"articleCountInTopicTree":4,"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-08-04T16:25:45Z","departmentId":1001,"modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2022-09-04T16:25:45Z","parentTopicId":"PROD-1066","topicHomeArticleId":"","subTopicIds":[],"childCount":0,"id":"PROD-1069"}}]},"key":"Get topic tree with $level value 0","summary":"Get topic tree with $level value 0","id":"paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/200/content/application~1json/examples/Get topic tree with $level value 0"},"paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/200/content/application~1json/examples/Get topic tree with $level value 1":{"value":{"topicTree":[{"topic":{"name":"Debit Cards","articleCountInTopic":4,"articleCountInTopicTree":4,"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-08-04T16:25:45Z","departmentId":1001,"modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2022-09-04T16:25:45Z","parentTopicId":"PROD-1066","topicHomeArticleId":"","subTopicIds":[],"childCount":0,"id":"PROD-1069"},"topicTree":[]}],"paginationInfo":{"count":0,"pagenum":1,"pagesize":10}},"key":"Get topic tree with $level value 1","summary":"Get topic tree with $level value 1","id":"paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/200/content/application~1json/examples/Get topic tree with $level value 1"},"paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/200/content/application~1json/examples/Topic tree with additional attributes with $level value 0":{"value":{"topicTree":[{"topic":{"name":"Debit Cards","articleCountInTopic":4,"articleCountInTopicTree":4,"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-08-04T16:25:45Z","departmentId":1001,"modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2022-09-04T16:25:45Z","parentTopicId":"PROD-1066","topicHomeArticleId":"","subTopicIds":[],"childCount":0,"id":"PROD-1069","imageUrl":"","description":"","textMetadata":{"highlightMetadata":[]}}}]},"key":"Topic tree with additional attributes with $level value 0","summary":"Topic tree with additional attributes with $level value 0","id":"paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/200/content/application~1json/examples/Topic tree with additional attributes with $level value 0"},"paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/200/content/application~1json/examples/Topic tree with custom attributes and $level value 0":{"value":{"topicTree":[{"topic":{"name":"Debit Cards","articleCountInTopic":4,"articleCountInTopicTree":4,"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-08-04T16:25:45Z","departmentId":1001,"modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2022-09-04T16:25:45Z","parentTopicId":"PROD-1066","topicHomeArticleId":"","subTopicIds":[],"childCount":0,"id":"PROD-1069","customAttributes":[]}}]},"key":"Topic tree with custom attributes and $level value 0","summary":"Topic tree with custom attributes and $level value 0","id":"paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/200/content/application~1json/examples/Topic tree with custom attributes and $level value 0"},"paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1topics~1{topicID}/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/200/content/application~1json/examples/Summary Attributes":{"value":{"topic":[{"name":"Checking and Savings Accounts","articleCountInTopic":0,"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-08-04T16:25:45Z","departmentId":"1001","modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2022-09-04T16:25:45Z","topicHomeArticleId":"","parentTopicId":"-1","childCount":0,"subTopicsIds":[],"link":{"rel":"self","href":"/knowledge/portalmgr/v3/portals/PROD-1000/topics/PROD-1066?%24lang=en-US"},"id":"PROD-1066"}],"paginationInfo":{"count":1,"pagenum":1,"pagesize":10}},"key":"Summary Attributes","summary":"Summary Attributes","id":"paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/200/content/application~1json/examples/Summary Attributes"},"paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/200/content/application~1json/examples/With Additional Attributes":{"value":{"topic":[{"name":"Checking and Savings Accounts","articleCountInTopic":0,"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-08-04T16:25:45Z","departmentId":"1001","modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2022-09-04T16:25:45Z","topicHomeArticleId":"","parentTopicId":"-1","childCount":0,"subTopicsIds":[],"description":"","imageUrl":"","textMetadata":{"highlightMetadata":[]},"link":{"rel":"self","href":"/knowledge/portalmgr/v3/portals/PROD-1000/topics/PROD-1066?%24lang=en-US"},"id":"PROD-1066"}],"paginationInfo":{"count":1,"pagenum":1,"pagesize":10}},"key":"With Additional Attributes","summary":"With Additional Attributes","id":"paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/200/content/application~1json/examples/With Additional Attributes"},"paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1topics~1{topicID}~1parents/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1topics/get/responses/200/content/application~1json/examples/Summary Attributes":{"value":{"topicTree":[{"topic":{"name":"Online Access","description":"","articleCountInTopic":0,"articleCountInTopicTree":73,"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-05-23T19:44:02Z","departmentId":1001,"modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2022-05-24T13:52:26Z","parentTopicId":-1,"childCount":9,"id":"PROD-1001"},"topicTree":[{"topic":{"name":"Accessing Your Account","description":"","articleCountInTopic":18,"articleCountInTopicTree":18,"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-06-08T22:39:09Z","departmentId":1001,"modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2022-06-08T22:39:09Z","parentTopicId":"PROD-1001","childCount":0,"id":"PROD-1062"}},{"topic":{"name":"Electronic Payments & Deposits","description":"","articleCountInTopic":3,"articleCountInTopicTree":3,"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-07-01T14:01:38Z","departmentId":1001,"modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2022-07-07T17:10:33Z","parentTopicId":"PROD-1001","childCount":0,"id":"PROD-1152"}},{"topic":{"name":"Manage Accounts","description":"","articleCountInTopic":16,"articleCountInTopicTree":16,"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-06-09T15:15:36Z","departmentId":1001,"modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2022-07-12T14:33:27Z","parentTopicId":"PROD-1001","childCount":0,"id":"PROD-1063"}},{"topic":{"name":"Membership","description":"","articleCountInTopic":3,"articleCountInTopicTree":3,"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-06-22T19:38:45Z","departmentId":1001,"modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2022-06-22T19:38:45Z","parentTopicId":"PROD-1001","childCount":0,"id":"PROD-1124"}},{"topic":{"name":"Mobile Banking","description":"","articleCountInTopic":3,"articleCountInTopicTree":3,"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-06-10T14:29:46Z","departmentId":1001,"modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2022-06-10T14:30:52Z","parentTopicId":"PROD-1001","childCount":0,"id":"PROD-1082"}},{"topic":{"name":"Personal Information","description":"","articleCountInTopic":2,"articleCountInTopicTree":2,"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-06-10T15:28:51Z","departmentId":1001,"modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2022-06-10T15:28:51Z","parentTopicId":"PROD-1001","childCount":0,"id":"PROD-1090"}},{"topic":{"name":"Stop Payments","description":"","articleCountInTopic":3,"articleCountInTopicTree":3,"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-06-10T15:32:01Z","departmentId":1001,"modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2022-06-10T15:32:01Z","parentTopicId":"PROD-1001","childCount":0,"id":"PROD-1091"}},{"topic":{"name":"Using Online Banking","description":"","articleCountInTopic":21,"articleCountInTopicTree":21,"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-06-10T14:41:53Z","departmentId":1001,"modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2022-06-10T14:41:53Z","parentTopicId":"PROD-1001","childCount":0,"id":"PROD-1088"}},{"topic":{"name":"Zelle","description":"","articleCountInTopic":4,"articleCountInTopicTree":4,"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-06-10T14:31:11Z","departmentId":1001,"modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2022-06-10T18:08:01Z","parentTopicId":"PROD-1001","childCount":0,"id":"PROD-1084"}}]},{"topic":{"name":"Accessing Your Account","articleCountInTopic":21,"articleCountInTopicTree":21,"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-06-09T16:24:27Z","departmentId":1001,"modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2022-06-09T16:24:27Z","parentTopicId":-1,"childCount":0,"id":"PROD-1064"}},{"topic":{"name":"Banking Regulations","articleCountInTopic":19,"articleCountInTopicTree":19,"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-06-09T16:24:37Z","departmentId":1001,"modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2022-06-09T16:24:37Z","parentTopicId":-1,"childCount":0,"id":"PROD-1065"}},{"topic":{"name":"Checking and Savings Accounts","articleCountInTopic":12,"articleCountInTopicTree":26,"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-06-09T16:24:49Z","departmentId":1001,"modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2022-06-09T16:24:49Z","parentTopicId":-1,"childCount":2,"id":"PROD-1066"},"topicTree":[{"topic":{"name":"Credit Cards","articleCountInTopic":10,"articleCountInTopicTree":10,"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-06-09T16:25:27Z","departmentId":1001,"modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2022-06-09T16:25:27Z","parentTopicId":"PROD-1066","childCount":0,"id":"PROD-1068"}},{"topic":{"name":"Debit Cards","articleCountInTopic":4,"articleCountInTopicTree":4,"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-06-09T16:25:45Z","departmentId":1001,"modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2022-06-09T16:25:45Z","parentTopicId":"PROD-1066","childCount":0,"id":"PROD-1069"}}]},{"topic":{"name":"Claims","articleCountInTopic":0,"articleCountInTopicTree":0,"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-06-10T14:31:45Z","departmentId":1001,"modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2022-06-10T14:31:45Z","parentTopicId":-1,"childCount":0,"id":"PROD-1085"}},{"topic":{"name":"Loans","articleCountInTopic":11,"articleCountInTopicTree":11,"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-06-09T16:30:12Z","departmentId":1001,"modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2022-06-09T16:30:12Z","parentTopicId":-1,"childCount":0,"id":"PROD-1070"}},{"topic":{"name":"Membership","articleCountInTopic":5,"articleCountInTopicTree":5,"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-06-09T16:30:25Z","departmentId":1001,"modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2022-06-09T16:30:25Z","parentTopicId":-1,"childCount":0,"id":"PROD-1071"}},{"topic":{"name":"Using Online Banking","articleCountInTopic":20,"articleCountInTopicTree":46,"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-06-09T16:31:03Z","departmentId":1001,"modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2022-06-09T16:31:03Z","parentTopicId":-1,"childCount":3,"id":"PROD-1072"},"topicTree":[{"topic":{"name":"Mobile Banking","articleCountInTopic":3,"articleCountInTopicTree":3,"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-06-09T16:31:12Z","departmentId":1001,"modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2022-06-09T16:31:12Z","parentTopicId":"PROD-1072","childCount":0,"id":"PROD-1073"}},{"topic":{"name":"Online Banking","articleCountInTopic":19,"articleCountInTopicTree":19,"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-06-09T16:31:24Z","departmentId":1001,"modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2022-06-09T16:31:24Z","parentTopicId":"PROD-1072","childCount":0,"id":"PROD-1074"}},{"topic":{"name":"Zelle","articleCountInTopic":4,"articleCountInTopicTree":4,"createdBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"createdDate":"2022-06-09T16:31:32Z","departmentId":1001,"modifiedBy":{"id":"1013","firstName":"John","middleName":"","lastName":"Doe"},"modifiedDate":"2022-06-09T16:31:32Z","parentTopicId":"PROD-1072","childCount":0,"id":"PROD-1075"}}]}]},"key":"Summary Attributes","summary":"Summary Attributes","id":"paths/~1portals~1{portalID}~1topics/get/responses/200/content/application~1json/examples/Summary Attributes"},"paths/~1portals~1{portalID}~1topics/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1topics/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1topics/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1topics/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1topics/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1topics/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1topics/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1topics/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1topics/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1topics/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1topics/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1topics/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1topics/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1topics/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1user/get/responses/200/content/application~1json/example":{"value":{"user":[{"id":"1067","roles":[{"id":"1026","name":"agent","template":{"value\"":"","displayValue\"":""}}],"firstName":"John","lastName":"Smith","hasEmailConfigured":false}]},"id":"paths/~1portals~1user/get/responses/200/content/application~1json/example"},"paths/~1portals~1user/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1user/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1user/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1user/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1user/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1user/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1user/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1user/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1user/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1user/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1user/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1user/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1user~1milestones/get/responses/200/content/application~1json/example":{"value":{"milestone":[{"name":{"value":"publish","displayValue":"Published"}}]},"id":"paths/~1portals~1user~1milestones/get/responses/200/content/application~1json/example"},"paths/~1portals~1user~1milestones/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1user~1milestones/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1user~1milestones/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1user~1milestones/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1user~1milestones/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1user~1milestones/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1user~1milestones/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1user~1milestones/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1user~1milestones/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1user~1milestones/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1user~1milestones/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1user~1milestones/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1userprofiles/get/responses/200/content/application~1json/example":{"value":{"profile":[{"name":"Loans Agents","isLastUsedInPortal":false,"id":"PROD-3210"},{"name":"Credit Cards Supervisors","isLastUsedInPortal":false,"id":"PROD-3226"},{"name":"Loans Supervisors","isLastUsedInPortal":true,"id":"PROD-3215"},{"name":"Voice Agent","isLastUsedInPortal":false,"id":"PROD-1037"},{"name":"Self-Service","isLastUsedInPortal":false,"id":"PROD-1026"},{"name":"Digital Agent","isLastUsedInPortal":false,"id":"PROD-1030"},{"name":"Banking Agents","isLastUsedInPortal":false,"id":"PROD-3205"},{"name":"Credit Card Agents","isLastUsedInPortal":false,"id":"PROD-3221"}]},"id":"paths/~1portals~1{portalID}~1userprofiles/get/responses/200/content/application~1json/example"},"paths/~1portals~1{portalID}~1userprofiles/get/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1userprofiles/get/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1userprofiles/get/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1userprofiles/get/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1userprofiles/get/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1userprofiles/get/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1userprofiles/get/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1userprofiles/get/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1userprofiles/get/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1userprofiles/get/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1userprofiles/get/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1userprofiles/get/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1userprofiles/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1userprofiles/get/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1userprofiles~1{userProfileID}~1select/put/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1search~1federated~1event/post/requestBody/content/application~1json/examples/All attributes present":{"value":{"q":"India","resultType":"external","url":"https://beetle.egain.com/","title":"Welcome to India","languageCode":"en-US"},"key":"All attributes present","summary":"All attributes present","id":"paths/~1portals~1{portalID}~1search~1federated~1event/post/requestBody/content/application~1json/examples/All attributes present"},"paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1search~1federated~1event/post/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1search~1connectors~1event/post/requestBody/content/application~1json/examples/All attributes present":{"value":{"languageCode":"en-US","q":"India","numberOfSearchResults":10},"key":"All attributes present","summary":"All attributes present","id":"paths/~1portals~1{portalID}~1search~1connectors~1event/post/requestBody/content/application~1json/examples/All attributes present"},"paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1search~1connectors~1event/post/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/requestBody/content/application~1json/examples/All attributes present":{"value":{"languageCode":"en-US","q":"India","url":"https://beetle.egain.com/","title":"Welcome to India"},"key":"All attributes present","summary":"All attributes present","id":"paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/requestBody/content/application~1json/examples/All attributes present"},"paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1portals~1{portalID}~1view~1searchresults~1connectors~1event/post/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1attachment~1preupload/post/requestBody/content/application~1json/examples/All attributes present":{"value":{"name":"article.png","size":11889},"key":"All attributes present","summary":"All attributes present","id":"paths/~1attachment~1preupload/post/requestBody/content/application~1json/examples/All attributes present"},"paths/~1attachment~1preupload/post/responses/200/content/application~1json/examples/All Attributes":{"value":{"altId":"f665fb41-6485-43c3-a2c8-c72857c29f74","name":"article.png","contentUrl":"https://EG5842ain.ezdev.net/knowledge/portalmgr/v4/attachmnet/upload?signature=3552656867434671616F6C51786335674B764E7848586E786B383255555A41574F6B656F542B396258677A334341322F2B32336F434D6D6E47637955714C6A6E4D527476666C534E4C6232520D0A4F6F70637259773043515A6778596949586F3247666B6E624350386336563446624C5446746C546B2F324A734E425939634758507465722B6C584435685747734C4A2B6C626342732F426E640D0A4D7965456452564A6670525069536D2B43423232384A67724F636C4161654F39336F42784942354C6776462F50724D67674A3248527253504C53457551596A7A6D4B347A4F7A63416C7047450D0A39556133495776504A4875336D77757330773D3D"},"key":"All Attributes","summary":"All Attributes","id":"paths/~1attachment~1preupload/post/responses/200/content/application~1json/examples/All Attributes"},"paths/~1attachment~1preupload/post/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1attachment~1preupload/post/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1attachment~1preupload/post/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1attachment~1preupload/post/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1attachment~1preupload/post/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1attachment~1preupload/post/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1attachment~1preupload/post/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1attachment~1preupload/post/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1attachment~1preupload/post/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1attachment~1preupload/post/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1attachment~1preupload/post/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1attachment~1preupload/post/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1attachment~1preupload/post/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1attachment~1preupload/post/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1content~1export/post/requestBody/content/application~1json/examples/sftpDestination":{"value":{"articleCategories":"searchable","portalID":"PROD-1000","language":{"code":"en-US"},"resourceTypes":["articles"],"dataDestination":{"destinationType":"SFTP server","path":"exports/mydeptfolder","sftpDetails":{"username":"rtka-user","password":"xyz1234","host":"sftp.yourcompany.com","port":22}}},"key":"sftpDestination","summary":"Export configuration using an SFTP destination","id":"paths/~1content~1export/post/requestBody/content/application~1json/examples/sftpDestination"},"paths/~1content~1export/post/requestBody/content/application~1json/examples/s3Destination":{"value":{"articleCategories":"searchable","portalID":"PROD-1000","language":{"code":"en-US"},"resourceTypes":["articles"],"dataDestination":{"destinationType":"AWS S3 bucket","path":"s3://amzn-s3-demo-bucket/mydeptfolder","s3Details":{"region":"us-west-2","accessKey":"s3-access-key","secretKey":"s3-access-secret"}}},"key":"s3Destination","summary":"Export configuration using an AWS S3 bucket destination","id":"paths/~1content~1export/post/requestBody/content/application~1json/examples/s3Destination"},"paths/~1content~1export/post/responses/400/content/application~1json/examples/Required Attribute missing":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: <param name>"},"key":"Required Attribute missing","summary":"Required Attribute missing","description":"Required query parameter is missing.","id":"paths/~1content~1export/post/responses/400/content/application~1json/examples/Required Attribute missing"},"paths/~1content~1export/post/responses/400/content/application~1json/examples/Unallowed attribute value":{"value":{"code":"400-196","developerMessage":"Invalid value of attribute <attribute>, expected values are: [<possible_values>]."},"key":"Unallowed attribute value","summary":"Unallowed attribute value","description":"One of the attributes has a value which is not allowed.","id":"paths/~1content~1export/post/responses/400/content/application~1json/examples/Unallowed attribute value"},"paths/~1content~1export/post/responses/401/content/application~1json/examples/Invalid Authorization":{"value":{"code":"401-104","developerMessage":"Invalid or missing 'authorization' header value."},"key":"Invalid Authorization","summary":"Invalid Authorization","description":"Invalid or expired authorization. Generate a new authorization header and try again.\n","id":"paths/~1content~1export/post/responses/401/content/application~1json/examples/Invalid Authorization"},"paths/~1content~1export/post/responses/403/content/application~1json/examples/Required Scope Missing":{"value":{"code":"403-197","developerMessage":"Not authorized to perform this action."},"key":"Required Scope Missing","summary":"Required Scope Missing","description":"User doesn't have the required scope to call this API. Refer to the API documentation regarding user scope assignment for more information.\n","id":"paths/~1content~1export/post/responses/403/content/application~1json/examples/Required Scope Missing"},"paths/~1content~1export/post/responses/404/content/application~1json/examples/Resource Not Found":{"value":{"code":"404-101","developerMessage":"The following IDs provided in the URI path were not found: <id>"},"key":"Resource Not Found","summary":"Resource Not Found","description":"Resource not found.","id":"paths/~1content~1export/post/responses/404/content/application~1json/examples/Resource Not Found"},"paths/~1content~1export/post/responses/406/content/application~1json/examples/Not Acceptable":{"value":{"code":"406-100","developerMessage":"The 'Accept-Language' header value is invalid."},"key":"Not Acceptable","summary":"Not Acceptable","id":"paths/~1content~1export/post/responses/406/content/application~1json/examples/Not Acceptable"},"paths/~1content~1export/post/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1content~1export/post/responses/500/content/application~1json/examples/Internal Server Error"},"paths/~1content~1export~1{jobID}~1status/get/responses/200/content/application~1json/examples/Job Not Started":{"value":{"status":"Pending"},"key":"Job Not Started","summary":"Pending export job","description":"Shows an export job that is pending start of processing.","id":"paths/~1content~1export~1{jobID}~1status/get/responses/200/content/application~1json/examples/Job Not Started"},"paths/~1content~1export~1{jobID}~1status/get/responses/200/content/application~1json/examples/Job In Progress":{"value":{"status":"In Progress","progress":{"processed":1500,"total":4500,"percentage":30},"startTime":"2025-09-15T10:00:00.000Z","estimatedCompletion":"2025-09-15T11:30:00.000Z"},"key":"Job In Progress","summary":"Active export job","description":"Shows an export job that is currently processing content.","id":"paths/~1content~1export~1{jobID}~1status/get/responses/200/content/application~1json/examples/Job In Progress"},"paths/~1content~1export~1{jobID}~1status/get/responses/200/content/application~1json/examples/Completed Job":{"value":{"status":"Successful","progress":{"processed":4500,"total":4500,"percentage":100},"startTime":"2025-09-15T10:00:00.000Z","completionTime":"2025-09-15T11:25:00.000Z","results":{"successful":4485,"warnings":12,"errors":3}},"key":"Completed Job","summary":"Successfully completed job","description":"Shows a job that has finished processing.","id":"paths/~1content~1export~1{jobID}~1status/get/responses/200/content/application~1json/examples/Completed Job"},"paths/~1content~1export~1{jobID}~1status/get/responses/200/content/application~1json/examples/Failed Job":{"value":{"status":"Failed","progress":{"processed":1500,"total":4500,"percentage":30},"startTime":"2025-09-10T10:00:00.000Z","failureTime":"2025-09-10T10:45:00.000Z","error":"Connection timeout after processing 1500 items."},"key":"Failed Job","summary":"Job that encountered errors","description":"Shows a job that failed during processing.","id":"paths/~1content~1export~1{jobID}~1status/get/responses/200/content/application~1json/examples/Failed Job"},"paths/~1content~1export~1{jobID}~1status/get/responses/400/content/application~1json/examples/Unsupported Parameters":{"value":{"code":"400-101","developerMessage":"Unsupported query parameter(s) supplied: '<query_parameter>'."},"key":"Unsupported Parameters","summary":"Unsupported Parameters","id":"paths/~1content~1export~1{jobID}~1status/get/responses/400/content/application~1json/examples/Unsupported Parameters"},"paths/~1content~1export~1{jobID}~1status/get/responses/400/content/application~1json/examples/Invalid Value":{"value":{"code":"400-152","developerMessage":"Invalid value is provided in the request body for the following attribute:'<attribute_name>'."},"key":"Invalid Value","summary":"Invalid Value","id":"paths/~1content~1export~1{jobID}~1status/get/responses/400/content/application~1json/examples/Invalid Value"},"paths/~1content~1export~1{jobID}~1status/get/responses/400/content/application~1json/examples/Missing required query parameter":{"value":{"code":"400-112","developerMessage":"Required query parameter(s) is missing. The following parameters are required: '<query_parameter>'."},"key":"Missing required query parameter","summary":"Missing required query parameter","id":"paths/~1content~1export~1{jobID}~1status/get/responses/400/content/application~1json/examples/Missing required query parameter"},"paths/~1content~1export~1{jobID}~1status/get/responses/401/content/application~1json/examples/Unauthorized":{"value":{"code":"401-101","developerMessage":"Invalid or expired 'Authorization' header provided. New login is required."},"key":"Unauthorized","summary":"Unauthorized","id":"paths/~1content~1export~1{jobID}~1status/get/responses/401/content/application~1json/examples/Unauthorized"},"paths/~1content~1export~1{jobID}~1status/get/responses/403/content/application~1json/examples/Forbidden":{"value":{"code":"403-178","developerMessage":"User is not allowed to perform the following action: <action_name>."},"key":"Forbidden","summary":"Forbidden","id":"paths/~1content~1export~1{jobID}~1status/get/responses/403/content/application~1json/examples/Forbidden"},"paths/~1content~1export~1{jobID}~1status/get/responses/404/content/application~1json/examples/Not found":{"value":{"code":"404-100","developerMessage":"The following IDs supplied in the URI path were not found: '<resource_id>'."},"key":"Not found","summary":"Not found","id":"paths/~1content~1export~1{jobID}~1status/get/responses/404/content/application~1json/examples/Not found"},"paths/~1content~1export~1{jobID}~1status/get/responses/500/content/application~1json/examples/Internal Server Error":{"value":{"code":"500-100","developerMessage":"System is unable to process this request. Please contact your administrator."},"key":"Internal Server Error","summary":"Internal Server Error","id":"paths/~1content~1export~1{jobID}~1status/get/responses/500/content/application~1json/examples/Internal Server Error"}},"securitySchemeStore":{"oAuthUser":{"id":"oAuthUser","type":"oauth2","description":"Authenticate as a user (agent) using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_User_V3_SignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"},"oAuthOnBehalfOfUser":{"id":"oAuthOnBehalfOfUser","type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a user.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=user&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a user.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a user."}}}},"oAuthCustomer":{"id":"oAuthCustomer","type":"oauth2","description":"Authenticate as a customer using code flow with PKCE.","flows":{"authorizationCode":{"authorizationUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/authorize?domain_hint=developerv3api.egain.cloud","tokenUrl":"https://login.egain.cloud/f51302dd-7036-41b5-b619-e1a52a67c780/B2C_1A_Customer_V3_SignUpOrSignIn_OIDC/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."},"x-usePkce":{"disableManualConfiguration":true,"hideClientSecretInput":true}}},"x-defaultClientId":"9924ecd8-7716-427f-9998-d87081df567a"},"oAuthOnBehalfOfCustomer":{"id":"oAuthOnBehalfOfCustomer","type":"oauth2","description":"Authenticate as a client application (server) acting on behalf of a customer.","flows":{"password":{"tokenUrl":"https://api.egain.cloud/core/authmgr/v4/oauth2/v2.0/onbehalfof/token?user_type=customer&tenantId=TMPROD69343811","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.read":"Allows read access to the eGain Knowledge Portal Manager APIs on behalf of a customer.","https://api.egain.cloud/auth/knowledge.portalmgr.onbehalfof.manage":"Allows full access to the eGain Knowledge Portal Manager APIs on behalf of a customer."}}}},"oAuthAnonymousCustomer":{"id":"oAuthAnonymousCustomer","type":"oauth2","description":"Authenticate as an anonymous customer.","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/internal/oauth2/v2.0/anonymous/token?user_type=customer&domain_hint=developerv3api.egain.cloud","scopes":{"https://api.egain.cloud/auth/knowledge.portalmgr.read":"Allows read access to the eGain Knowledge Portal Manager APIs.","https://api.egain.cloud/auth/knowledge.portalmgr.manage":"Allows full access to the eGain Knowledge Portal Manager APIs."}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"},"oAuthClient":{"id":"oAuthClient","type":"oauth2","description":"Authenticate as a client (Server to Server).","flows":{"clientCredentials":{"tokenUrl":"https://login.egain.cloud/global/f51302dd-7036-41b5-b619-e1a52a67c780/oauth2/v2.0/token","scopes":{"https://api.egain.cloud/auth/.default":"Default scope"}}},"x-defaultClientId":"7bbc9ba6-0465-46f0-91f4-d2742cdc0ef8"},"bearerAuth":{"id":"bearerAuth","type":"http","scheme":"bearer","bearerFormat":"JWT"}},"servers":[{"url":"https://api.egain.cloud/knowledge/portalmgr/v4","description":"Production Server"}]},"options":{"hideSidebar":true,"mockServer":{"off":true},"disableRouter":true,"downloadUrls":[{"url":"/_bundle/apis/v4/knowledge/portalmgr/api-bundled.json?download"},{"url":"/_bundle/apis/v4/knowledge/portalmgr/api-bundled.yaml?download"}],"excludeFromSearch":false,"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"Knowledge Portal Manager APIs","description":"### License\n  The following licenses are required to use the Knowledge Access APIs:\n  * If the user is an agent, then the *Knowledge + AI* license is required.\n  * If the user is a customer, the *Self-Service* and *Advanced Self-Service* licenses must be available.\n\n### Tiers\n\n| Tier\t|Tier Name|\tNamed Users |\tDescription\n| ---------- | ---------- | ---------- | ----------------------------\n| Tier 1 |  Starter |\tUp to 10|\tDesigned for small-scale implementations or pilot environments\n| Tier 2 |\tGrowth\t| Up to 1000|\tSuitable for mid-scale deployments requiring moderate scalability\n| Tier 3 |\tEnterprise\t| Greater than 1000|\tSupports large-scale environments with extended configuration options\n\n### API Resource Limits\nThe following Resources have predefined limits for specific access attributes for Starter, Growth and Enterprise use.\n\n| Resource | Limits | Starter | Growth | Enterprise\n| ---------------- | ---------------------------- | ---------- | ---------- | ----------\n| Article Reference |Number of attachments used in any article | 25 | 50 |50\n|  |Number of custom attributes of an article in the system | 25 | 25 | 25\n|  |Number of publish views used in an article version | 20 | 20 | 20\n| Topic Reference |User-defined topics in a department| 1000| 5000 | 10000\n|  |Depth of topics  | 5 | 20 | 20\n|  |Topics at any level | 500 | 500 | 500\n|  |Number of custom attributes in a topic | 10 | 10 | 10\n| Portal Reference | Tag categories in a portal | 15 | 15 | 15\n|  |Topics to be included in a portal | 100 | 500 | 5000 \n|  |Number of articles to display in announcements | 10 | 25 | 25\n|  |Usage links and link groups setup for a portal | 5 | 10 | 25\n    \n      \n"}},"baseSlug":"/apis/v4/knowledge/portalmgr/api-bundled","routesMapping":{}}