---
title: "POST /articles"
method: POST
path: "/articles"
tags: ["Articles"]
---

# POST /articles

`POST /articles`

Create a new article

## Request body

- object
  - `data` string — Request body data

## Response `200`

Return a new article

- Article[]
  - `id` string
  - `data` string
  - `owner` string
  - `version` number
  - `grants` Grant[]
    - `identifier` string
    - `permissions` string[]

## Other responses

- `401` — Invalid Token or not authorized
- `4XX` — Bad Request, invalid data
- `5XX` — Internal Server Error

## Changes

- **2026-07-17** `f125dd35c820` — 1 breaking, 10 info
  - removed the success response with the status `201`
  - the endpoint scheme security `OAuth2` was added to the API
  - api tag `Articles` added
  - api tag `Examples` removed
  - …7 more

[Change history](https://skmtc.dev/apress/apis/hydra-server/changes/articles/post.md)

---

[API](https://skmtc.dev/apress/apis/hydra-server.md) · [All operations](https://skmtc.dev/apress/apis/hydra-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apress/hydra-server/revisions/f125dd35c820/schema)
