POST/posts

Create post

Create a new post. Fields `id`, `createdAt`, `updatedAt` are auto-generated. Triggers `posts.created` webhook.

ReturnsPost

AcceptsPostInput

Bearer token required

Response examples

201Post created

application/json example derived from schema

{
  "id": 1,
  "userId": 1,
  "title": "Performance Optimization Tips",
  "slug": "web-security-fundamentals",
  "body": "Fusce commodo aliquam arcu. Nam commodo suscipit quam. Quisque id odio.\n\nCurabitur pretium tincidunt lacus. Nulla gravida orci a odio. Nullam varius, turpis et commodo pharetra.",
  "excerpt": "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliq...",
  "tags": [
    "ux"
  ],
  "status": "published",
  "views": 16848,
  "likes": 28,
  "featured": false,
  "coverImage": "https://picsum.photos/seed/1/800/400",
  "readingTime": 7,
  "createdAt": "2026-01-21T19:36:04.116Z",
  "updatedAt": "2026-01-21T19:36:04.116Z"
}

400400 — invalid input or malformed JSON

application/json

{
  "error": {
    "status": 400,
    "message": "Request body required"
  }
}

413413 — body exceeds 64 KB

application/json

{
  "error": {
    "status": 413,
    "message": "Request body too large",
    "details": {
      "maxSize": "64 KB"
    }
  }
}

429429 — rate limit exceeded (120/60s)

application/json

{
  "error": {
    "status": 429,
    "message": "Too many requests",
    "details": {
      "retryAfter": 45
    }
  }
}

Try ItMock API v2.0.1

Code examples

curl -X POST -H 'Authorization: Bearer <TOKEN>' -H 'Content-Type: application/json' -d '{
  "userId": 1,
  "title": "TypeScript tips I learned the hard way",
  "body": "First, never use `any`…",
  "excerpt": "Ten hard-won lessons from the trenches.",
  "tags": [
    "typescript",
    "engineering"
  ],
  "status": "draft"
}' 'https://api.rodin.dev/mock/posts'

fetch("https://api.rodin.dev/mock/posts", {
  method: "POST",
  headers: {
      "Authorization": "Bearer <TOKEN>",
      "Content-Type": "application/json"
    },
  body: "{\n  \"userId\": 1,\n  \"title\": \"TypeScript tips I learned the hard way\",\n  \"body\": \"First, never use `any`…\",\n  \"excerpt\": \"Ten hard-won lessons from the trenches.\",\n  \"tags\": [\n    \"typescript\",\n    \"engineering\"\n  ],\n  \"status\": \"draft\"\n}",
})
  .then((response) => response.json())
  .then((data) => console.log(data))

import requests

url = "https://api.rodin.dev/mock/posts"
headers = {
    "Authorization": "Bearer <TOKEN>",
    "Content-Type": "application/json"
}
data = "{\n  \"userId\": 1,\n  \"title\": \"TypeScript tips I learned the hard way\",\n  \"body\": \"First, never use `any`…\",\n  \"excerpt\": \"Ten hard-won lessons from the trenches.\",\n  \"tags\": [\n    \"typescript\",\n    \"engineering\"\n  ],\n  \"status\": \"draft\"\n}"

response = requests.post(url, headers=headers, data=data)
print(response.json())

Authentication

Authentication

Bearer token

Paste cURL

Server:

https://api.rodin.dev/mockhttp://localhost:3002

Body:

{ "userId": 1, "title": "TypeScript tips I learned the hard way", "body": "First, never use `any`…", "excerpt": "Ten hard-won lessons from the trenches.", "tags": [ "typescript", "engineering" ], "status": "draft" }