Davnai

Lists the person's Social Studio automations (series, repeats, new video → posts, blog or podcast feeds) with id, name, kind, whether each is on, when it posts, where, whether posts wait for approval, and the next post's time.

list_automations

The person's Brand Kit: name, colours, fonts, voice (how they write), image style, handle, caption style and look. Use the voice when writing for them.

get_brand_kit

Cancels a scheduled post before it goes out (post id from get_calendar), or declines a post waiting for approval (waiting id). Nothing is deleted; it stays in Davnai as cancelled or skipped. Published posts can't be cancelled.

cancel_post

Changes one choice in an AI Director plan without asking the AI again (no AI help used), exactly like Adjust on the plan in Davnai, and returns the new plan to show the person. part: transitions_feel (value auto, smooth, punchy or cuts), transition (item_id like t1; value a transition such as fade, black, dissolve, whip, zoom, push, slide, flash, glitch, leak, or its length in seconds 0.2 to 1.2), speed (item_id p1; value 1.25, 1.5 or 2), freeze (item_id f1; value 0.5, 1 or 1.5 seconds), sound_shift (item_id j1; value 0.2 to 0.6 seconds), layout (item_id x1; value phone, card, circle or stack), caption_style (value one of the 24 caption styles), caption_place (value bottom, middle, top or voice), look, cut_level (none, light or balanced). To switch something off, approve with off instead; for anything else, use ask_director with plan_id.

change_director_plan

Changes parts of the person's Brand Kit (only what's given; the rest stays). Only when the person asked for the change. Colours: a hex code or a name (indigo, violet, navy, black, white, cream, yellow, coral, green, sky); up to 6 in all.

update_brand_kit

The newest comments on the person's posts (YouTube, Facebook, Instagram, Threads, LinkedIn), read live from the platforms: by default the ones waiting for a reply. Each has the account_id and comment_id that reply_to_comment takes.

list_comments

Lists the social media accounts the person has connected to Davnai (id, platform, name, handle, and whether it needs reconnecting). Use the ids with create_posts. Never returns sign-in details.

list_accounts

