---
title: "Update a single post"
method: PUT
path: "/posts/{id}.json"
tags: ["Posts"]
---

# Update a single post

`PUT /posts/{id}.json`

## Path parameters

- `id` string, required

## Request body

- object
  - `post` object
    - `raw` string, required
    - `edit_reason` string
  - `bypass_bump` boolean — Skip bumping the topic when updating the post. Requires staff or TL4 permissions.

## Response `200`

post updated

- object
  - `post` object, required
    - `id` integer, required
    - `username` string, required
    - `avatar_template` string, required
    - `created_at` string, required
    - `cooked` string, required
    - `post_number` integer, required
    - `post_type` integer, required
    - `posts_count` integer, required
    - `updated_at` string, required
    - `reply_count` integer, required
    - `reply_to_post_number` string, nullable, required
    - `quote_count` integer, required
    - `incoming_link_count` integer, required
    - `reads` integer, required
    - `readers_count` integer, required
    - `score` number, required
    - `yours` boolean, required
    - `topic_id` integer, required
    - `topic_slug` string, required
    - `primary_group_name` string, nullable, required
    - `flair_name` string, nullable, required
    - `flair_url` string, nullable, required
    - `flair_bg_color` string, nullable, required
    - `flair_color` string, nullable, required
    - `flair_group_id` integer, nullable
    - `badges_granted` unknown[]
      - unknown
    - `version` integer, required
    - `can_edit` boolean, required
    - `can_delete` boolean, required
    - `can_recover` boolean, required
    - `can_see_hidden_post` boolean
    - `can_wiki` boolean, required
    - `user_title` string, nullable, required
    - `bookmarked` boolean, required
    - `raw` string, required
    - `actions_summary` object[], required
      - `id` integer, required
      - `can_act` boolean, required
    - `moderator` boolean, required
    - `admin` boolean, required
    - `staff` boolean, required
    - `user_id` integer, required
    - `draft_sequence` integer, required
    - `hidden` boolean, required
    - `trust_level` integer, required
    - `deleted_at` string, nullable, required
    - `user_deleted` boolean, required
    - `edit_reason` string, nullable, required
    - `can_view_edit_history` boolean, required
    - `wiki` boolean, required
    - `reviewable_id` integer, nullable, required
    - `reviewable_score_count` integer, required
    - `reviewable_score_pending_count` integer, required
    - `post_url` string, required
    - `post_localizations` unknown[]
      - unknown
    - `mentioned_users` unknown[]
      - unknown
    - `name` string, nullable
    - `display_username` string, nullable

---

[API](https://skmtc.net/discourse/apis/discourse-api-documentation.md) · [All operations](https://skmtc.net/discourse/apis/discourse-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/discourse/discourse-api-documentation/versions/fb966f5bb63e/schema)