Skip to main content
POST
/
v1
/
articles
Create an Article
curl --request POST \
  --url https://api.siit.io/v1/articles \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "<string>",
  "subtitle": "<string>",
  "body": "<string>",
  "external_url": "<string>",
  "category": "<string>",
  "author": "<string>"
}
'
{
  "result": {
    "uid": "<string>",
    "archived_at": "2023-11-07T05:31:56Z",
    "author": "<string>",
    "author_uid": "<string>",
    "body": "<string>",
    "category": "<string>",
    "category_uid": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "external_url": "<string>",
    "last_editor": "<string>",
    "last_editor_uid": "<string>",
    "published": true,
    "source": "external",
    "subtitle": "<string>",
    "title": "<string>",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

Introduction

This endpoint allows you to create a new article. Please note that those will have a source marked as external and can only be managed through the API.
  1. Articles created via this endpoint will be automatically published, and thus might be picked by the Siit Bot.
  2. Category will be the default one when not provided.

Usage

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Request body for creating or updating an Article. Pass UIDs (not objects) for relationship fields.

title
string
subtitle
string | null
body
string

Text content of the article

external_url
string | null

URL that the article redirects to

category
string

The category of this article. Pass the UID of the related object.

author
string | null

The user who creates the article (only honored on create — defaults to current user). Pass the UID of the related object.

Response

201 - application/json

Article created

result
object