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 ArticlesgetGet ArticlepostCreate ArticleputUpdate ArticlepostUpload Article ImagedelDelete ArticlegetGet Public ArticlegetGet Public Articles By IDsgetGet Related ArticlesgetSearch ArticlesgetInstant Search ArticlespostAdd Article ReactionpostIncrement Article Views
KnowledgeArticles

List Articles

Lists a project's articles for management views, covering drafts and internal articles that never appear in public search. Paginated, returning data alongside a total for the filter you applied.

GET
/projects/{projectId}/knowledge/articles

Authorization

Authorization
AuthorizationBearer <token>

In: header

Path Parameters

projectIdrequiredstring

ID of the project to list articles from.

Query Parameters

collectionIdstring

Only return articles in this collection.

helpCenterIdstring

Only return articles belonging to this help center.

orderBystring

Article field to sort by, e.g. createdAt or title.

orderDirectionstring

Sort direction.

Value in: "asc" | "desc"
skipnumber

Number of articles to skip before collecting results.

statestring

Only return articles in this publication state.

Value in: "draft" | "published"
takenumber

Maximum number of articles to return.

typestring

Only return articles for this audience: public for help-center content, internal for articles used solely to answer support questions.

Value in: "public" | "internal"

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/articles"
{
  "data": [
    {
      "author": {
        "id": "string",
        "image": "string",
        "name": "string"
      },
      "authorId": "string",
      "collection": {
        "helpCenterId": "string",
        "name": "string"
      },
      "collectionId": "string",
      "createdAt": "string",
      "id": "string",
      "order": -9007199254740991,
      "projectId": "string",
      "slug": "string",
      "state": "draft",
      "title": "string",
      "type": "public",
      "updatedAt": "string",
      "views": -9007199254740991
    }
  ],
  "total": 0
}
{
  "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": []
}

Populate the knowledge base

What an agent needs to fill a Saasco help center with collections and articles from this product's codebase.

Get Article

Fetches one article by ID for editing, including drafts and internal articles. Returns `null` rather than 404 when nothing matches. Use Get Public Article for the reader-facing lookup, which is by slug and only returns published content.