Create a post
Changed onCreates 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.
Request
- Base URLhttps://api.usenotra.com
- AuthHTTP bearer
Request body
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
- info
added the required property
//to the response with the status
- info