Saasco logoSaasco logo
Saasco logoSaasco logo

Introduction

Quick StartWhat is Saasco?

Analytics

CRM

Email Marketing

Knowledge

getList CollectionsgetGet CollectionpostCreate CollectionputUpdate CollectiondelDelete CollectiongetList Public Collections

Support

Projects

Collections

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.

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
namestring
orderinteger
parentIdstring | null
urlstring | null

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.

Delete Collection

Deletes a collection. Its articles are **not** deleted. They are unlinked, which drops them out of help-center navigation while leaving the content intact, reachable only by direct search. Move articles to another collection first if you want them to stay browsable. Idempotent: deleting a collection that does not exist still returns `true`.