Saasco logoSaasco logo
Saasco logoSaasco logo

Introduction

Quick StartWhat is Saasco?

Analytics

CRM

Email Marketing

Knowledge

getList ArticlesgetGet ArticlepostCreate ArticleputUpdate ArticledelDelete ArticlegetGet Public ArticlegetGet Public Articles By IDsgetGet Related ArticlesgetSearch ArticlesgetInstant Search ArticlespostAdd Article ReactionpostIncrement Article Views

Support

Projects

Articles

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": [
    {
      "id": "string",
      "createdAt": "string",
      "updatedAt": "string",
      "projectId": "string",
      "type": "public",
      "title": "string",
      "slug": "string",
      "description": "string",
      "body": "string",
      "url": "string",
      "state": "draft",
      "order": -9007199254740991,
      "collectionId": "string",
      "authorId": "string",
      "views": -9007199254740991,
      "conversions": -9007199254740991,
      "happyReactions": -9007199254740991,
      "neutralReactions": -9007199254740991,
      "sadReactions": -9007199254740991,
      "author": {
        "id": "string",
        "image": "string",
        "name": "string"
      },
      "collection": {
        "helpCenterId": "string",
        "name": "string"
      }
    }
  ],
  "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": []
}

Verify Workflow Config

Checks that each sendCampaign step has a campaign and that the campaign itself 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.