Create Knowledge Base Category

CUSTOM-ENDPOINT

POST https://api.speakap.io/networks/:eid/knowledge-base/categories/

CUSTOM-REQUEST

  • URI: /networks/{networkEID}/knowledge-base/categories/
  • Method: POST
  • Content-Type: application/json
  • Authentication: OAuth 2.0

Parameters

NameTypeDescription
networkEIDEIDNetwork EID

Request Body

Supply a complete knowledge base category resource in the request body.

NameTypeDescription
titlestringTitle of the category. It's a required field.
descriptionstringThe description of the category. It's a required field.
iconTypestringThe type of the icon of the category. It's a required field.
iconColorstringThe color of the icon of the category. It's a required field and it's a hexadecimal value. Ex: #ff0000
parentKnowledgeBaseCategoryEIDEIDThe parent of the category. It's only provided if the client is creating a subcategory.
coverImagemessageIdentityA cover image for the category. It's optional. If not set, the default cover image is used.
coverImage.EIDEIDEID of the uploaded file
coverImage.typestringmessage
groupsarrayList of groups objects. If not passed, the category/subcategory is created for the whole network.
groups[i].EIDEIDEID of the group
groups[i].typestringThe value must be group

Example (knowledge base category)

{
    "title": "KB Category",
    "description": "Category description",
    "iconType": "book",
    "iconColor": "#ff0000",
    "coverImage": [
      {"EID":  "e000000000000003", "type": "message"}
    ],
    "groups": [
      {"EID": "e000000000000001", "type": "group"},
      {"EID": "e000000000000002", "type": "group"}
    ]
}

Response

StatusData
201Accepted for insertions: returns a Feedback object
400Invalid data: returns an Error object
401Unauthorized: returns an Error object
403Forbidden: returns an Error object