Skip to main content

Preview and delete posts

Deletion filters go in the JSON body, not the query string.

Use DELETE /queue for upcoming scheduled posts. Use DELETE /posts for explicit post IDs or broader filters; it requires the manage_team scope and accepts at most 500 matching posts per call.

1. Preview the selection​

Replace the channel ID with one from GET /channels:

curl -X DELETE 'https://api.socialchamp.com/v1/rest/queue' \
  -H "Authorization: Bearer $SOCIALCHAMP_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"channelIds":["6512f0a1b2c3d4e5f6a7b8c9"],"dryRun":true}'

This reports the matching count without deleting posts. Omitting dryRun also previews.

2. Delete the matching posts​

After checking the preview, send the same filters with "dryRun": false. This deletes matching posts and cancels their scheduled publishing jobs. The matching set may change between preview and execution; the preview is not a reserved snapshot.

For DELETE /queue, execution requires channel IDs or both fromDate and toDate. Do not send only dryRun: false. Queue deletion defaults fromDate to the current time.

Remove labels without deleting a post​

Send labelIds in the JSON body to DELETE /posts/{postId}/labels. You may also send workspaceId. This removes those labels from the post. An empty labelIds array clears all labels.

See the API reference for complete filters and response handling for partial or uncertain outcomes.

Last updated on