List articles in one language (all statuses), newest first
GET
/knowledge-bases/{kbId}/articles
const url = 'https://api.motenya.app/v1/knowledge-bases/example/articles?language=en&status=draft&limit=25&offset=0';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://api.motenya.app/v1/knowledge-bases/example/articles?language=en&status=draft&limit=25&offset=0' \ --header 'Authorization: Bearer <token>'Requires articles:read. Items omit the body; fetch an article for it.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”kbId
required
string
Query Parameters
Section titled “Query Parameters”language
required
A language code enabled on the knowledge base, e.g. ‘en’ or ‘ro’.
string
Example
enA language code enabled on the knowledge base, e.g. ‘en’ or ‘ro’.
status
string
categoryId
string
tag
string
q
Full-text search over title and body.
string
Full-text search over title and body.
limit
integer
offset
integer | null
Responses
Section titled “Responses”A page of articles
Media typeapplication/json
object
items
required
Array<object>
object
id
required
string
kbId
required
string
language
required
string
categoryId
required
string | null
slug
required
string
title
required
string
excerpt
required
string | null
tags
required
Array<string>
status
required
string
translationGroupId
required
string | null
publishedAt
required
string | null
updatedAt
required
string
total
required
integer
Example
{ "items": [ { "status": "draft" } ]}Invalid request
Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
field
string
details
Array<object>
object
code
required
string
message
required
string
field
string
Example
{ "error": { "code": "SLUG_TAKEN" }}Missing, invalid, revoked or expired API key
Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
field
string
details
Array<object>
object
code
required
string
message
required
string
field
string
Example
{ "error": { "code": "SLUG_TAKEN" }}Missing scope, API turned off, published article without publish scope, or account suspended
Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
field
string
details
Array<object>
object
code
required
string
message
required
string
field
string
Example
{ "error": { "code": "SLUG_TAKEN" }}Not found, or outside the knowledge bases this key may use
Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
field
string
details
Array<object>
object
code
required
string
message
required
string
field
string
Example
{ "error": { "code": "SLUG_TAKEN" }}Slug or translation already exists
Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
field
string
details
Array<object>
object
code
required
string
message
required
string
field
string
Example
{ "error": { "code": "SLUG_TAKEN" }}Rejected by validation (e.g. unknown language or category)
Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
field
string
details
Array<object>
object
code
required
string
message
required
string
field
string
Example
{ "error": { "code": "SLUG_TAKEN" }}Rate limited; see Retry-After
Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
field
string
details
Array<object>
object
code
required
string
message
required
string
field
string
Example
{ "error": { "code": "SLUG_TAKEN" }}Internal error