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>",
  "external_url": "<string>",
  "body": "<string>",
  "category_uid": "<string>"
}
'
{
  "result": {
    "uid": "<string>",
    "title": "<string>",
    "subtitle": "<string>",
    "source": "external",
    "author_uid": "<string>",
    "last_editor_uid": "<string>",
    "published": true,
    "external_url": "<string>",
    "body": "<string>",
    "category_uid": "<string>",
    "category": {
      "uid": "<string>",
      "name": "<string>"
    },
    "archived_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "created_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
​
title
string
​
subtitle
string | null
​
external_url
string | null

URL that the article redirects to

​
body
string

Text content of the article

​
category_uid
string

Response

201 - application/json

Article created

​
result
object