Skip to content

Replaces the body and metadata of an existing post, re-renders it, reconciles its media and topics, and records an edit history entry.

Only posts in published, unlisted, scheduled or pending state can be edited. The last five edits are kept in post meta. Survey posts are checked so existing options cannot be removed out from under voters. Passing new_space_id moves the post — and its activity rows — into another space, which requires community-admin rights in the destination and the author being a member of it; move_to_profile does the reverse. Sending media_images at all deactivates any media row not in the list.

Endpoint

  • Method: POST

  • Path: /feeds/{feed_id}

  • Edition: Core

  • Controller: FeedsController@update

  • Route source: fluent-community/app/Http/Routes/api.php:44

  • Controller source: fluent-community/app/Http/Controllers/FeedsController.php

  • The post author can always edit; anyone else needs the edit_any_feed permission globally or in the space.

Live sample

The request and response below were recorded against a running FluentCommunity install and then anonymised — member names, emails, avatars and post content are fictional, and long collections are trimmed to a few entries.

POST Update Feed

POST
/feeds/{feed_id}

Replaces the body and metadata of an existing post, re-renders it, reconciles its media and topics, and records an edit history entry.

Controller: FeedsController@update
Route source: fluent-community/app/Http/Routes/api.php:44

Authorizations

ApplicationPasswords

WordPress Application Passwords — use Basic auth with username:application_password.

Type
API Key (header: Authorization)

Parameters

Path Parameters

feed_id*

Feed ID extracted from the URL path.

Type
integer
Required

Request Body

application/json
JSON
{
  
"new_space_id": "string",
  
"move_to_profile": "string",
  
"survey": {
  
  
"options": [
  
  
  
"string"
  
  
],
  
  
"end_date": "string",
  
  
"type": "string"
  
},
  
"status": "string",
  
"send_announcement_email": "string",
  
"content_type": "string",
  
"media_images": "string",
  
"topic_ids": [
  
  
"string"
  
],
  
"message": "string",
  
"title": "string"
}

Responses

Successful response

