Force Refresh Comments

warning

Comment management is not available on the Basic plan. Upgrade to Intermediate, Growth or Business plan to access this endpoint.

Overview

The Force Refresh Comments endpoint triggers a manual refresh of comments from your connected social platforms. It returns the status of the batch job so you can track whether the refresh was started, is already running, or is on cooldown.

Base URL:

https://feed.oneupapp.io

Endpoint

POST /api/force-refresh-comments

Request Parameters

Parameter	Required	Description
apiKey	Yes	Your personal API key generated from the API Access page.

Sample Request

curl --location --request POST \
"https://feed.oneupapp.io/api/force-refresh-comments?apiKey=YOUR_API_KEY"

Sample Response

202 Accepted — Comment refresh successfully started:

{
  "message": "Comment refresh started.",
  "batch_id": "a2152aa3-6e6d-439b-9056-d2205f466003",
  "status": "started",
  "is_fetching": true,
  "percentage": 0,
  "total_jobs": 7,
  "pending_jobs": 7,
  "processed_jobs": 0,
  "failed_jobs": 0,
  "last_fetched_at": "2026-06-22T08:45:33+00:00"
}

409 Conflict — A refresh is already in progress:

{
  "message": "A comment refresh is already in progress.",
  "batch_id": "a2152a43-1d9d-415c-980a-fb971ee05e15",
  "status": "already_in_progress",
  "is_fetching": true,
  "percentage": 36,
  "last_fetched_at": "2026-06-22T08:44:30.000000Z"
}

429 Too Many Requests — Comments were recently refreshed and are on cooldown:

{
  "message": "Comments were recently refreshed. Please wait before refreshing again.",
  "status": "cooldown",
  "is_fetching": false,
  "last_fetched_at": "2026-06-22T08:41:02.000000Z",
  "remaining_seconds": 598,
  "next_refresh_available_at": "2026-06-22T08:51:01+00:00"
}

Response Fields

Field	Description
message	Human-readable status message.
batch_id	Unique identifier for the refresh batch job. Present on 202 and 409.
status	Current status: started, already_in_progress, or cooldown.
is_fetching	Whether a refresh is currently running.
percentage	Completion percentage of the current batch (0–100). Present on 202 and 409.
total_jobs	Total number of jobs in the batch. Present on 202.
pending_jobs	Number of jobs yet to be processed. Present on 202.
processed_jobs	Number of completed jobs. Present on 202.
failed_jobs	Number of failed jobs. Present on 202.
last_fetched_at	ISO 8601 timestamp of the most recent completed refresh.
remaining_seconds	Seconds remaining before the next refresh is allowed. Present on 429.
next_refresh_available_at	ISO 8601 timestamp of when the next refresh can be triggered. Present on 429.

Error Responses

HTTP Status	Status Value	Description
202	started	Refresh successfully initiated.
409	already_in_progress	A refresh is already running. Wait for it to complete.
429	cooldown	Comments were recently refreshed. Check remaining_seconds for when you can retry.

✅ Result: You have successfully triggered a comment refresh!