posterly-mcp-server 0.46.0 → 0.47.0

package/README.md

@@ -123,7 +123,7 @@ Add the same server definition to your Cursor MCP settings:
 
 ## Available tools
 
-`posterly-mcp-server@0.46.0` exposes 62 tools covering 94 actions. The hosted HTTP endpoint exposes the same catalog minus the three signup tools: 59 tools covering 91 actions.
+`posterly-mcp-server@0.47.0` exposes 62 tools covering 95 actions. The hosted HTTP endpoint exposes the same catalog minus the three signup tools: 59 tools covering 92 actions.
 
 Many tools pick what to do with one parameter: `view` (reads), `action` (writes), or `type`. A few pick their mode from which parameters you pass (for example `update_post` with `status` changes the status instead of editing). Every tool description names all of its views and actions.
 
@@ -211,13 +211,14 @@ Accounts, posting, media, schedule, analytics, and support. What most assistants
 | `edit` (default) | Edit caption, media, schedule, or settings |
 | `status` (pass `status`) | Pause, resume, schedule, or move to draft |
 | `release_id` (pass `release_id`) | Set a release or group ID |
+| `approval` (pass `approval_action`) | Request, approve, request changes, or reject client review (owner or admin only) |
 
 **`delete_post`**: Delete posts
 
 | Mode (picked by params) | What it does |
 | --- | --- |
-| `post` (default) | Delete one post |
-| `group` (pass `group_id`) | Delete a post group (preview then confirm) |
+| `post` (default) | Delete one post. Published Instagram or Facebook posts also need `confirm_published` |
+| `group` (pass `group_id`) | Delete a post group (preview then confirm). Never deletes published posts |
 
 **`upload_media`**: Upload media
 

package/dist/lib/api-client.d.ts

@@ -145,6 +145,7 @@ export interface ApiPostApproval {
     asset_status: ApiPostApprovalStatus;
     caption_status: ApiPostApprovalStatus;
     waiting_on: 'client' | 'team' | null;
+    pending_client_approval: boolean;
     requested_at: string | null;
     completed_at: string | null;
 }
@@ -1212,6 +1213,7 @@ export declare class PosterlyClient {
         offset?: number;
         workspace_id?: string;
         approval_status?: string;
+        approval_waiting_on?: string;
         brand_id?: string;
     }): Promise<{
         posts: Post[];
@@ -1244,10 +1246,18 @@ export declare class PosterlyClient {
     }): Promise<{
         post: Post;
     }>;
