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

Get Public Article

Fetches a published article by its URL slug: the reader-facing lookup behind a help-center page. Public and unauthenticated. Drafts and internal articles are never returned; anything not publicly visible comes back as null.

GET
/knowledge/articles/{slug}

Authorization

Authorization
AuthorizationBearer <token>

In: header

Path Parameters

slugrequiredstring

URL slug of the article, generated from its title when it was created.

Query Parameters

helpCenterIdrequiredstring

ID of the help center publishing the article.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://www.saasco.com/api/v2/knowledge/articles/string?helpCenterId=string"
{
  "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"
  }
}
{
  "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": []
}

Delete Article

Permanently deletes an article and the screenshots it uploaded. Idempotent: deleting an article that does not exist still returns `true` rather than 404, so the response is not a reliable existence check. Cannot be undone.

Get Public Articles By IDs

Fetches several published articles in one call, for rendering a curated or recommended set without a request per article. Unknown or non-public IDs are skipped, so the response can be shorter than the list you sent and the order is not guaranteed to match.