Collections
Get Collection
Fetches a single collection by ID. Returns null rather than 404 when nothing matches.
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. 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.