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

Response

201 - application/json

Article created

The response is of type object.