Saasco logoSaasco logo
Saasco logoSaasco logo

Introduction

OverviewGetting startedWhat is Saasco?

SDK

Quick startTrackingIdentifyConfigurationWidgetsProperties

MCP

Quick startHow it worksAuthorizationTool reference

REST API

Quick start
Set up KnowledgePopulate the knowledge base
getList CollectionsgetGet CollectionpostCreate CollectionputUpdate CollectiondelDelete CollectiongetList Public Collections
KnowledgeCollections

Update Collection

Updates a collection's name, description, icon, or position. Only the fields present in the body are written. Re-parent it by setting parentId, keeping within the 3-level nesting limit. icon accepts a Lucide name, an emoji, or a storage URL; iconImage uploads an image file and stores the resulting storage URL.

PUT
/projects/{projectId}/knowledge/collections/{id}

Authorization

Authorization
AuthorizationBearer <token>

In: header

Path Parameters

projectIdrequiredstring

ID of the project that owns the collection.

idrequiredstring

ID of the collection to update.

Request Body

application/json

descriptionstring | null
helpCenterIdstring
iconstring | null

Lucide icon name (for example book-open), an emoji, or a public storage URL (https://storage.saasco.com/...). Send iconImage to upload an image file instead.

namestring
orderinteger
parentIdstring | null
urlstring | null
iconImageobject

Image file to upload as the collection icon, using the same project image upload as the product icon picker. The stored icon becomes the public storage URL. When set, this replaces icon.

contentTyperequiredstring

Image MIME type, for example image/png or image/svg+xml.

dataBase64requiredstring

Base64-encoded image bytes. A data: URL is also accepted.

fileNamestring

File name including the extension, for example analytics.svg.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PUT "https://www.saasco.com/api/v2/projects/string/knowledge/collections/string" \  -H "Content-Type: application/json" \  -d '{}'
{
  "id": "string",
  "createdAt": "string",
  "updatedAt": "string",
  "projectId": "string",
  "helpCenterId": "string",
  "name": "string",
  "description": "string",
  "url": "string",
  "icon": "string",
  "order": -9007199254740991,
  "parentId": "string"
}
{
  "code": "BAD_REQUEST",
  "message": "Invalid input data",
  "issues": []
}
{
  "code": "UNAUTHORIZED",
  "message": "Authorization not provided",
  "issues": []
}
{
  "code": "FORBIDDEN",
  "message": "Insufficient access",
  "issues": []
}
{
  "code": "NOT_FOUND",
  "message": "Not found",
  "issues": []
}
{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal server error",
  "issues": []
}

Create Collection

Creates a collection: the folder that groups articles in a help center's navigation. Collections can nest via `parentId`, up to 3 levels deep. Set `icon` to a Lucide icon name, an emoji, or an https://storage.saasco.com URL, or send `iconImage` to upload an image file the same way the product icon picker does.

Delete Collection

Deletes a collection. Articles in that collection are not deleted. They are unlinked, which drops them out of help-center navigation while leaving the content intact. Sub-collections are not deleted. They move up to this collection's parent, or to the top level when it had none, and their articles stay in those sub-collections. Idempotent: deleting a collection that does not exist still returns `true`.