Content

Creates a post directly without generation. Omit markdown to create an empty draft you fill in later through the dashboard or PATCH /v1/posts/{postId}. Slugs are only accepted for blog posts and changelogs.

post/v1/posts

Request

  • Base URL
    https://api.usenotra.com
  • Auth
    HTTP bearer

Request body

titlestring required
contentType'blog_post' | 'changelog' | 'linkedin_post' | 'twitter_post' required
slugstring nullable
markdownstring
status'draft' | 'published'

Example request

{
  "title": "Ship notes for week 11",
  "contentType": "blog_post",
  "slug": "ship-notes-week-11",
  "status": "draft"
}

Response

Post created successfully

Example response

{
  "post": {
    "metadata": {
      "coverImage": {
        "url": "https://cdn.example.com/covers/ship-notes.png",
        "alt": "Screenshot of the new editor"
      },
      "tags": [
        "editor",
        "performance"
      ],
      "excerpt": "The editor now opens twice as fast on long posts.",
      "authors": [
        {
          "id": "auth_8f2kq1",
          "slug": "jane-doe",
          "name": "Jane Doe",
          "title": "Head of Product",
          "avatarUrl": "https://cdn.example.com/avatars/jane.png",
          "url": "https://janedoe.dev",
          "x": "https://x.com/janedoe"
        }
      ],
      "displayDate": "2026-10-01"
    }
  }
}

Changes

    • info

      added the required property //// to the response with the status

    • info

      added the required property //// to the response with the status

    • info

      added the required property //// to the response with the status

    • info

      added the required property //// to the response with the status

    • info

      added the required property //// to the response with the status

    • info

      added the required property //// to the response with the status

    • info

      added the required property //// to the response with the status

    • info

      added the required property //// to the response with the status

    • info

      added the required property //// to the response with the status

    • info

      added the required property // to the response with the status