> ## Documentation Index > Fetch the complete documentation index at: https://docs.notifuse.com/llms.txt > Use this file to discover all available pages before exploring further. # Update a blog post > Replaces a post's metadata. This is not a patch: optional fields left out are cleared, so send the post back with your changes applied. To change the body, update the template with `templates.update`, which saves a new template version. A post pinned to a `template_version` keeps rendering the old one until you update the post with the new version; a post at version `0` follows the latest version on its own, within the 5-minute page cache. Requires the blog write permission. ## OpenAPI ````yaml /openapi.json post /api/blogPosts.update openapi: 3.0.3 info: title: Notifuse API description: API for Notifuse - a transactional email and newsletter management platform version: 1.0.0 contact: name: Notifuse Support url: https://www.notifuse.com/support email: hello@notifuse.com license: name: BUSL-1.1 url: https://github.com/Notifuse/notifuse/blob/main/LICENSE servers: - url: https://{notifuseDomain} description: Customer-specific Notifuse API server variables: notifuseDomain: description: Your unique Notifuse domain default: demo.notifuse.com security: [] paths: /api/blogPosts.update: post: tags: - Blog summary: Update a blog post description: > Replaces a post's metadata. This is not a patch: optional fields left out are cleared, so send the post back with your changes applied. To change the body, update the template with `templates.update`, which saves a new template version. A post pinned to a `template_version` keeps rendering the old one until you update the post with the new version; a post at version `0` follows the latest version on its own, within the 5-minute page cache. Requires the blog write permission. operationId: updateBlogPost parameters: - name: workspace_id in: query required: true schema: type: string description: The ID of the workspace. Passed in the query string, not the body. example: ws_1234567890 requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/UpdateBlogPostRequest' responses: '200': description: Post updated content: application/json: schema: $ref: '#/components/schemas/BlogPostResponse' '400': description: >- Bad request - validation failed, slug taken, or post or category not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: 'post not found: blog post not found' '401': description: Unauthorized - invalid or missing authentication token content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Forbidden - missing the blog write permission content: application/json: schema: $ref: '#/components/schemas/PermissionErrorResponse' example: error: 'Insufficient permissions: write access to blog required' resource: blog permission: write security: - BearerAuth: [] components: schemas: UpdateBlogPostRequest: allOf: - type: object required: - id description: >- A full replacement, not a patch: every optional field omitted here is cleared, including `template_version`, which falls back to `0` (latest version). Send the post back with your changes applied. properties: id: type: string example: 1b4e28ba-2fa1-11d2-883f-0016d3cca427 - $ref: '#/components/schemas/CreateBlogPostRequest' BlogPostResponse: type: object required: - post properties: post: $ref: '#/components/schemas/BlogPost' ErrorResponse: type: object properties: error: type: string description: Error message required: - error PermissionErrorResponse: type: object description: >- Returned with a 403 when the user or API key lacks the permission the endpoint requires. properties: error: type: string description: Error message resource: type: string description: The permission resource the endpoint requires. example: blog permission: type: string enum: - read - write description: The access level the endpoint requires on that resource. required: - error - resource - permission CreateBlogPostRequest: type: object required: - category_id - slug - title - template_id properties: category_id: type: string description: An existing category. example: 7c9e6679-7425-40de-944b-e07fc1f90ae7 slug: type: string maxLength: 100 pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$ description: >- Lowercase letters, digits and single hyphens. Must be unique across the whole workspace, not just within the category. example: october-release title: type: string maxLength: 500 example: What shipped in October template_id: type: string description: >- A web template (`channel: web`) holding the post body — create it first with `templates.create`. Its existence is not checked here: a post pointing at a missing template is saved and renders with an empty body. example: blog_october_release template_version: type: integer default: 0 description: >- The template version to render. Omit it (or send `0`) to always render the template's latest version; pin a version to control exactly when a template edit reaches readers. example: 1 excerpt: type: string example: A faster editor, scheduled broadcasts and a new API. featured_image_url: type: string example: https://cdn.example.com/blog/october.png authors: type: array items: $ref: '#/components/schemas/BlogAuthor' reading_time_minutes: type: integer example: 4 seo: $ref: '#/components/schemas/SEOSettings' BlogPost: type: object required: - id - category_id - slug - settings - created_at - updated_at properties: id: type: string description: Server-generated UUID. example: 1b4e28ba-2fa1-11d2-883f-0016d3cca427 category_id: type: string example: 7c9e6679-7425-40de-944b-e07fc1f90ae7 slug: type: string description: >- The post's path segment on the blog (`/{category_slug}/{post_slug}`). example: october-release settings: type: object required: - title - template - reading_time_minutes properties: title: type: string description: The post's H1. example: What shipped in October template: type: object required: - template_id - template_version description: The web template holding the post body. properties: template_id: type: string example: blog_october_release template_version: type: integer description: >- The template version the post renders. `0` means the latest version, whatever it is at render time. example: 3 excerpt: type: string example: A faster editor, scheduled broadcasts and a new API. featured_image_url: type: string example: https://cdn.example.com/blog/october.png authors: type: array nullable: true items: $ref: '#/components/schemas/BlogAuthor' reading_time_minutes: type: integer description: Displayed as given; not computed from the body. example: 4 seo: $ref: '#/components/schemas/SEOSettings' published_at: type: string format: date-time description: Absent while the post is a draft. example: '2026-10-01T09:00:00Z' created_at: type: string format: date-time updated_at: type: string format: date-time BlogAuthor: type: object required: - name properties: name: type: string example: Jane Doe avatar_url: type: string example: https://cdn.example.com/avatars/jane.png SEOSettings: type: object description: Search and social metadata for the page, exposed to the blog theme. properties: meta_title: type: string example: Release notes for October meta_description: type: string example: Everything that shipped this month. og_title: type: string description: Open Graph title og_description: type: string description: Open Graph description og_image: type: string description: Open Graph image URL example: https://cdn.example.com/og/october.png canonical_url: type: string example: https://blog.example.com/product/october-release keywords: type: array items: type: string example: - release - changelog meta_robots: type: string description: Content of the robots meta tag. example: index,follow securitySchemes: BearerAuth: type: http scheme: bearer description: API token for authentication ````