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

List Public Collections

The reader-facing navigation tree for a help center: collections with their nested children and published public articles only. Nested articles omit body, description, and reaction counts. Public and unauthenticated, so it is safe to call from a help-center front end.

GET
/knowledge/help-centers/{helpCenterId}/collections

Authorization

Authorization
AuthorizationBearer <token>

In: header

Path Parameters

helpCenterIdrequiredstring

ID of the help center whose collections to list.

Query Parameters

parentIdstring | null

Only return children of this collection. Pass null for top-level collections; omit for all of them.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://www.saasco.com/api/v2/knowledge/help-centers/string/collections"
[
  {
    "id": "string",
    "createdAt": "string",
    "updatedAt": "string",
    "projectId": "string",
    "helpCenterId": "string",
    "name": "string",
    "description": "string",
    "url": "string",
    "icon": "string",
    "order": -9007199254740991,
    "parentId": "string",
    "articles": [],
    "children": []
  }
]
{
  "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": []
}

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`.

Get Help Center

Fetches the project's help center with its full configuration: theme, custom domain and verification state, analytics ID. Returns `null` if the project has no help center yet.