Posts

Update a single post

PUT

https://discourse.example.com/posts/{id}.json

curl -X PUT 'https://discourse.example.com/posts/string.json' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "post": {
    "raw": "string",
    "edit_reason": "string"
  },
  "bypass_bump": true
}'

const body = `{
  "post": {
    "raw": "string",
    "edit_reason": "string"
  },
  "bypass_bump": true
}`;

const response = await fetch('https://discourse.example.com/posts/string.json', {
  method: 'PUT',
  headers: {
    'Content-Type': 'application/json',
  },
  body,
});

const data = await response.text();

import requests

body = '''{
  "post": {
    "raw": "string",
    "edit_reason": "string"
  },
  "bypass_bump": true
}'''

response = requests.put(
    'https://discourse.example.com/posts/string.json',
    data=body.encode('utf-8'),
    headers={
        'Content-Type': 'application/json',
    },
)
print(response.text)

Request Body

{
  "post": {
    "raw": "string",
    "edit_reason": "string"
  },
  "bypass_bump": true
}

200

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

Body

application/json

postobject

Show child attributes

rawstringrequired

edit_reasonstring

bypass_bumpboolean

Skip bumping the topic when updating the post. Requires staff or TL4 permissions.

Parameters

idstringrequiredpath

Response

200OKany

post updated

Response fields application/json

postobjectrequired

Show child attributes

idintegerrequired

usernamestringrequired

avatar_templatestringrequired

created_atstringrequired

cookedstringrequired

post_numberintegerrequired

post_typeintegerrequired

posts_countintegerrequired

updated_atstringrequired

reply_countintegerrequired

reply_to_post_numberstring | nullrequired

quote_countintegerrequired

incoming_link_countintegerrequired

readsintegerrequired

readers_countintegerrequired

scorenumberrequired

yoursbooleanrequired

topic_idintegerrequired

topic_slugstringrequired

primary_group_namestring | nullrequired

flair_namestring | nullrequired

flair_urlstring | nullrequired

flair_bg_colorstring | nullrequired

flair_colorstring | nullrequired

flair_group_idinteger | null

badges_grantedArray<any>

versionintegerrequired

can_editbooleanrequired

can_deletebooleanrequired

can_recoverbooleanrequired

can_see_hidden_postboolean

can_wikibooleanrequired

user_titlestring | nullrequired

bookmarkedbooleanrequired

rawstringrequired

actions_summaryArray<object>required

Show child attributes

idintegerrequired

can_actbooleanrequired

moderatorbooleanrequired

adminbooleanrequired

staffbooleanrequired

user_idintegerrequired

draft_sequenceintegerrequired

hiddenbooleanrequired

trust_levelintegerrequired

deleted_atstring | nullrequired

user_deletedbooleanrequired

edit_reasonstring | nullrequired

can_view_edit_historybooleanrequired

wikibooleanrequired

reviewable_idinteger | nullrequired

reviewable_score_countintegerrequired

reviewable_score_pending_countintegerrequired

post_urlstringrequired

post_localizationsArray<any>

mentioned_usersArray<any>

namestring | null

display_usernamestring | null

Docs by Sourcey