KB User's Guide - API - Site Banners

This document provides information for the Site Banners API for the KnowledgeBase.


Get Site Banners

Calls externally-published Site Banners for a specified site domain.

** APIs are not enabled for institution subsites unless specifically requested. Please contact the KB team if you would like to request an API for your subsite(s).

Collection Endpoint

This API does not have a collection response.

Entity Endpoint

https://[KB site domain]/api/v1/site-banners/[siteId]

Example: https://kb.wisc.edu/api/v1/site-banners/2

** You can find your siteId by reviewing the URI Components in the Group Spaces API, please review KB User's Guide - API - Group Spaces for details. Your siteId will be listed as an integer in the extSiteId value.

Entity Sample Response

"siteId": "2",
"header": null,
"headerActivation": "2018-07-27 23:15:35",
"headerExpiration": "2018-08-18 13:00:00",
"_links": {
"self": {
"href": "https://kb.wisc.edu/api/v1/site-banners/2"

Success Response

Code: 200 OK
Content: Content-type: application/hal+json

Error Response

Code: 404 Page Not Found
Content: { error : "Page not found." }


Code: 405 Method Not Allowed
Content: { error : None }