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