Creates a Social Studio automation: a series (Davnai writes a new post on a theme on chosen days), a repeat (the same post again every few weeks, in fresh words or exactly as written), new_video (each new YouTube or Davnai video becomes posts) or feed (each new blog or podcast item becomes posts). Each post Davnai writes uses 1 AI writing (the person's own words, set with words, use none), and the plan limits how many automations are on. Saved switched off unless switch_on is true and the person allowed this app to publish. Accounts: Facebook, Instagram (with pictures or video), Threads, LinkedIn, Bluesky, Pinterest.

create_automation

Send a picture you designed as HTML and CSS (one self-contained page: inline styles or a <style> block, flexbox/grid, gradients, SVG all fine) and Davnai draws it on its own server and saves it to the person's pictures, ready for create_posts. Use this instead of add_picture for anything you design yourself: it's a few KB instead of a whole image. Rules: no scripts, no external links or web fonts; pictures may only be the person's Davnai pictures as src="davnai:picture/<picture id>" (ids from list_pictures), their Brand Kit logo as src="davnai:logo", or data: images. Fonts available by name: Poppins, Inter, Inter Tight, Anton, Bebas Neue, Playfair Display, Instrument Serif, Space Grotesk (plus standard system fonts). Size: shape square 1080×1080 (default), portrait 1080×1350, story 1080×1920, landscape 1280×720, wide 1920×1080, or width and height (100–2160). Counts toward the person's storage only, never their AI images. Usually returns the picture id in 10–40 seconds; if it's still drawing, it returns a job id for get_drawing.

draw_picture

Davnai's AI looks through a recording again for new Short moments (different from the ones it found). Uses 1 of the plan's AI re-runs; takes a minute or two, then list_short_moments shows them.

find_shorts

For a draw_picture that was still drawing: whether it's finished, and its picture id.

get_drawing

Joins two or more of the person's videos into one, in the order given (recordings, edited videos and Shorts; ids from list_videos), optionally in another shape, with captions in the Brand Kit style, and with their intro and outro. The clips aren't changed. Uses export minutes; the person is emailed.

join_videos

The person's keyword replies (when a comment says a word, Davnai replies and can send a private message), whether each is on, and their ids.

list_keyword_replies

The person's saved teleprompter scripts in Davnai (newest first): title, about how long each takes to read, and whether it was recorded.

list_scripts

Makes Shorts from a recording's moments (ids from list_short_moments), with captions in the Brand Kit style unless captions is false. Uses export minutes; the person is emailed. Shapes: 9:16 (default), 1:1, 4:5, 16:9.

make_shorts

Draws a picture from a simple design on Davnai's server and saves it to the person's pictures: a quote card, a list, big words, a question or a thumbnail, in their brand colours, optionally over one of their pictures. Uses storage only, never the plan's AI images. Returns its picture id for create_posts. Shapes: square 1080×1080, portrait 1080×1350, story 1080×1920, landscape 1280×720.

make_design

Asks Davnai's Image Studio to make a picture for a post, in the person's Brand Kit style. Uses one of the plan's AI images this month. Returns its picture id for create_posts.

make_picture

The moments in a recording that Davnai's AI found could be Shorts (id, title, length, why), best first. Use the ids with make_shorts.

list_short_moments

Moves a scheduled post (post id from get_calendar) to another time. Posts that have started publishing can't be moved (a YouTube video already uploaded is changed in YouTube Studio).

move_post

Pauses an automation or switches it back on (ids from list_automations). Switching on follows the plan's number of automations on at once.

switch_automation

Lists the person's pictures in Davnai (My images: uploads and AI pictures), newest first, with id, title and size. Use an id with create_posts.

list_pictures

The person's Davnai plan and what's left this month: video minutes, export minutes, posts, AI writing, AI images and storage. Check this before suggesting work that the plan may not cover.

my_usage

The person's next free posting times (from the posting times they set in Social Studio) and the best times to post on each platform (from their own numbers where there are enough).

posting_times

Posts a reply under a comment, as the person's account (account_id and comment_id from list_comments). Only when the person asked for this reply.

reply_to_comment

Makes copies of a recording in other shapes for other platforms (9:16 TikTok/Reels, 1:1 feed, 4:5 portrait, 16:9 YouTube), optionally following the speaker and with captions. The original isn't changed. Uses export minutes; the person is emailed.

resize_video

How the person's posts did: views, engagement (likes, comments, shares), new followers and watch time for the last 7, 28 or 90 days (to yesterday) against the period before, and their top posts.

get_results

Saves a video script you wrote for the person to their Davnai teleprompter, so it's waiting when they open Record (phone or computer) and scrolls while they film themselves. Plain spoken words; put on-screen directions in [square brackets]; markdown is tidied away. Returns the script id and a link that opens it ready to record. Doesn't use any AI writing from their plan (you wrote it).

save_script

Makes one of the person's pictures the thumbnail of one of their videos (a recording or a finished video). Davnai shows it on the video and uses it when the video is posted to YouTube. It replaces the video's current thumbnail. Make the picture first with draw_picture (shape landscape, 1280×720: the best for a designed thumbnail), make_design or make_picture, or pick one from list_pictures. Storage only.

set_thumbnail

Shows the person's posts for a period: scheduled, published and failed posts (with their post ids) and posts waiting for their approval (with their waiting ids).

get_calendar

Gives a link that opens Davnai's upload window, for a video on the person's computer (chats can't pass video files to Davnai). The person must be signed in to Davnai to use it; the link gives no access by itself. Optional project_id puts it in that project; without it they choose the project in the window. Afterwards, list_videos shows the new recording.

upload_link

What Davnai is making right now for the person (AI edits, Shorts, resizes, captions): how far along each is and about how long is left, and anything that didn't finish in the last 7 days.

job_status

Lists the person's videos in Davnai, newest first: recordings they uploaded, edited videos and Shorts, with id, title, length and date, plus how many there are of each kind. Use offset to see more. Use an id with get_video or create_posts.

list_videos

The person's webhooks (addresses Davnai tells when something happens, e.g. a post is published), without their secrets.

list_webhooks

Asks Davnai's writer to write a post for each platform, in the person's brand voice, from a video (its words) or a short description. Uses one of the plan's AI writing this month. Returns the words; nothing is posted. You can also write posts yourself and skip this.

write_posts