Add a new article
Add a new article to portal
Articles are always created as drafts. status is not accepted here — publishing is a separate, explicit step so that nothing reaches a public Help Center as a side effect of a create call.
Authorizations
This token can be obtained by visiting the profile page or via rails console. Provides access to endpoints based on the user permissions levels. This token can be saved by an external system when user is created via API, to perform activities on behalf of the user.
Path Parameters
The slug identifier of the portal
Body
Fields accepted when creating an article. status is deliberately absent: articles are always created as drafts and publishing is a separate, explicit call.
The title of the article
"Article Title"
The slug of the article
"article-title"
article position in category
1
The text content.
"This is the content of the article"
The description of the article
"This is the description of the article"
The category id of the article
1
The author agent id of the article
1
To associate similar articles to each other, e.g to provide the link for the reference.
2
The locale of the article
"en"
Use for search
Response
Success
Single-article responses are wrapped in a payload key.
An article as the Help Center API renders it. Note that this is not the database row — category and author come back as nested objects rather than as category_id and author_id.