post/update

Refreshes post engagement and related fields.

Overview

Use this endpoint to update platform-specific engagement values for an existing post.

Authentication

Authentication is required. See Authentication.

Permissions

Authentication is required.

Endpoint

post/update

Purpose

Executes a platform branch by {post_type} and writes updated values.

Method and path

POST /post/update/{post_type}

Headers

Header	Required	Description
X-Api-Key or X_API_KEY	yes	API key.
Content-Type	yes	application/json.

Request body

Field	Type	Required	Description
project_id	integer	yes	Target project id.
uuid	string	yes	Post identifier.
url	string	yes	Source URL used by some platform flows.
Platform fields	mixed	no	Example: ig_comments, ig_likes, user_screenname, img.

Example request

curl -X POST "$SIGNAL_API_BASE_URL/post/update/ig" \
  -H "X-Api-Key: $SIGNAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "project_id": 123,
    "uuid": "<post_uuid>",
    "ig_comments": 12,
    "ig_likes": 240
  }'

{
  "project_id": 123,
  "uuid": "abc123",
  "url": "https://instagram.com/p/example",
  "ig_comments": 12,
  "ig_likes": 240
}

Example response

{
  "uuid": "abc123"
}

Notes

• Observed {post_type} branches: ig, fb, tw, wb, wn, wf.