Update Knowledge Base Page

CUSTOM-ENDPOINT

PUT https://api.speakap.io/networks/:eid/pages/:eid/

CUSTOM-REQUEST

  • URI: /networks/{networkEID}/pages/{pageEID}
  • Method: PUT
  • Accept: application/vnd.speakap.api-v1.8.2+json+hal
  • Authentication: OAuth 2.0

Parameters

NameTypeDescription
networkEIDEIDNetwork EID
pageEIDEIDPage EID

Request Body

Supply a knowledge base page resource in the request body.

NameTypeDescription
titlestringTitle of page. It's a required field.
bodyhtmlThe body of page. It's a required field.
iconstringThe name of the icon of the page. It's a required field.
statusstringThe status of the page. Published or draft. It's a required field.
pageTypestringThe type of the page. It must be knowledge_base. It's a required field.
knowledgeBaseCategoryarrayA list of categories. Although it's a list, should be a list of a single element. It's a required field
recipientsarrayList of recipient objects (groups or network). It's a required field
recipients[i].EIDEIDEID of the recipient (group or network)
recipients[i].typestringgroup or network
coverImagemessageIdentityA cover image for the page. It's optional
coverImage.EIDEIDEID of the uploaded file
coverImage.typestringmessage

Example (knowledge base page)

{
    "body": "The body here",
    "icon": "car",
    "recipients": [
        {
          "EID": "{{NetworkEID}}",
          "type": "network"
        }
    ],
    "knowledgeBaseCategories": ["{{CategoryEID}}"],
    "title": "Auto",
    "status": "published",
    "pageType": "knowledge_base",
    "coverImage": {
        "EID": "{{FileEID}}",
        "type": "message"
    }
}

Response

StatusData
201Accepted for update: returns a Feedback object
400Invalid data: returns an Error object
401Unauthorized: returns an Error object
403Forbidden: returns an Error object
404Unknown page: returns an Error object