-    deletePost(id: number): Promise<{
+    deletePost(id: number, options?: {
+        confirmPublished?: boolean;
+    }): Promise<{
         deleted: boolean;
         id: number;
+        platform_delete?: string;
     }>;
+    setPostApproval(id: number, data: {
+        action: 'request' | 'approve' | 'request_changes' | 'reject';
+        axis?: 'asset' | 'caption';
+        note?: string;
+    }): Promise<Record<string, unknown>>;
     updatePostStatus(id: number, data: {
         status: 'scheduled' | 'paused' | 'draft';
         scheduled_at?: string;

package/dist/lib/api-client.js

@@ -340,6 +340,8 @@ export class PosterlyClient {
             searchParams.set('workspace_id', params.workspace_id);
         if (params?.approval_status)
             searchParams.set('approval_status', params.approval_status);
+        if (params?.approval_waiting_on)
+            searchParams.set('approval_waiting_on', params.approval_waiting_on);
         if (params?.brand_id)
             searchParams.set('brand_id', params.brand_id);
         const qs = searchParams.toString();
@@ -375,8 +377,16 @@ export class PosterlyClient {
     async updatePost(id, data) {
         return this.request('PATCH', `/posts/${id}`, data);
     }
-    async deletePost(id) {
-        return this.request('DELETE', `/posts/${id}`);
+    async deletePost(id, options) {
+        const qs = options?.confirmPublished ? '?confirm_published=true' : '';
+        return this.request('DELETE', `/posts/${id}${qs}`);
+    }
+    async setPostApproval(id, data) {
+        return this.request('POST', `/posts/${id}/approval`, {
+            action: data.action,
+            ...(data.axis ? { axis: data.axis } : {}),
+            ...(data.note ? { note: data.note } : {}),
+        });
     }
     async updatePostStatus(id, data) {
         return this.request('PUT', `/posts/${id}/status`, data);

package/dist/lib/version.d.ts

@@ -1 +1 @@
-export declare const POSTERLY_MCP_VERSION = "0.46.0";
+export declare const POSTERLY_MCP_VERSION = "0.47.0";

package/dist/lib/version.js

@@ -5,4 +5,4 @@
 // tool set (minus the intentional pre-auth signup tools that only this stdio
 // package exposes). `npm run check:mcp-parity` enforces both the version match
 // and the tool-list match, and runs in the pre-commit hook.
-export const POSTERLY_MCP_VERSION = '0.46.0';
+export const POSTERLY_MCP_VERSION = '0.47.0';

package/dist/tools/create-post.d.ts

@@ -972,11 +972,11 @@ export declare const createPostPayloadInputSchema: z.ZodObject<{
     username?: string | undefined;
     workspace_id?: string | undefined;
     account_id?: string | undefined;
+    caption?: string | undefined;
     scheduled_at?: string | undefined;
     media_url?: string | undefined;
     media_urls?: string[] | undefined;
     post_type?: string | undefined;
-    caption?: string | undefined;
     thread_posts?: string[] | undefined;
     instagram_settings?: {
         post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
@@ -1135,11 +1135,11 @@ export declare const createPostPayloadInputSchema: z.ZodObject<{
     username?: string | undefined;
     workspace_id?: string | undefined;
     account_id?: string | undefined;
+    caption?: string | undefined;
     scheduled_at?: string | undefined;
     media_url?: string | undefined;
     media_urls?: string[] | undefined;
     post_type?: string | undefined;
-    caption?: string | undefined;
     thread_posts?: string[] | undefined;
     instagram_settings?: {
         post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
@@ -1791,11 +1791,11 @@ export declare const createPostInputSchema: z.ZodObject<{
     username?: string | undefined;
     workspace_id?: string | undefined;
     account_id?: string | undefined;
+    caption?: string | undefined;
     scheduled_at?: string | undefined;
     media_url?: string | undefined;
     media_urls?: string[] | undefined;
     post_type?: string | undefined;
-    caption?: string | undefined;
     thread_posts?: string[] | undefined;
     instagram_settings?: {
         post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
@@ -1955,11 +1955,11 @@ export declare const createPostInputSchema: z.ZodObject<{
     username?: string | undefined;
     workspace_id?: string | undefined;
     account_id?: string | undefined;
+    caption?: string | undefined;
     scheduled_at?: string | undefined;
     media_url?: string | undefined;
     media_urls?: string[] | undefined;
     post_type?: string | undefined;
-    caption?: string | undefined;
     thread_posts?: string[] | undefined;
     instagram_settings?: {
         post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
@@ -2640,11 +2640,11 @@ export declare const createPostTool: {
         username?: string | undefined;
         workspace_id?: string | undefined;
         account_id?: string | undefined;
+        caption?: string | undefined;
         scheduled_at?: string | undefined;
         media_url?: string | undefined;
         media_urls?: string[] | undefined;
         post_type?: string | undefined;
-        caption?: string | undefined;
         thread_posts?: string[] | undefined;
         instagram_settings?: {
             post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
@@ -2804,11 +2804,11 @@ export declare const createPostTool: {
         username?: string | undefined;
         workspace_id?: string | undefined;
         account_id?: string | undefined;
+        caption?: string | undefined;
         scheduled_at?: string | undefined;
         media_url?: string | undefined;
         media_urls?: string[] | undefined;
         post_type?: string | undefined;
-        caption?: string | undefined;
         thread_posts?: string[] | undefined;
         instagram_settings?: {
             post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;

package/dist/tools/create-posts-batch.d.ts

@@ -499,11 +499,11 @@ export declare const createPostsBatchTool: {
             username?: string | undefined;
             workspace_id?: string | undefined;
             account_id?: string | undefined;
+            caption?: string | undefined;
             scheduled_at?: string | undefined;
             media_url?: string | undefined;
             media_urls?: string[] | undefined;
             post_type?: string | undefined;
-            caption?: string | undefined;
             thread_posts?: string[] | undefined;
             instagram_settings?: {
                 post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
@@ -662,11 +662,11 @@ export declare const createPostsBatchTool: {
             username?: string | undefined;
             workspace_id?: string | undefined;
             account_id?: string | undefined;
+            caption?: string | undefined;
             scheduled_at?: string | undefined;
             media_url?: string | undefined;
             media_urls?: string[] | undefined;
             post_type?: string | undefined;
-            caption?: string | undefined;
             thread_posts?: string[] | undefined;
             instagram_settings?: {
                 post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
@@ -829,11 +829,11 @@ export declare const createPostsBatchTool: {
             username?: string | undefined;
             workspace_id?: string | undefined;
             account_id?: string | undefined;
+            caption?: string | undefined;
             scheduled_at?: string | undefined;
             media_url?: string | undefined;
             media_urls?: string[] | undefined;
             post_type?: string | undefined;
-            caption?: string | undefined;
             thread_posts?: string[] | undefined;
             instagram_settings?: {
                 post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
@@ -995,11 +995,11 @@ export declare const createPostsBatchTool: {
             username?: string | undefined;
             workspace_id?: string | undefined;
             account_id?: string | undefined;
+            caption?: string | undefined;
             scheduled_at?: string | undefined;
             media_url?: string | undefined;
             media_urls?: string[] | undefined;
             post_type?: string | undefined;
-            caption?: string | undefined;
             thread_posts?: string[] | undefined;
             instagram_settings?: {
                 post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;

package/dist/tools/delete-post.d.ts

@@ -4,6 +4,7 @@ import { type ToolContext } from '../lib/tool-runtime.js';
 type DeletePostInput = {
     post_id?: number;
     group_id?: string;
+    confirm_published?: boolean;
     confirm?: boolean;
     preview_id?: string;
 };
@@ -13,6 +14,7 @@ export declare const deletePostTool: {
     inputSchema: z.ZodObject<{
         post_id: z.ZodOptional<z.ZodNumber>;
         group_id: z.ZodOptional<z.ZodString>;
+        confirm_published: z.ZodOptional<z.ZodBoolean>;
         confirm: z.ZodOptional<z.ZodBoolean>;
         preview_id: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
@@ -20,11 +22,13 @@ export declare const deletePostTool: {
         preview_id?: string | undefined;
         post_id?: number | undefined;
         group_id?: string | undefined;
+        confirm_published?: boolean | undefined;
     }, {
         confirm?: boolean | undefined;
         preview_id?: string | undefined;
         post_id?: number | undefined;
         group_id?: string | undefined;
+        confirm_published?: boolean | undefined;
     }>;
     /** The old tools' exact input schemas, for alias calls (see alias-transport.ts). */
     legacySchemas: {

package/dist/tools/delete-post.js

@@ -3,10 +3,14 @@ import { code, dashboardUrlForPosts } from '../lib/format.js';
 import { previewThenConfirm, validateArgs } from '../lib/tool-runtime.js';
 export const deletePostTool = {
     name: 'delete_post',
-    description: 'Delete posts. DESTRUCTIVE and IRREVERSIBLE: deleted posts and captions cannot be recovered, and published or currently publishing posts are never deleted. post_id: delete one scheduled or draft post; fetch it with `get_post` first, show the user what will be deleted (caption, account, scheduled time), and pass confirm=true only after explicit confirmation ("yes delete it", "remove it"). group_id: delete every draft, scheduled, failed, or paused post matching a caller-defined group_id, post_group_id, api_group_id, or release_id; preview then confirm: call without confirm to get a preview and preview_id, show it, then call again with confirm=true and that preview_id. Never delete several posts one by one without listing each and confirming the full list.',
+    description: 'Delete posts. DESTRUCTIVE and IRREVERSIBLE: deleted posts and captions cannot be recovered. post_id: delete one post; fetch it with `get_post` first, show the user what will be deleted (caption, account, scheduled time), and pass confirm=true only after explicit confirmation ("yes delete it", "remove it"). A post that is currently publishing is never deleted. A published post is taken down only when the user also explicitly confirms the live removal and you pass confirm_published=true. Instagram and Facebook are attempted when the stored id and token allow it. Every other platform, or a live URL with no id, returns platform_delete_unsupported and the posterly row is kept. A published post with no live URL and no platform id is removed from posterly only. group_id: delete every draft, scheduled, failed, or paused post matching a caller-defined group_id, post_group_id, api_group_id, or release_id. A group delete never removes published posts. Preview then confirm: call without confirm to get a preview and preview_id, show it, then call again with confirm=true and that preview_id. Never delete several posts one by one without listing each and confirming the full list.',
     inputSchema: z.object({
         post_id: z.number().optional().describe('Delete this one post.'),
-        group_id: z.string().min(1).max(160).optional().describe('Delete every unpublished post in this group or release instead.'),
+        group_id: z.string().min(1).max(160).optional().describe('Delete every unpublished post in this group or release instead. Never deletes published posts.'),
+        confirm_published: z
+            .boolean()
+            .optional()
+            .describe('With post_id only. True only after the user explicitly confirms taking a live Instagram or Facebook post down. Without it, a published post is refused and kept.'),
         confirm: z
             .boolean()
             .optional()
@@ -33,7 +37,7 @@ export const deletePostTool = {
                 // GET /api/v1/posts has no group filter, so the preview says in plain
                 // words which posts match instead of listing them.
                 describe: async () => [
-                    `Deletes every draft, scheduled, failed, or paused post whose group_id, post_group_id, api_group_id, or release_id is ${code(args.group_id)}. Published posts are never deleted. This cannot be undone.`,
+                    `Deletes every draft, scheduled, failed, or paused post whose group_id, post_group_id, api_group_id, or release_id is ${code(args.group_id)}. A group delete never removes published posts. This cannot be undone.`,
                     'To see the posts first, call list_posts and check each post\'s group or release ID.',
                 ].join('\n\n'),
                 run: async () => {
@@ -49,9 +53,10 @@ async function deleteOne(client, input) {
     if (input.confirm !== true) {
         throw new Error('Refusing to delete post without confirm=true after explicit user confirmation.');
     }
-    const result = await client.deletePost(input.post_id);
+    const result = await client.deletePost(input.post_id, { confirmPublished: input.confirm_published === true });
+    const platformDelete = result.platform_delete ? ` Platform delete: ${result.platform_delete}.` : '';
     return [
-        `Post #${result.id} deleted successfully.`,
+        `Post #${result.id} deleted successfully.${platformDelete}`,
         'It has been removed from the posterly queue.',
         `View queue in posterly: ${dashboardUrlForPosts()}`,
         '',

package/dist/tools/list-analytics.js

@@ -4,7 +4,7 @@ import { validateArgs } from '../lib/tool-runtime.js';
 const presentationSchema = z.enum(['compact', 'table', 'json']).optional();
 export const listAnalyticsTool = {
     name: 'list_analytics',
-    description: 'Analytics for connected social accounts (Instagram, Facebook, LinkedIn, Google Business Profile, Pinterest, YouTube, and Threads). view=accounts (account_id): daily snapshots and a period summary with platform-native display_metrics labels. view=posts (account_id): per-post likes, comments/replies, reach, impressions/views, saves, shares, reposts, quotes, plays, clicks, and watch time, most recent first, with limit/offset. view=insights: per-post feedback insights with a performance tier (great/good/mixed/poor), diagnosis, next action, and baseline, filtered by account_id, post_id, or checkpoint (1h, 6h, 24h, 72h, 7d); read-only, Pro plan or higher. presentation (accounts and posts): compact for Telegram/mobile, table for Markdown clients, json for custom chart/card renderers.',
+    description: 'Analytics for connected social accounts (Instagram, Facebook, LinkedIn, Google Business Profile, Pinterest, YouTube, and Threads). view=accounts (account_id): daily snapshots and a period summary with platform-native display_metrics labels. Google Business Profile account analytics includes Calls, Website clicks, and Directions along with Profile Views, Search Views, Maps Views, Customer Actions, and Posts. view=posts (account_id): per-post likes, comments/replies, reach, impressions/views, saves, shares, reposts, quotes, plays, clicks, and watch time, most recent first, with limit/offset. view=insights: per-post feedback insights with a performance tier (great/good/mixed/poor), diagnosis, next action, and baseline, filtered by account_id, post_id, or checkpoint (1h, 6h, 24h, 72h, 7d); read-only, Pro plan or higher. presentation (accounts and posts): compact for Telegram/mobile, table for Markdown clients, json for custom chart/card renderers.',
     inputSchema: z.object({
         view: z.enum(['accounts', 'posts', 'insights']).describe('accounts, posts, or insights.'),
         account_id: z
@@ -150,6 +150,9 @@ function accountMetricRows(summary, platform) {
             ['Search Views', formatNumber(metrics.search_views ?? summary.total_reach)],
             ['Maps Views', formatNumber(metrics.maps_views ?? summary.total_profile_views)],
             ['Customer Actions', formatNumber(metrics.customer_actions ?? summary.total_accounts_engaged)],
+            ['Calls', formatNumber(metrics.call_clicks ?? summary.total_call_clicks)],
+            ['Directions', formatNumber(metrics.direction_requests ?? summary.total_direction_requests)],
+            ['Website clicks', formatNumber(metrics.website_clicks ?? summary.total_website_clicks)],
             ['Posts', formatNumber(metrics.posts ?? summary.current_media_count)],
         ];
     }

package/dist/tools/list-posts.d.ts

@@ -10,6 +10,7 @@ export declare const listPostsTool: {
         limit: z.ZodOptional<z.ZodNumber>;
         workspace_id: z.ZodOptional<z.ZodString>;
         approval_status: z.ZodOptional<z.ZodEnum<["none", "pending_client", "approved", "changes_requested", "rejected"]>>;
+        approval_waiting_on: z.ZodOptional<z.ZodEnum<["client", "team"]>>;
         brand_id: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "gmb" | "google-business" | "google_business_profile" | undefined;
@@ -18,6 +19,7 @@ export declare const listPostsTool: {
         account_id?: string | undefined;
         limit?: number | undefined;
         approval_status?: "none" | "pending_client" | "approved" | "changes_requested" | "rejected" | undefined;
+        approval_waiting_on?: "client" | "team" | undefined;
         brand_id?: string | undefined;
     }, {
         platform?: "instagram" | "instagram-standalone" | "facebook" | "tiktok" | "twitter" | "threads" | "linkedin" | "youtube" | "pinterest" | "google_business" | "x" | "telegram" | "bluesky" | "discord" | "wordpress" | "devto" | "hashnode" | "lemmy" | "slack" | "mastodon" | "gmb" | "google-business" | "google_business_profile" | undefined;
@@ -26,6 +28,7 @@ export declare const listPostsTool: {
         account_id?: string | undefined;
         limit?: number | undefined;
         approval_status?: "none" | "pending_client" | "approved" | "changes_requested" | "rejected" | undefined;
+        approval_waiting_on?: "client" | "team" | undefined;
         brand_id?: string | undefined;
     }>;
     execute(client: PosterlyClient, input: {
@@ -35,6 +38,7 @@ export declare const listPostsTool: {
         limit?: number;
         workspace_id?: string;
         approval_status?: string;
+        approval_waiting_on?: "client" | "team";
         brand_id?: string;
     }): Promise<string>;
 };

package/dist/tools/list-posts.js

@@ -3,7 +3,7 @@ import { dashboardUrlForPostList, formatLocalDateTime, truncateText } from '../l
 import { SUPPORTED_PLATFORM_INPUTS, SUPPORTED_PLATFORM_IDS } from '../generated/platform-manifest.js';
 export const listPostsTool = {
     name: 'list_posts',
-    description: 'List upcoming or recent posts. Filter by status (scheduled, published, failed, draft), platform, account_id, workspace_id, approval_status, or brand_id. Returns posts in your workspaces, teammates\' too, per your role there (brand-locked seats only see their assigned brands). If workspace_id is omitted, this searches every workspace you belong to.',
+    description: 'List upcoming or recent posts. Filter by status (scheduled, published, failed, draft), platform, account_id, workspace_id, approval_status, approval_waiting_on, or brand_id. approval_waiting_on=client is the same queue as approval_status=pending_client. Each post includes approval.pending_client_approval. Returns posts in your workspaces, teammates\' too, per your role there (brand-locked seats only see their assigned brands). If workspace_id is omitted, this searches every workspace you belong to.',
     inputSchema: z.object({
         status: z
             .string()
@@ -31,6 +31,10 @@ export const listPostsTool = {
             .enum(['none', 'pending_client', 'approved', 'changes_requested', 'rejected'])
             .optional()
             .describe('Filter by client review approval status. pending_client means the post is waiting on the client.'),
+        approval_waiting_on: z
+            .enum(['client', 'team'])
+            .optional()
+            .describe('client: approval_status pending_client. team: changes_requested or rejected. Conflicts with a non-overlapping approval_status.'),
         brand_id: z
             .string()
             .optional()

package/dist/tools/update-post.d.ts

@@ -497,6 +497,9 @@ type UpdatePostInput = EditInput & {
     status?: 'scheduled' | 'paused' | 'draft';
     release_id?: string;
     group_id?: string;
+    approval_action?: 'request' | 'approve' | 'request_changes' | 'reject';
+    approval_axis?: 'asset' | 'caption';
+    approval_note?: string;
 };
 export declare const updatePostTool: {
     name: string;
@@ -995,11 +998,15 @@ export declare const updatePostTool: {
         status: z.ZodOptional<z.ZodEnum<["scheduled", "paused", "draft"]>>;
         release_id: z.ZodOptional<z.ZodString>;
         group_id: z.ZodOptional<z.ZodString>;
+        approval_action: z.ZodOptional<z.ZodEnum<["request", "approve", "request_changes", "reject"]>>;
+        approval_axis: z.ZodOptional<z.ZodEnum<["asset", "caption"]>>;
+        approval_note: z.ZodOptional<z.ZodString>;
         confirm: z.ZodLiteral<true>;
     }, "strip", z.ZodTypeAny, {
         confirm: true;
         post_id: number;
         status?: "scheduled" | "paused" | "draft" | undefined;
+        caption?: string | undefined;
         scheduled_at?: string | undefined;
         media_url?: string | undefined;
         media_urls?: string[] | undefined;
@@ -1007,7 +1014,6 @@ export declare const updatePostTool: {
         reel_cover_url?: string | undefined;
         reel_cover_method?: string | undefined;
         reel_thumb_offset?: number | undefined;
-        caption?: string | undefined;
         instagram_settings?: {
             post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
             reel_cover_url?: string | undefined;
@@ -1163,10 +1169,14 @@ export declare const updatePostTool: {
         }, z.ZodTypeAny, "passthrough"> | undefined;
         release_id?: string | undefined;
         group_id?: string | undefined;
+        approval_action?: "request" | "approve" | "request_changes" | "reject" | undefined;
+        approval_axis?: "asset" | "caption" | undefined;
+        approval_note?: string | undefined;
     }, {
         confirm: true;
         post_id: number;
         status?: "scheduled" | "paused" | "draft" | undefined;
+        caption?: string | undefined;
         scheduled_at?: string | undefined;
         media_url?: string | undefined;
         media_urls?: string[] | undefined;
@@ -1174,7 +1184,6 @@ export declare const updatePostTool: {
         reel_cover_url?: string | undefined;
         reel_cover_method?: string | undefined;
         reel_thumb_offset?: number | undefined;
-        caption?: string | undefined;
         instagram_settings?: {
             post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
             reel_cover_url?: string | undefined;
@@ -1330,6 +1339,9 @@ export declare const updatePostTool: {
         }, z.ZodTypeAny, "passthrough"> | undefined;
         release_id?: string | undefined;
         group_id?: string | undefined;
+        approval_action?: "request" | "approve" | "request_changes" | "reject" | undefined;
+        approval_axis?: "asset" | "caption" | undefined;
+        approval_note?: string | undefined;
     }>;
     /** The old tools' exact input schemas, for alias calls (see alias-transport.ts). */
     legacySchemas: {

package/dist/tools/update-post.js

@@ -108,7 +108,7 @@ const platformSettingsSchema = z.object({
 }).passthrough();
 export const updatePostTool = {
     name: 'update_post',
-    description: 'Change a scheduled or draft post. DESTRUCTIVE WRITE. Edit (default): caption, media, schedule, post_type, or settings; overwrites the existing post; cannot edit published or currently publishing posts; if a client has already approved the post, a caption edit reopens caption approval, a media or thumbnail edit reopens asset approval, and a reschedule, account change or settings change reopens both. status (scheduled, paused, or draft, with scheduled_at when scheduling a draft): pause, resume, or move back to draft; send it on its own. release_id (with optional group_id): set or repair external release/group IDs; send it on its own.\n\n' +
+    description: 'Change a scheduled or draft post. DESTRUCTIVE WRITE. Edit (default): caption, media, schedule, post_type, or settings; overwrites the existing post; cannot edit published or currently publishing posts; if a client has already approved the post, a caption edit reopens caption approval, a media or thumbnail edit reopens asset approval, and a reschedule, account change or settings change reopens both. status (scheduled, paused, or draft, with scheduled_at when scheduling a draft): pause, resume, or move back to draft; send it on its own. release_id (with optional group_id): set or repair external release/group IDs; send it on its own. approval_action (request, approve, request_changes, or reject): change client approval. Only a workspace owner or admin may do this. The actor is the API key user, never a brand guest. request emails the brand reviewers. approve, request_changes, and reject are team-side decisions. request_changes needs approval_note. Optional approval_axis is asset or caption; omit it for both. Send approval_action on its own.\n\n' +
         'REQUIRED BEFORE CALLING: Show the user a side-by-side of the CURRENT post (caption, scheduled time, media, status) and the PROPOSED change, and get explicit confirmation ("yes update it", "apply those changes") before calling. Do not auto-edit posts based on a general instruction - each change needs its own confirmation.',
     inputSchema: z.object({
         post_id: z.number().describe('The post ID to update'),
@@ -146,6 +146,18 @@ export const updatePostTool = {
             .optional()
             .describe('Set an external release ID instead of editing the post. Send with post_id and optional group_id only.'),
         group_id: z.string().min(1).max(160).optional().describe('With release_id only: an external group/campaign ID.'),
+        approval_action: z
+            .enum(['request', 'approve', 'request_changes', 'reject'])
+            .optional()
+            .describe('Change client approval instead of editing the post. Owner or admin only. The actor is the API key user, never a brand guest. Send on its own.'),
+        approval_axis: z
+            .enum(['asset', 'caption'])
+            .optional()
+            .describe('With approval_action approve, request_changes, or reject: which axis to decide. Omit for both. Not allowed with request.'),
+        approval_note: z
+            .string()
+            .optional()
+            .describe('Note stored with the approval change. Required for request_changes.'),
         confirm: z.literal(true).describe('Must be true after explicit user confirmation of the proposed change.'),
     }),
     /** The old tools' exact input schemas, for alias calls (see alias-transport.ts). */
@@ -169,6 +181,9 @@ export const updatePostTool = {
             return updateStatus(client, args);
         if (mode === 'release_id')
             return updateReleaseId(client, args);
+        if (mode === 'approval') {
+            return updateApproval(client, args);
+        }
         return editPost(client, args);
     },
 };
@@ -209,6 +224,17 @@ async function updateStatus(client, input) {
     const transition = result.transition || {};
     return `Post #${input.post_id} status changed from ${transition.old_status || 'unknown'} to ${transition.new_status || input.status}.`;
 }
+async function updateApproval(client, input) {
+    if (input.confirm !== true) {
+        throw new Error('Refusing to change client approval without confirm=true after explicit user confirmation. Only a workspace owner or admin can do this, and the actor is the API key user, never a brand guest.');
+    }
+    const result = await client.setPostApproval(input.post_id, {
+        action: input.approval_action,
+        axis: input.approval_axis,
+        note: input.approval_note,
+    });
+    return JSON.stringify(result, null, 2);
+}
 async function updateReleaseId(client, input) {
     const result = await client.updatePostReleaseId(input.post_id, {
         release_id: input.release_id,

package/dist/tools/validate-post.d.ts

@@ -494,11 +494,11 @@ export declare const validatePostInputSchema: import("zod").ZodObject<{
     username?: string | undefined;
     workspace_id?: string | undefined;
     account_id?: string | undefined;
+    caption?: string | undefined;
     scheduled_at?: string | undefined;
     media_url?: string | undefined;
     media_urls?: string[] | undefined;
     post_type?: string | undefined;
-    caption?: string | undefined;
     thread_posts?: string[] | undefined;
     instagram_settings?: {
         post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
@@ -657,11 +657,11 @@ export declare const validatePostInputSchema: import("zod").ZodObject<{
     username?: string | undefined;
     workspace_id?: string | undefined;
     account_id?: string | undefined;
+    caption?: string | undefined;
     scheduled_at?: string | undefined;
     media_url?: string | undefined;
     media_urls?: string[] | undefined;
     post_type?: string | undefined;
-    caption?: string | undefined;
     thread_posts?: string[] | undefined;
     instagram_settings?: {
         post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
@@ -1314,11 +1314,11 @@ export declare const validatePostTool: {
         username?: string | undefined;
         workspace_id?: string | undefined;
         account_id?: string | undefined;
+        caption?: string | undefined;
         scheduled_at?: string | undefined;
         media_url?: string | undefined;
         media_urls?: string[] | undefined;
         post_type?: string | undefined;
-        caption?: string | undefined;
         thread_posts?: string[] | undefined;
         instagram_settings?: {
             post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;
@@ -1477,11 +1477,11 @@ export declare const validatePostTool: {
         username?: string | undefined;
         workspace_id?: string | undefined;
         account_id?: string | undefined;
+        caption?: string | undefined;
         scheduled_at?: string | undefined;
         media_url?: string | undefined;
         media_urls?: string[] | undefined;
         post_type?: string | undefined;
-        caption?: string | undefined;
         thread_posts?: string[] | undefined;
         instagram_settings?: {
             post_type?: "post" | "feed" | "story" | "reel" | "carousel" | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "posterly-mcp-server",
-  "version": "0.46.0",
+  "version": "0.47.0",
   "mcpName": "io.github.awpthorp/posterly",
   "description": "MCP server for posterly: schedule and publish social media posts across 18 platforms from any MCP client (Claude, ChatGPT, Cursor, Windsurf, Cline, and more)",
   "license": "MIT",

package/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.awpthorp/posterly",
   "title": "posterly",
   "description": "Validate, schedule, publish, and analyze social content across 18 platforms with posterly.",
-  "version": "0.46.0",
+  "version": "0.47.0",
   "websiteUrl": "https://www.poster.ly/mcp",
   "repository": {
     "url": "https://github.com/awpthorp/posterly",
@@ -14,7 +14,7 @@
     {
       "registryType": "npm",
       "identifier": "posterly-mcp-server",
-      "version": "0.46.0",
+      "version": "0.47.0",
       "transport": {
         "type": "stdio"
       },

package/src/lib/api-client.ts

@@ -190,6 +190,7 @@ export interface ApiPostApproval {
   asset_status: ApiPostApprovalStatus;
   caption_status: ApiPostApprovalStatus;
   waiting_on: 'client' | 'team' | null;
+  pending_client_approval: boolean;
   requested_at: string | null;
   completed_at: string | null;
 }
@@ -1544,6 +1545,7 @@ export class PosterlyClient {
     offset?: number;
     workspace_id?: string;
     approval_status?: string;
+    approval_waiting_on?: string;
     brand_id?: string;
   }): Promise<{ posts: Post[]; total: number }> {
     const searchParams = new URLSearchParams();
@@ -1554,6 +1556,7 @@ export class PosterlyClient {
     if (params?.offset) searchParams.set('offset', String(params.offset));
     if (params?.workspace_id) searchParams.set('workspace_id', params.workspace_id);
     if (params?.approval_status) searchParams.set('approval_status', params.approval_status);
+    if (params?.approval_waiting_on) searchParams.set('approval_waiting_on', params.approval_waiting_on);
     if (params?.brand_id) searchParams.set('brand_id', params.brand_id);
 
     const qs = searchParams.toString();
@@ -1614,8 +1617,27 @@ export class PosterlyClient {
     return this.request('PATCH', `/posts/${id}`, data);
   }
 
-  async deletePost(id: number): Promise<{ deleted: boolean; id: number }> {
-    return this.request('DELETE', `/posts/${id}`);
+  async deletePost(
+    id: number,
+    options?: { confirmPublished?: boolean },
+  ): Promise<{ deleted: boolean; id: number; platform_delete?: string }> {
+    const qs = options?.confirmPublished ? '?confirm_published=true' : '';
+    return this.request('DELETE', `/posts/${id}${qs}`);
+  }
+
+  async setPostApproval(
+    id: number,
+    data: {
+      action: 'request' | 'approve' | 'request_changes' | 'reject';
+      axis?: 'asset' | 'caption';
+      note?: string;
+    },
+  ): Promise<Record<string, unknown>> {
+    return this.request('POST', `/posts/${id}/approval`, {
+      action: data.action,
+      ...(data.axis ? { axis: data.axis } : {}),
+      ...(data.note ? { note: data.note } : {}),
+    });
   }
 
   async updatePostStatus(

package/src/lib/version.ts

@@ -5,4 +5,4 @@
 // tool set (minus the intentional pre-auth signup tools that only this stdio
 // package exposes). `npm run check:mcp-parity` enforces both the version match
 // and the tool-list match, and runs in the pre-commit hook.
-export const POSTERLY_MCP_VERSION = '0.46.0';
+export const POSTERLY_MCP_VERSION = '0.47.0';

package/src/tools/delete-post.ts

@@ -6,6 +6,7 @@ import { previewThenConfirm, validateArgs, type ToolContext } from '../lib/tool-
 type DeletePostInput = {
   post_id?: number;
   group_id?: string;
+  confirm_published?: boolean;
   confirm?: boolean;
   preview_id?: string;
 };
@@ -13,10 +14,14 @@ type DeletePostInput = {
 export const deletePostTool = {
   name: 'delete_post',
   description:
-    'Delete posts. DESTRUCTIVE and IRREVERSIBLE: deleted posts and captions cannot be recovered, and published or currently publishing posts are never deleted. post_id: delete one scheduled or draft post; fetch it with `get_post` first, show the user what will be deleted (caption, account, scheduled time), and pass confirm=true only after explicit confirmation ("yes delete it", "remove it"). group_id: delete every draft, scheduled, failed, or paused post matching a caller-defined group_id, post_group_id, api_group_id, or release_id; preview then confirm: call without confirm to get a preview and preview_id, show it, then call again with confirm=true and that preview_id. Never delete several posts one by one without listing each and confirming the full list.',
+    'Delete posts. DESTRUCTIVE and IRREVERSIBLE: deleted posts and captions cannot be recovered. post_id: delete one post; fetch it with `get_post` first, show the user what will be deleted (caption, account, scheduled time), and pass confirm=true only after explicit confirmation ("yes delete it", "remove it"). A post that is currently publishing is never deleted. A published post is taken down only when the user also explicitly confirms the live removal and you pass confirm_published=true. Instagram and Facebook are attempted when the stored id and token allow it. Every other platform, or a live URL with no id, returns platform_delete_unsupported and the posterly row is kept. A published post with no live URL and no platform id is removed from posterly only. group_id: delete every draft, scheduled, failed, or paused post matching a caller-defined group_id, post_group_id, api_group_id, or release_id. A group delete never removes published posts. Preview then confirm: call without confirm to get a preview and preview_id, show it, then call again with confirm=true and that preview_id. Never delete several posts one by one without listing each and confirming the full list.',
   inputSchema: z.object({
     post_id: z.number().optional().describe('Delete this one post.'),
-    group_id: z.string().min(1).max(160).optional().describe('Delete every unpublished post in this group or release instead.'),
+    group_id: z.string().min(1).max(160).optional().describe('Delete every unpublished post in this group or release instead. Never deletes published posts.'),
+    confirm_published: z
+      .boolean()
+      .optional()
+      .describe('With post_id only. True only after the user explicitly confirms taking a live Instagram or Facebook post down. Without it, a published post is refused and kept.'),
     confirm: z
       .boolean()
       .optional()
@@ -44,7 +49,7 @@ export const deletePostTool = {
         // GET /api/v1/posts has no group filter, so the preview says in plain
         // words which posts match instead of listing them.
         describe: async () => [
-          `Deletes every draft, scheduled, failed, or paused post whose group_id, post_group_id, api_group_id, or release_id is ${code(args.group_id)}. Published posts are never deleted. This cannot be undone.`,
+          `Deletes every draft, scheduled, failed, or paused post whose group_id, post_group_id, api_group_id, or release_id is ${code(args.group_id)}. A group delete never removes published posts. This cannot be undone.`,
           'To see the posts first, call list_posts and check each post\'s group or release ID.',
         ].join('\n\n'),
         run: async () => {
@@ -53,17 +58,21 @@ export const deletePostTool = {
         },
       });
     }
-    return deleteOne(client, args as { post_id: number; confirm?: boolean });
+    return deleteOne(client, args as { post_id: number; confirm?: boolean; confirm_published?: boolean });
   },
 };
 
-async function deleteOne(client: PosterlyClient, input: { post_id: number; confirm?: boolean }): Promise<string> {
+async function deleteOne(
+  client: PosterlyClient,
+  input: { post_id: number; confirm?: boolean; confirm_published?: boolean },
+): Promise<string> {
   if (input.confirm !== true) {
     throw new Error('Refusing to delete post without confirm=true after explicit user confirmation.');
   }
-  const result = await client.deletePost(input.post_id);
+  const result = await client.deletePost(input.post_id, { confirmPublished: input.confirm_published === true });
+  const platformDelete = result.platform_delete ? ` Platform delete: ${result.platform_delete}.` : '';
   return [
-    `Post #${result.id} deleted successfully.`,
+    `Post #${result.id} deleted successfully.${platformDelete}`,
     'It has been removed from the posterly queue.',
     `View queue in posterly: ${dashboardUrlForPosts()}`,
     '',

package/src/tools/list-analytics.ts

@@ -29,7 +29,7 @@ type ListAnalyticsInput = {
 export const listAnalyticsTool = {
   name: 'list_analytics',
   description:
-    'Analytics for connected social accounts (Instagram, Facebook, LinkedIn, Google Business Profile, Pinterest, YouTube, and Threads). view=accounts (account_id): daily snapshots and a period summary with platform-native display_metrics labels. view=posts (account_id): per-post likes, comments/replies, reach, impressions/views, saves, shares, reposts, quotes, plays, clicks, and watch time, most recent first, with limit/offset. view=insights: per-post feedback insights with a performance tier (great/good/mixed/poor), diagnosis, next action, and baseline, filtered by account_id, post_id, or checkpoint (1h, 6h, 24h, 72h, 7d); read-only, Pro plan or higher. presentation (accounts and posts): compact for Telegram/mobile, table for Markdown clients, json for custom chart/card renderers.',
+    'Analytics for connected social accounts (Instagram, Facebook, LinkedIn, Google Business Profile, Pinterest, YouTube, and Threads). view=accounts (account_id): daily snapshots and a period summary with platform-native display_metrics labels. Google Business Profile account analytics includes Calls, Website clicks, and Directions along with Profile Views, Search Views, Maps Views, Customer Actions, and Posts. view=posts (account_id): per-post likes, comments/replies, reach, impressions/views, saves, shares, reposts, quotes, plays, clicks, and watch time, most recent first, with limit/offset. view=insights: per-post feedback insights with a performance tier (great/good/mixed/poor), diagnosis, next action, and baseline, filtered by account_id, post_id, or checkpoint (1h, 6h, 24h, 72h, 7d); read-only, Pro plan or higher. presentation (accounts and posts): compact for Telegram/mobile, table for Markdown clients, json for custom chart/card renderers.',
   inputSchema: z.object({
     view: z.enum(['accounts', 'posts', 'insights']).describe('accounts, posts, or insights.'),
     account_id: z
@@ -194,6 +194,9 @@ function accountMetricRows(summary: AccountAnalyticsSummary, platform: string):
       ['Search Views', formatNumber(metrics.search_views ?? summary.total_reach)],
       ['Maps Views', formatNumber(metrics.maps_views ?? summary.total_profile_views)],
       ['Customer Actions', formatNumber(metrics.customer_actions ?? summary.total_accounts_engaged)],
+      ['Calls', formatNumber(metrics.call_clicks ?? summary.total_call_clicks)],
+      ['Directions', formatNumber(metrics.direction_requests ?? summary.total_direction_requests)],
+      ['Website clicks', formatNumber(metrics.website_clicks ?? summary.total_website_clicks)],
       ['Posts', formatNumber(metrics.posts ?? summary.current_media_count)],
     ];
   }

package/src/tools/list-posts.ts

@@ -6,7 +6,7 @@ import { SUPPORTED_PLATFORM_INPUTS, SUPPORTED_PLATFORM_IDS } from '../generated/
 export const listPostsTool = {
   name: 'list_posts',
   description:
-    'List upcoming or recent posts. Filter by status (scheduled, published, failed, draft), platform, account_id, workspace_id, approval_status, or brand_id. Returns posts in your workspaces, teammates\' too, per your role there (brand-locked seats only see their assigned brands). If workspace_id is omitted, this searches every workspace you belong to.',
+    'List upcoming or recent posts. Filter by status (scheduled, published, failed, draft), platform, account_id, workspace_id, approval_status, approval_waiting_on, or brand_id. approval_waiting_on=client is the same queue as approval_status=pending_client. Each post includes approval.pending_client_approval. Returns posts in your workspaces, teammates\' too, per your role there (brand-locked seats only see their assigned brands). If workspace_id is omitted, this searches every workspace you belong to.',
   inputSchema: z.object({
     status: z
       .string()
@@ -34,6 +34,10 @@ export const listPostsTool = {
       .enum(['none', 'pending_client', 'approved', 'changes_requested', 'rejected'])
       .optional()
       .describe('Filter by client review approval status. pending_client means the post is waiting on the client.'),
+    approval_waiting_on: z
+      .enum(['client', 'team'])
+      .optional()
+      .describe('client: approval_status pending_client. team: changes_requested or rejected. Conflicts with a non-overlapping approval_status.'),
     brand_id: z
       .string()
       .optional()
@@ -49,6 +53,7 @@ export const listPostsTool = {
       limit?: number;
       workspace_id?: string;
       approval_status?: string;
+      approval_waiting_on?: 'client' | 'team';
       brand_id?: string;
     }
   ) {

package/src/tools/update-post.ts

@@ -127,12 +127,15 @@ type UpdatePostInput = EditInput & {
   status?: 'scheduled' | 'paused' | 'draft';
   release_id?: string;
   group_id?: string;
+  approval_action?: 'request' | 'approve' | 'request_changes' | 'reject';
+  approval_axis?: 'asset' | 'caption';
+  approval_note?: string;
 };
 
 export const updatePostTool = {
   name: 'update_post',
   description:
-    'Change a scheduled or draft post. DESTRUCTIVE WRITE. Edit (default): caption, media, schedule, post_type, or settings; overwrites the existing post; cannot edit published or currently publishing posts; if a client has already approved the post, a caption edit reopens caption approval, a media or thumbnail edit reopens asset approval, and a reschedule, account change or settings change reopens both. status (scheduled, paused, or draft, with scheduled_at when scheduling a draft): pause, resume, or move back to draft; send it on its own. release_id (with optional group_id): set or repair external release/group IDs; send it on its own.\n\n' +
+    'Change a scheduled or draft post. DESTRUCTIVE WRITE. Edit (default): caption, media, schedule, post_type, or settings; overwrites the existing post; cannot edit published or currently publishing posts; if a client has already approved the post, a caption edit reopens caption approval, a media or thumbnail edit reopens asset approval, and a reschedule, account change or settings change reopens both. status (scheduled, paused, or draft, with scheduled_at when scheduling a draft): pause, resume, or move back to draft; send it on its own. release_id (with optional group_id): set or repair external release/group IDs; send it on its own. approval_action (request, approve, request_changes, or reject): change client approval. Only a workspace owner or admin may do this. The actor is the API key user, never a brand guest. request emails the brand reviewers. approve, request_changes, and reject are team-side decisions. request_changes needs approval_note. Optional approval_axis is asset or caption; omit it for both. Send approval_action on its own.\n\n' +
     'REQUIRED BEFORE CALLING: Show the user a side-by-side of the CURRENT post (caption, scheduled time, media, status) and the PROPOSED change, and get explicit confirmation ("yes update it", "apply those changes") before calling. Do not auto-edit posts based on a general instruction - each change needs its own confirmation.',
   inputSchema: z.object({
     post_id: z.number().describe('The post ID to update'),
@@ -170,6 +173,18 @@ export const updatePostTool = {
       .optional()
       .describe('Set an external release ID instead of editing the post. Send with post_id and optional group_id only.'),
     group_id: z.string().min(1).max(160).optional().describe('With release_id only: an external group/campaign ID.'),
+    approval_action: z
+      .enum(['request', 'approve', 'request_changes', 'reject'])
+      .optional()
+      .describe('Change client approval instead of editing the post. Owner or admin only. The actor is the API key user, never a brand guest. Send on its own.'),
+    approval_axis: z
+      .enum(['asset', 'caption'])
+      .optional()
+      .describe('With approval_action approve, request_changes, or reject: which axis to decide. Omit for both. Not allowed with request.'),
+    approval_note: z
+      .string()
+      .optional()
+      .describe('Note stored with the approval change. Required for request_changes.'),
     confirm: z.literal(true).describe('Must be true after explicit user confirmation of the proposed change.'),
   }),
 
@@ -193,6 +208,15 @@ export const updatePostTool = {
     const { mode, args } = validateArgs(ctx, 'update_post', input);
     if (mode === 'status') return updateStatus(client, args as { post_id: number; status: 'scheduled' | 'paused' | 'draft'; scheduled_at?: string; confirm: boolean });
     if (mode === 'release_id') return updateReleaseId(client, args as { post_id: number; release_id: string; group_id?: string; confirm: true });
+    if (mode === 'approval') {
+      return updateApproval(client, args as {
+        post_id: number;
+        approval_action: 'request' | 'approve' | 'request_changes' | 'reject';
+        approval_axis?: 'asset' | 'caption';
+        approval_note?: string;
+        confirm: true;
+      });
+    }
     return editPost(client, args as EditInput);
   },
 };
@@ -241,6 +265,27 @@ async function updateStatus(
   return `Post #${input.post_id} status changed from ${transition.old_status || 'unknown'} to ${transition.new_status || input.status}.`;
 }
 
+async function updateApproval(
+  client: PosterlyClient,
+  input: {
+    post_id: number;
+    approval_action: 'request' | 'approve' | 'request_changes' | 'reject';
+    approval_axis?: 'asset' | 'caption';
+    approval_note?: string;
+    confirm: true;
+  },
+): Promise<string> {
+  if (input.confirm !== true) {
+    throw new Error('Refusing to change client approval without confirm=true after explicit user confirmation. Only a workspace owner or admin can do this, and the actor is the API key user, never a brand guest.');
+  }
+  const result = await client.setPostApproval(input.post_id, {
+    action: input.approval_action,
+    axis: input.approval_axis,
+    note: input.approval_note,
+  });
+  return JSON.stringify(result, null, 2);
+}
+
 async function updateReleaseId(
   client: PosterlyClient,
   input: { post_id: number; release_id: string; group_id?: string; confirm: true },

package/tool-registry.json

@@ -736,6 +736,43 @@
               "type": "string"
             }
           }
+        },
+        "approval": {
+          "label": "Request, approve, request changes, or reject client review",
+          "destructive": true,
+          "idempotent": true,
+          "openWorld": false,
+          "confirm": "confirm",
+          "when": [
+            "approval_action"
+          ],
+          "params": {
+            "post_id": {
+              "type": "integer",
+              "min": 1,
+              "required": true
+            },
+            "approval_action": {
+              "type": "string",
+              "enum": [
+                "request",
+                "approve",
+                "request_changes",
+                "reject"
+              ],
+              "required": true
+            },
+            "approval_axis": {
+              "type": "string",
+              "enum": [
+                "asset",
+                "caption"
+              ]
+            },
+            "approval_note": {
+              "type": "string"
+            }
+          }
         }
       }
     },
@@ -760,6 +797,9 @@
               "type": "integer",
               "min": 1,
               "required": true
+            },
+            "confirm_published": {
+              "type": "boolean"
             }
           }
         },