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

Get Collection

Fetches a single collection by ID. Returns null rather than 404 when nothing matches.

GET
/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 fetch.

Query Parameters

helpCenterIdrequiredstring

ID of the help center the collection belongs to.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://www.saasco.com/api/v2/projects/string/knowledge/collections/string?helpCenterId=string"
{
  "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": []
}

List Collections

Lists a help center's collections, each with its articles and nested child collections, for building the navigation tree. Nested articles omit body, description, reaction counts, and author — fetch an article by id for those. Includes drafts and internal articles. Use List Public Collections for the reader-facing version.

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.