application/json
JSON
{
  
"feed": {
  
  
"bookmarked": true,
  
  
"comments": [
  
  
  
{
  
  
  
  
"content_type": "string",
  
  
  
  
"created_at": "string",
  
  
  
  
"id": 0,
  
  
  
  
"is_sticky": 0,
  
  
  
  
"message": "string",
  
  
  
  
"message_rendered": "string",
  
  
  
  
"meta": [
  
  
  
  
  
{
  
  
  
  
  
  
"additionalProperties": "string"
  
  
  
  
  
}
  
  
  
  
],
  
  
  
  
"parent_id": "string",
  
  
  
  
"post_id": "string",
  
  
  
  
"reactions_count": "string",
  
  
  
  
"status": "string",
  
  
  
  
"type": "string",
  
  
  
  
"updated_at": "string",
  
  
  
  
"user_id": "string",
  
  
  
  
"xprofile": {
  
  
  
  
  
"avatar": "string",
  
  
  
  
  
"badge": "string",
  
  
  
  
  
"created_at": "string",
  
  
  
  
  
"display_name": "string",
  
  
  
  
  
"id": "string",
  
  
  
  
  
"is_verified": 0,
  
  
  
  
  
"last_activity": "string",
  
  
  
  
  
"meta": {
  
  
  
  
  
  
"badge_slug": "string",
  
  
  
  
  
  
"cover_photo": "string",
  
  
  
  
  
  
"social_links": {
  
  
  
  
  
  
  
"fb": "string",
  
  
  
  
  
  
  
"instagram": "string",
  
  
  
  
  
  
  
"linkedin": "string",
  
  
  
  
  
  
  
"twitter": "string",
  
  
  
  
  
  
  
"youtube": "string"
  
  
  
  
  
  
},
  
  
  
  
  
  
"website": "string"
  
  
  
  
  
},
  
  
  
  
  
"permalink": "string",
  
  
  
  
  
"short_description": "string",
  
  
  
  
  
"status": "string",
  
  
  
  
  
"total_points": 0,
  
  
  
  
  
"updated_at": "string",
  
  
  
  
  
"user_id": 0,
  
  
  
  
  
"username": "string"
  
  
  
  
}
  
  
  
}
  
  
],
  
  
"comments_count": 0,
  
  
"content_type": "string",
  
  
"created_at": "string",
  
  
"default_comment_sort_by": "string",
  
  
"expired_at": "string",
  
  
"featured_image": "string",
  
  
"has_user_react": true,
  
  
"id": 0,
  
  
"is_sticky": 0,
  
  
"message": "string",
  
  
"message_rendered": "string",
  
  
"meta": {
  
  
  
"last_edited": {
  
  
  
  
"time": "string",
  
  
  
  
"user_id": 0
  
  
  
}
  
  
},
  
  
"parent_id": "string",
  
  
"permalink": "string",
  
  
"priority": 0,
  
  
"privacy": "string",
  
  
"reactions_count": 0,
  
  
"scheduled_at": "string",
  
  
"slug": "string",
  
  
"space": {
  
  
  
"cover_photo": "string",
  
  
  
"created_at": "string",
  
  
  
"created_by": "string",
  
  
  
"description": "string",
  
  
  
"id": 0,
  
  
  
"logo": "string",
  
  
  
"parent_id": "string",
  
  
  
"privacy": "string",
  
  
  
"serial": "string",
  
  
  
"settings": {
  
  
  
  
"can_request_join": "string",
  
  
  
  
"custom_lock_screen": "string",
  
  
  
  
"default_comment_sort_by": "string",
  
  
  
  
"default_post_sort_by": "string",
  
  
  
  
"disable_layout_style": "string",
  
  
  
  
"disable_post_sort_by": "string",
  
  
  
  
"document_access": "string",
  
  
  
  
"document_library": "string",
  
  
  
  
"document_upload": "string",
  
  
  
  
"emoji": "string",
  
  
  
  
"hide_members_count": "string",
  
  
  
  
"layout_style": "string",
  
  
  
  
"links": [
  
  
  
  
  
{
  
  
  
  
  
  
"additionalProperties": "string"
  
  
  
  
  
}
  
  
  
  
],
  
  
  
  
"media_access": "string",
  
  
  
  
"media_gallery": "string",
  
  
  
  
"members_page_status": "string",
  
  
  
  
"og_image": "string",
  
  
  
  
"restricted_post_only": "string",
  
  
  
  
"shape_svg": "string",
  
  
  
  
"show_paywalls": "string",
  
  
  
  
"show_sidebar": "string",
  
  
  
  
"topic_required": "string"
  
  
  
},
  
  
  
"slug": "string",
  
  
  
"status": "string",
  
  
  
"title": "string",
  
  
  
"type": "string",
  
  
  
"updated_at": "string"
  
  
},
  
  
"space_id": "string",
  
  
"status": "string",
  
  
"title": "string",
  
  
"type": "string",
  
  
"updated_at": "string",
  
  
"user_id": "string",
  
  
"xprofile": {
  
  
  
"avatar": "string",
  
  
  
"badge": "string",
  
  
  
"created_at": "string",
  
  
  
"display_name": "string",
  
  
  
"id": "string",
  
  
  
"is_verified": 0,
  
  
  
"last_activity": "string",
  
  
  
"meta": {
  
  
  
  
"badge_slug": "string",
  
  
  
  
"cover_photo": "string",
  
  
  
  
"social_links": {
  
  
  
  
  
"fb": "string",
  
  
  
  
  
"instagram": "string",
  
  
  
  
  
"linkedin": "string",
  
  
  
  
  
"twitter": "string",
  
  
  
  
  
"youtube": "string"
  
  
  
  
},
  
  
  
  
"website": "string"
  
  
  
},
  
  
  
"permalink": "string",
  
  
  
"short_description": "string",
  
  
  
"status": "string",
  
  
  
"total_points": 0,
  
  
  
"updated_at": "string",
  
  
  
"user_id": 0,
  
  
  
"username": "string"
  
  
}
  
},
  
"message": "string"
}

Playground

Authorization
Variables
Key
Value
Body

Samples

Powered by VitePress OpenAPI

FluentCommunity developer documentation