---
title: "Edit a post"
method: PATCH
path: "/posts/{post_id}"
---

# Edit a post

`PATCH /posts/{post_id}`

## Request

- Base URL: `https://api.bamf.ai/v1`
- URL: `https://api.bamf.ai/v1/posts/{post_id}`
- Auth: HTTP bearer

## Path parameters

- `post_id` string, required

## Headers

- `Idempotency-Key` string

## Request body

- UpdatePostRequest
  - `content` string
  - `topic` string
  - `first_comment` string
  - `post_type` 'text' | 'image' | 'carousel' | 'video' | 'article' | 'poll'
  - `platform` 'linkedin' | 'x' | 'twitter'

## Response `200`

Post updated

- PostResponse
  - `data` union
    - Post
      - `id` string
      - `author_id` string
      - `creator_id` string: Alias used by preview responses; raw post rows may use author_id.
      - `status_id` string, nullable
      - `post_type` 'text' | 'image' | 'carousel' | 'video' | 'article' | 'poll'
      - `platform` 'linkedin' | 'x' | 'twitter' | 'null', nullable
      - `content` string
      - `topic` string, nullable
      - `first_comment` string, nullable
      - `scheduled_for` string, date-time, nullable
      - `generated_image_url` string, nullable
      - `uploaded_image_url` string, nullable
      - `document_url` string, nullable
      - `video_url` string, nullable
      - `created_at` string, date-time, nullable
      - `updated_at` string, date-time, nullable
    - PostPreview
      - `id` string
      - `creator_id` string
      - `status_id` string, nullable
      - `post_type` 'text' | 'image' | 'carousel' | 'video' | 'article' | 'poll'
      - `content` string
      - `topic` string, nullable
      - `first_comment` PostFirstComment, nullable
        - `content` string
      - `scheduled_for` string, date-time, nullable
      - `media` PostPreviewMedia[]
        - `type` 'image' | 'carousel_slide' | 'video'
        - `url` string, nullable
        - `order` integer
        - `alt_text` string, nullable
      - `raw` Post
        - `id` string
        - `author_id` string
        - `creator_id` string: Alias used by preview responses; raw post rows may use author_id.
        - `status_id` string, nullable
        - `post_type` 'text' | 'image' | 'carousel' | 'video' | 'article' | 'poll'
        - `platform` 'linkedin' | 'x' | 'twitter' | 'null', nullable
        - `content` string
        - `topic` string, nullable
        - `first_comment` string, nullable
        - `scheduled_for` string, date-time, nullable
        - `generated_image_url` string, nullable
        - `uploaded_image_url` string, nullable
        - `document_url` string, nullable
        - `video_url` string, nullable
        - `created_at` string, date-time, nullable
        - `updated_at` string, date-time, nullable
    - unknown

---

[API](https://skmtc.dev/bamf/apis/bamf-developer-platform-api.md) · [All operations](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bamf/apis/bamf-developer-platform-api/revisions/a390dd3294bd?raw)