Saasco logoSaasco logo
Saasco logoSaasco logo

Introduction

OverviewGetting startedAgent setupWhat is Saasco?

SDK

Quick startTrackingIdentifyConfigurationWidgetsProperties

MCP

Quick startHow it worksAuthorizationTool reference
Skills for agents

REST API

Quick start
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

View as MarkdownAgent setup

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://example.com/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}

Verify Workflow Config

Checks that the trigger event has been received in the last 28 days and that each sendCampaign step has a campaign that verifies. Returns isValid plus per-step errors. Does not activate the workflow or start a run.

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.