Update Knowledge Base Category
CUSTOM-ENDPOINT
PUT https://api.speakap.io/networks/:eid/knowledge-base/categories/:eid/
CUSTOM-REQUEST
- URI: /networks/{networkEID}/knowledge-base/categories/{knowledgeBaseCategoryEID}
- Method: PUT
- Accept: application/vnd.speakap.api-v2025.0.5+json+hal
- Authentication: OAuth 2.0
Parameters
| Name | Type | Description |
|---|
| networkEID | EID | Network EID |
| parentKnowledgeBaseCategoryEID | EID | Parent Knowledge Base Category EID |
Request Body
Supply a knowledge base category resource in the request body.
| Name | Type | Description |
|---|
| title | string | Title of the category. |
| description | string | The description of the category. |
| iconType | string | The type of the icon of the category. |
| iconColor | string | The color of the icon of the category. |
| parentKnowledgeBaseCategoryEID | EID | The parent of the category. It's only provided if the client is editing a subcategory. |
| coverImage | messageIdentity | A cover image for the category. If not set, the default cover image is used. |
| coverImage.EID | EID | EID of the uploaded file |
| coverImage.type | string | message |
| groups | array | List of groups objects. If not passed, the category/subcategory is edited for the whole network. |
| groups[i].EID | EID | EID of the group |
| groups[i].type | string | The 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