FeedClaw

Move a scheduled content item to a new publish time.

reschedule

View scheduled content items sorted by publish time (soonest first).

get_schedule

Create or save content in FeedClaw for publishing, scheduling, or later retrieval. Supports X (Twitter), LinkedIn, and email newsletters. Content is created as pending_approval when not scheduled. After creating, present the full content to the user as an inline preview and ask if they want to: (1) publish now, (2) schedule for a specific time, (3) edit, or (4) save it to FeedClaw for later. For batch creation (4+ items), direct the user to the FeedClaw inbox instead. For email content, share the preview_url so they can see the formatted email. Attach an image with image_url or a video with video_url (X or LinkedIn). For files the user has on their device, use get_upload_link then list_media (upload_media is only for small images you already hold as bytes). Media rules: X takes up to 4 images (image_urls) or one video; LinkedIn takes up to 9 images or one video; never images and video together; email takes one image. Never publish or schedule unless the user confirms; if the user explicitly asks to publish/post/send now, use create_and_publish instead. IMPORTANT for email: subscriber lists are optional groupings, not the subscriber count. You must specify either list_id or send_to_all: true. If get_lists returns 0 lists but total_active_subscribers is greater than 0, use send_to_all: true when the user wants all/current subscribers.

Permanently delete a draft, pending, or scheduled content item. Approved or published items cannot be deleted. Deleting a scheduled item cancels its publish job.

List all brands in your FeedClaw workspace. If no brands are returned, tell the user they must create a brand and connect a publishing channel in FeedClaw before creating or publishing content.

Get a link the user opens to connect X or LinkedIn. Use when they have drafts and want to publish somewhere that is not connected yet. The link opens the provider's own authorize screen; after approval the tab closes itself. Show the url and message_for_user, then follow instructions_for_agent: poll get_onboarding_state silently until channels.<platform> is true. Do not explain OAuth.

Get the full details of a content item by ID.

Same as feedclaw_init: brands, setup card and onboarding instructions. Prefer feedclaw_init at the start of a conversation; use this to re-check setup, for example after the user connects X or LinkedIn.

Get a link where the user drops photos or videos from their own device (phone or computer). Use it whenever the user wants to attach media they have — never ask them to paste files into the chat, and do not use upload_media for anything you do not already hold as bytes. The response includes a batch; after they say they are done, call list_media with that batch to get exactly those files. Images up to 10 MB, MP4 video up to 50 MB.

List email templates available for a brand. Returns template ID, name, subject_prefix, and whether it is the brand default.

List the photos and videos the user uploaded (newest first). Pass the batch from get_upload_link to get exactly the files from that link; each asset says whether it is already attached_to a post and how long ago it was uploaded. Use url as image_url (one image), image_urls (up to 4, X only) or video_url. Rules: X takes up to 4 images or one video; LinkedIn takes up to 9 images or one video; never both together; email takes one image.

List content items saved in FeedClaw that are ready for a publish, schedule, edit, or later decision.

Get a drafting brief for a brand with no content yet. Returns the brand voice, topic hints and instructions — YOU write the posts, then save them with create_draft using channels: []. Use when get_onboarding_state returns next_step "create_first_content".

Name the workspace brand and say what it publishes about. Use this ONLY when get_onboarding_state returns next_step "confirm_brand". It fills in an unconfirmed placeholder brand; if the user already named their brand it changes nothing and tells you so. It never renames an existing brand and never creates a second one unless create_new is true.

Cancel a scheduled publish and return the content item to pending approval. Use this to stop a scheduled post from being published. Confirm with user before canceling a scheduled publish.

Update a draft, pending, or scheduled content item. Only title, content, channels, and metadata can be changed. Approved or published items cannot be modified.