Skip to navigation

Create Article

View as Markdown

Creates a article. Needs a key with Website Content: Read and Write (website-content:write).

FieldTypeRules
slugstringRequired, max 255, letters and digits separated by -, _, . or ~.
headingstringRequired, max 255.
sub_heading, authorstring|nullMax 255.
abstractstring|nullMax 5000.
htmlstring|nullThe article body, max 1,000,000.
statusstringPublished (the default for a new article) or Draft.
published_atdate-time|nullThe date the website shows and sorts by. Defaults to now on create.
meta_titlestring|nullMax 255.
meta_descriptionstring|nullMax 1000.
no_indexboolean
categoriesstring[]Up to 50 category slugs, which must already exist. Sending the list replaces the article’s categories; [] removes them all.
media_idinteger|nullAn image in this organisation’s media library. Sets the banner and the card image; null removes it.

If a article with the same slug already exists, this returns 422. Use Upsert Article when you do not know whether it exists.

Headers

GorillaDash-Api-KeystringOptional
Gorilla Dash API Key
GorillaDash-Api-SecretstringOptional
Gorilla Dash API Secret

Request

This endpoint expects an object.
slugstringRequired
headingstringRequired
authorstringRequired
abstractstringRequired
htmlstringRequired
statusstringRequired
categorieslist of stringsRequired
published_atdatetimeRequired
meta_titlestringRequired
media_idintegerRequired

Response

Created
successboolean
statusinteger
dataobject

Errors

403
Forbidden Error
422
Unprocessable Entity Error