Edit a post

Edit changes a post after it went live, where the network allows it. Most networks let you change only the text; a few take more. To change a post that hasn't gone out yet, edit the scheduled post instead.

Edit a post Reelspan published

Name the post by its request_id (and platform when it went to several networks) and send the new text:

curl -X POST https://api.reelspan.com/v1/posts/edit \
  -H "Authorization: Bearer $REELSPAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_id": "9b1f6c2e8a3d4f50b7e1c9a2d6f3e8b1",
    "platform": "linkedin",
    "text": "We are hiring two engineers in Lisbon. Details and the application form are in the comments."
  }'

import { Reelspan } from 'reelspan';

const reelspan = new Reelspan();
const edited = await reelspan.request('POST', '/v1/posts/edit', {
  json: {
    request_id: '9b1f6c2e8a3d4f50b7e1c9a2d6f3e8b1',
    platform: 'linkedin',
    text: 'We are hiring two engineers in Lisbon. Details and the application form are in the comments.',
  },
});

from reelspan import Reelspan

reelspan = Reelspan()
edited = reelspan.request("POST", "/v1/posts/edit", json_body={
    "request_id": "9b1f6c2e8a3d4f50b7e1c9a2d6f3e8b1",
    "platform": "linkedin",
    "text": "We are hiring two engineers in Lisbon. Details and the application form are in the comments.",
})

{
  "success": true,
  "platform": "linkedin",
  "post_id": "urn:li:share:72…",
  "url": "https://www.linkedin.com/feed/update/urn:li:share:72…/"
}

message and commentary work as other names for text. For a post made outside Reelspan, name it with platform, user and the network's post_id instead, as on Unpublish.

What you can send

Send only what changes. A request that changes nothing the network can change gets 400 text_required.

Which networks, and what changes

Instagram, TikTok, Threads, YouTube and Bluesky posts can't be edited through Reelspan, and Reddit posts aren't supported either. Asking gets 400 platform_not_supported, with the networks that work in supported_platforms.

X: an edit is a new post

X makes an edited post a new post that replaces the old one, so the id changes. The answer gives the new id as post_id, the old one as previous_post_id, and X's list of every version as edit_history_post_ids:

{
  "success": true,
  "platform": "x",
  "post_id": "1854123456789099999",
  "url": "https://x.com/mybrand/status/1854123456789099999",
  "previous_post_id": "1854123456789012345",
  "edit_history_post_ids": ["1854123456789012345", "1854123456789099999"]
}

For a post Reelspan published, the stored post follows the new id, so Post status and analytics use it from then on. Links are removed from the new text, as when posting, unless fields.x_keep_links is "true"; keeping them uses one of your plan's X link posts for the month, and when the allowance is used up they are removed anyway. See Links in X posts.

After an edit

For a post Reelspan published, the network's result in Post status carries edited_at and edits (how many times it was edited), and on X previous_post_ids. warnings in the answer lists anything changed on the way, such as text cut to fit.

Errors

Editing needs a key with the publish scope.