Tools reference

Summary of the Toolies workspace: plan and whether it is active, posts used and left this month, creators connected and allowed, scheduled and failing posts, the usual time zone, and links to each page. Call this first when you need context.

Try“How many posts do we have left this month?”

No parameters.

Lists the Instagram accounts (creators) connected to the workspace, with their IDs, @usernames, folder, connection status and post counts, plus the workspace's folders. Use it to turn a name like “Ava” into a creator_id, or to get every creator in a folder. Only creators with status connected can publish.

Try“Which creators need to be reconnected?”

Instagram accounts are connected through Instagram’s own sign-in in the Toolies app, never through chat. Returns the page where the user can connect a creator, and how many slots their plan has left.

Try“I want to add a new creator.”

No parameters.

Lists videos and images in the content library, newest first, with their folder and how many posts already use each one. Filter with uploaded_after for “the clips I uploaded yesterday”, unused_only to find content that hasn’t been scheduled yet, and folder for one group of creators’ content.

Try“What did I upload yesterday that isn’t scheduled yet?”

Adds a video or image to the content library from a public HTTPS link (a direct file URL, not a web page). Videos: MP4 or MOV, H.264 or HEVC, 3 s to 15 min, up to 4K. Images: JPEG, PNG or WebP. 100 MB maximum. Returns the new media ID.

Try“Add this video to Toolies: https://cdn.example.com/clip.mp4”

Files on the user’s device can’t travel through chat. Returns the Toolies page where they can drag in videos and images, with the accepted formats and the storage left.

Try“I have 10 new videos on my laptop.”

No parameters.

Permanently deletes a file from the content library. Refused while any post that isn’t cancelled uses it, published ones included. Ask the user before deleting.

Try“Delete the duplicate beach clip.”

Lists posts with their status, creator, time and caption. Statuses: draft, scheduled, publishing, published, needs_attention (failed or blocked: check the error), cancelled. Filter by creator and by a from/to range.

Try“Did anything fail to post this week?”

Everything about one post: full caption, media, schedule, status, error and, once published, its Instagram link and statistics.

Try“Why did Mia’s Tuesday Reel fail?”

The publishing calendar day by day: every post with its local time, creator and status. Defaults to the next 7 days for the whole roster. Use it to spot empty days before planning.

Try“Show me next week for the whole roster.”

Creates one Reel, photo or carousel for a connected creator. action=draft saves it unscheduled; action=schedule publishes it automatically at scheduled_at (within 90 days); action=publish_now posts it within a minute. Each scheduled post counts toward the monthly quota.

Try“Post the gym clip on Ava’s account tomorrow at 7 pm.”

Schedules up to 50 posts in one go, e.g. a creator’s whole week. Each post is checked and scheduled on its own; the result says which succeeded and why any failed, so you can fix and retry only those. Confirm the plan with the user before scheduling many posts.

Try“Schedule Ava’s Reels for next week, two a day in the evening.”

Changes a draft, scheduled, failed or blocked post: caption, title, media, creator or time. Only the fields you pass change. action=draft unschedules it, action=schedule (re)schedules it. Posts already sent to Instagram can’t be edited.

Try“Move Saturday’s Reel to 8 pm and add #summer.”

Cancels a draft or scheduled post so it never publishes, and gives its quota back. Posts already sent to Instagram can’t be cancelled. Ask the user first.

Try“Cancel everything scheduled for Lena on Friday.”

Statistics Instagram reports for published posts (views, likes, comments and more), newest first, optionally for one creator. Figures refresh automatically; missing values mean Instagram hasn’t reported them yet, not zero.

Try“Which of Mia’s Reels did best last week?”

Ranks hours of the day and days of the week by average performance of past posts (views when available), for one creator or the roster. Needs several published posts with statistics; says so when there isn’t enough data instead of guessing.

Try“When should Ava post to get the most views?”