Manage Scheduled & Published Social Posts
posts_manageList, inspect, update, mutate, delete, or retry scheduled, queued, and published social media posts stored in Nuntior Cloud — including live real-time YouTube video/Short title and hashtag/tag updates via YouTube Data API v3 (PUT /youtube/v3/videos?part=snippet) while keeping the existing description 100% intact unless content is explicitly changed, and custom YouTube thumbnail updates via POST /upload/youtube/v3/thumbnails/set (thumbnailMediaAssetId / thumbnailUrl) that do not rewrite title, description, or tags. Also tracks 72h hook iteration metadata (rewriteCount, hookHistory, lastViewCount, iterationStatus, lessonsLearned).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>"
},
"name": "posts_manage"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | Updated hashtags/tags for the post or video. | |
| title | No | Updated video/post title (e.g., for YouTube Shorts title & hook iteration while keeping the description intact). | |
| action | Yes | Post management operation: 'list' posts (optionally filtered by status), 'get' a single post by `postId` or `externalPostId` (with live YouTube view/like/comment counts and age in hours), 'update' / 'mutate' post content, YouTube title/tags, YouTube custom thumbnail, or schedule time, 'delete' a post, or 'retry_failed' to re-dispatch failed deliveries. | |
| lesson | No | Optional performance lesson note saved on the post when closing an iteration loop. | |
| postId | No | Unique post identifier (`post_...`). Required when `action` is 'get', 'update', 'mutate', or 'delete' unless `externalPostId` is provided. | |
| content | No | Updated post text content or video description when executing `action: 'update'` or `'mutate'` (omit to keep the existing YouTube description 100% intact). | |
| hookStyle | No | Optional hook rotation label ('opinion', 'data', 'question') tracked in `hookHistory` (with `rewriteCount` incremented automatically). | |
| profileId | No | Brand profile identifier (`prof_...`) used to scope the post query or mutation. | prof_allometrik |
| scheduledFor | No | Updated ISO-8601 publication timestamp when rescheduling a post via `action: 'update'`. | |
| statusFilter | No | Optional status filter when listing posts (e.g. 'published', 'scheduled', 'queued', 'failed', 'draft'). | |
| thumbnailUrl | No | Public image URL (JPEG/PNG/GIF/BMP/WebP) to set as the custom thumbnail on a published YouTube video via `thumbnails.set`. Prefer `thumbnailMediaAssetId` when the file is already in Nuntior `/media`. Same no-snippet-rewrite contract as `thumbnailMediaAssetId`. | |
| externalPostId | No | Optional native platform video/post ID (e.g. YouTube `videoId`) to inspect or update directly on the platform even if originally uploaded outside Nuntior. | |
| iterationStatus | No | Optional iteration loop status ('active', 'thriving', 'closed'). | |
| preserveDescription | No | Keep the original description untouched when updating a published video's title/tags (default `true` when `title` is provided without `content`). | |
| thumbnailMediaAssetId | No | Nuntior image media asset (`med_...`) to set as the custom thumbnail on a published YouTube video via `POST /upload/youtube/v3/thumbnails/set`. Preferred over `thumbnailUrl`. Does not call `videos.update` and does not alter title, description, or tags unless those fields are also passed. Requires a connected YouTube channel with upload scope. Channel must be verified for custom thumbnails. |