Reference
Tools
109 tools in 11 groups. Read tools only look at your account; write tools change it and need a connection authorized with write access.
Group 01
Brand & strategy
list_ brandsList the user's brands with niche and connected platforms, and which one is active.
readget_ brand_ profileGet a brand's full profile: basics (name, language, strategy summary), the complete strategy brief (niche, audience, pain, promise, tone, pillars, taboo topics, offer URL/mode/details, site URL, page style and profile insights), connected social accounts with follower counts, business segment and subscription (status, currentPeriodEnd, cancelAtPeriodEnd, trialEnd, brandSlots).
readget_ brand_ kitGet the brand's visual identity kit (colors, fonts, logo, palette, voice description) used by the video editor and carousels.
writeupdate_ brand_ kitUpdate the brand's visual identity kit: colors (primary, accent, background, foreground, palette), fonts (fontFamily, headingFont), logoUrl, voiceDescription.
writeupdate_ strategy_ briefUpdate the brand's strategy brief (onboarding brief).
readget_ voice_ profileGet the brand's AI-derived voice profile (status, confidence, profile, exemplars) and form profile (status, profile, stats).
writeupdate_ brand_ profileRename a brand or change its contentLanguage (a supported Dalea locale).
readget_ brand_ site_ analysisRead the brand's business analysis: product, audience, pains, benefits, differentiators, competitors and confidence, plus source URL, status and error.
write5/dayanalyze_ brand_ siteAnalyze a public website to understand the brand's business.
write20/daycreate_ brand_ kit_ uploadCreate a private signed upload URL for a brand manual PDF up to 10 MiB.
write10/dayextract_ brand_ kitExtract visual identity from exactly one of siteUrl or pdfPath (from create_brand_kit_upload).
write20/dayupload_ brand_ logoUpload raw base64 image bytes (no data URL prefix), PNG/JPEG/WebP up to 2 MiB, and save the logo in this brand's visual kit.
write5/dayrefresh_ strategy_ briefInfer updated positioning, audience, pillars and insights from connected social profiles.
Group 02
Performance
get_ account_ overviewGet the brand's connected accounts with followers, following, followersGained over the last `days` days (7-365, default 30; net followers, gains minus losses, measured from the last snapshot at or before the start of the window, or from the first snapshot when the account was connected more recently) with followersGainedDays echoing the window, totalVideos, reach, source (oauth | scrape), lastSnapshotAt, lastSyncedAt, lastScrapedAt and lastUpdatedAt (source-aware sync/scrape freshness).
readget_ audience_ growthFollower growth and views per day (or week) for the brand's connected accounts, per account and in total.
readlist_ videosList the brand's published posts with metrics, classificationSources and classification (funnelStage, format, communicationStyle, mediaType).
readget_ videoGet an own post by platformVideoId (optional platform disambiguates).
write10/dayanalyze_ videoAnalyze one of the brand's own published video posts using the same pipeline as Dalea.
readget_ performance_ summaryTotals for videos published in the last N days (7|30|90, default 30): videoCount, views, likes, comments, shares, saves, averageEngagementPct; the same for the previous window; deltaPct per metric (null when the previous value is 0); and the topVideo by views.
readget_ top_ performersRank the brand's videos published in the last N days (default 30) by metric: views | engagement | saves | shares | likes.
readget_ metrics_ dailyPer-sync snapshots of the brand's video posts between from and to (YYYY-MM-DD, inclusive; range capped to the last 180 days before `to`).
readget_ niche_ benchmarksGet median/p75/p90 view and engagement benchmarks for the brand's niche.
writeset_ video_ classificationManually classify one of the brand's published videos (by platformVideoId): funnel (tofu | mofu | bofu), format (taxonomy slug, e.g. talking_head, tutorial, listicle) and/or communicationStyle (style slug).
write6/daysync_ metricsFetch fresh metrics from every connected TikTok/Instagram account.
Group 03
Insights
list_ insightsList the brand's AI-generated insight tiles.
readget_ homepage_ insightsRead saved homepage insights with generatedAt, currentVideoCount, scope and freshness (missing/insufficient_data/stale/available, reasons and canGenerate).
write5/daygenerate_ insightsRegenerate the brand's homepage insights from up to 50 top-view video posts in the last 365 days (needs 10+ videos; images/carousels excluded).
Group 04
Content & calendar
list_ contentsList the brand's content cards (board + calendar) as summaries: id, title, idea, status, platforms, postedAt, mediaType, category, funnelStage, format, createdAt, updatedAt.
readget_ contentGet one content card's full detail by id: the script (hook, body, cta, caption), planning fields (status, platforms, postedAt, mediaType, category, funnelStage, format, communicationStyle, targetDurationSeconds), the web searches the AI ran for it (webSearch: queries and result links) and how many references and AI generations it has.
readlist_ content_ referencesList the references attached to a content card, in order: referenceType (video | creator | link | document), title, referenceUrl and referenceId.
writecreate_ contentCreate a new content card on the board/calendar (no AI).
writebulk_ create_ contentsCreate 1-20 content cards in one call (no AI).
writeupdate_ contentEdit a content card's editorial fields (no AI).
writeduplicate_ contentCreate a copy of a content card (same title, idea, script, caption, platforms, mediaType, format, category, funnelStage, communicationStyle, targetDurationSeconds) at the bottom of the idea column, with no planned date.
writemove_ contentMove a content card on the kanban board: change its column (status) and/or its order within a column.
writereorder_ contentsSet the order of cards inside one kanban column (status: idea | draft | edited | posted).
writeschedule_ contentSet the planned calendar date for a content card (the day it should be posted).
writeunschedule_ contentClear a content card's planned calendar date (sets posted_at to null).
writedelete_ contentDelete a content card from the board/calendar by id.
readget_ calendarGet the brand's content calendar for a date range as one entry per day (empty days included), each with the cards planned for that day (id, title, status, platforms, mediaType, postedAt).
write50/daygenerate_ titleAI-generate a working title.
writeattach_ content_ referenceAttach a catalog/owned video or catalog creator to a content card.
writedetach_ content_ referenceRemove an attachment (video, creator or source) from a content card.
write20/daycreate_ content_ source_ uploadPrepare a private signed PDF upload for this brand (10 MiB, expires in 2 hours).
write30/dayadd_ content_ sourceAttach an article URL, raw text (200, 150000 characters), or uploaded PDF and start AI extraction in the background.
readget_ content_ sourceRead source extraction status, errors, highlights and a paginated excerpt of the full text, without generating AI output.
write15/dayretry_ content_ sourceRetry a failed or stalled source extraction in the background.
writecreate_ content_ from_ sourceCreate a content card from an article URL, raw text or uploaded PDF.
writeset_ content_ web_ searchEnable or disable manual web research for script generation on this card, preserving existing citations and script options.
Group 05
Scripts
generate_ scriptsGenerate a full AI script (hook, CTA, body and caption options; carousel slides for carousels) for 1-5 content cards and save it to each card.
write30/daygenerate_ hook_ optionsGenerate up to 3 AI hook (opening line) suggestions for a content card, using the brand's context, memory and references.
write30/daygenerate_ body_ optionsGenerate up to 3 AI body (script development) suggestions for a content card, using the brand's context, memory and references.
write30/daygenerate_ cta_ optionsGenerate up to 3 AI call-to-action suggestions for a content card, using the brand's context, memory and references.
write30/daygenerate_ caption_ optionsGenerate up to 3 AI caption suggestions for a content card, using the brand's context, memory and references.
readlist_ content_ generationsList the AI script generations saved for a content card (newest first): title, hook, cta and the alternative body/caption options each run produced.
readget_ refine_ chatGet the last N messages (default 20, max 100) of the refine chat attached to a content card, with text, refinement IDs, preview status, proposed changes and settings, plus the total message count.
write30/dayrefine_ contentRefine or discuss a script with Dalea's shared brand voice, memory, restrictions, source text and chat history.
writereview_ content_ refinementApply or dismiss a saved refinement preview without another AI call.
Group 06
Ideas
list_ brainstorm_ suggestionsList the brand's active brainstorm suggestions with reasons.
writeaccept_ brainstorm_ suggestionAccept a brainstorm suggestion: creates a content card in the idea column from its title, idea and funnel stage (no AI), then marks the suggestion as added with contentId.
writedismiss_ brainstorm_ suggestionMark a brainstorm suggestion as dismissed so it leaves the pending list.
write5/dayregenerate_ brainstormReplace the brand's active brainstorm set with freshly generated suggestions (optional manualContext steers them).
Group 07
Saved references
list_ saved_ referencesList saved reference videos with thumbnails, URLs, metrics, engagement percentage, topics, note and analysisStatus in the brand language, plus creator inspirations with hasDeepAnalysis.
write30/daysave_ reference_ by_ urlSave a TikTok/Instagram video or creator profile URL as a brand reference (scrapes it if unknown; video analysis runs in the background).
writedelete_ saved_ referencePermanently remove a saved reference video (id from list_saved_references).
readget_ creator_ analysisGet the stored deep analysis of a creator by creatorId, as an object: positioning, pillars (emoji, title, description), targetAudience, tone, formats (name, description), hooks, whatToAdapt, funnel (predominant tofu | mofu | bofu, text) and videoType (predominant spoken | text_on_screen | mix, text).
write10/dayrun_ creator_ deep_ analysisRun (or return the cached) AI deep analysis of a saved creator by creatorId.
writehide_ creatorHide a creator (by handle, with or without @) from this brand's reference catalog searches.
writeunhide_ creatorShow a previously hidden creator (by handle) in this brand's reference catalog again.
writeset_ creator_ inspirationStar or unstar an existing catalog creator as an inspiration for this brand.
writesave_ catalog_ videoSave an existing catalog video to this brand's reference library by videoId, without scraping or generating analysis.
Group 08
Viral catalog
search_ catalog_ videosSearch the shared reference catalog of top-performing creator videos.
readget_ catalog_ videoGet a catalog video with full caption and its stored analysis plus verbatim transcript and timed segments: hook, structure, visual, takeaway, verdict, beats, timing, model/source and evidence.
readsearch_ creatorsSearch catalog creators by name or handle (min 2 chars).
readget_ creatorGet a catalog creator profile, summary in the brand content language, accounts and 5 most-viewed catalog videos.
readlist_ creator_ videosList ONLY one catalog creator's videos, without their profile, general analysis, video analyses or transcripts.
readlist_ catalog_ creatorsBrowse creators without a search term.
readget_ recommended_ videosRead Dalea's personalized For You video feed for this brand, using the same ranking as the app.
write10/dayanalyze_ catalog_ videoAnalyze a catalog video with Dalea's video-analysis pipeline and return its analysis plus verbatim transcript.
Group 09
Creator knowledge
list_ creator_ factsList facts the app has learned about the creator (story, pillars, arguments, restrictions, preferences, products, milestones, voice, audience, goals).
writeadd_ creator_ factRecord a fact about the creator in the learning ledger (source manual, status active).
writearchive_ creator_ factArchive a creator fact by id so it stops feeding generation.
readget_ creator_ memoryGet the AI-maintained memory of who this creator is (free text plus structured fields).
readget_ creator_ contextGet the creator interview outcome: phase, origin story, 90-day goals, what content already works, struggles, themes and voice.
readlist_ macro_ topicsList the brand's macro content topics grouped from its creator facts, with usage counts and the fact ids behind each one.
readlist_ restrictionsList things the brand never wants in its content (restrictions), with where each one came from.
writeadd_ restrictionAdd a restriction: something the brand never wants in its content.
writeremove_ restrictionPermanently delete one restriction by id (from list_restrictions).
readget_ script_ preferencesGet the brand's script preferences: content pillars with weights, preferred formats, default duration, approved and banned hooks, standing instructions.
writeupdate_ script_ preferencesUpdate the brand's script preferences.
writereview_ creator_ factReview a learned fact by id: confirm validates it and restores it if archived; reject archives it with review provenance; correct archives it and records the corrected text.
writeupdate_ creator_ memoryReplace the consolidated creator memory with exactly one of memoryText or structured.
write5/dayregenerate_ creator_ memoryRebuild creator memory from the latest stored facts, interview, strategy and content.
readget_ strategy_ interviewRead the current strategy interview, including messages, profile, phase and whether it is applied.
write60/daystrategy_ interviewRun Dalea's strategy interview: start resumes an existing session; answer advances it; append refines existing context; reset archives the conversation and starts over; finishing the interview activates it automatically; apply activates an older completed interview that was never activated; apply_partial activates a usable partial interview.
write10/dayupdate_ creator_ contextSave structured context from an interview conducted by the agent: origin, goals90, winningContent, struggles, themes and voice.
Group 10
Studio
list_ carousel_ draftsList the brand's carousel drafts from the Carousel Studio (title, slide count, last edit).
readget_ carousel_ draftGet one carousel draft with its slides (role, image prompt, headline/body/CTA texts) and funnelStage (tofu | mofu | bofu).
write10/daycreate_ carouselCreate a new Instagram carousel in the Carousel Studio from an idea or brief: Dalea plans it, writes every slide in the brand's voice and language, and paints the artwork, exactly as the Studio does.
readget_ carousel_ generationCheck a carousel being created with create_carousel: status (generating | ready | failed), the phase and how many slides and pictures are done.
readrender_ carousel_ draftRender a carousel draft from the Carousel Studio into its final slide images (1080x1350 PNG, the same pixels the Studio exports) and show them to the user as a swipeable carousel.
readlist_ carousel_ postsList carousel/video publish jobs sent to Instagram or TikTok: status, scheduled time, per-platform result (permalink or error).
writeschedule_ carousel_ postSchedule a carousel draft from the Carousel Studio to be posted on the brand's connected Instagram account at a given time.
writereschedule_ carousel_ postMove a scheduled post (from schedule_carousel_post or list_carousel_posts) to a new time.
writecancel_ carousel_ postCancel a scheduled post so it is not published.
readlist_ video_ projectsList the brand's video editor projects (name, status queued|processing|preview_ready|ready|expired|failed, language, enabled edits, durations).
readget_ video_ job_ statusGet the latest render job of a video editor project: status, stage, progress percent, error code, plus project (status queued|processing|preview_ready|ready|expired|failed, expiresAt, expiringSoon) and the url of the project in the Dalea video editor.
Group 11
Search & fetch
searchSearch the user's Dalea workspace: planned/written contents, the reference video catalog, and creators.
readfetchFetch the full text of a search result by id (content:<id> = script with hook/body/cta/caption; catalog:<id> = reference video caption + full analysis and transcript in the selected brand analysis language; creator:<id> = creator bio and summary).