Skip to content

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

13 tools
readlist_brands

List the user's brands with niche and connected platforms, and which one is active.

readget_brand_profile

Get 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_kit

Get the brand's visual identity kit (colors, fonts, logo, palette, voice description) used by the video editor and carousels.

writeupdate_brand_kit

Update the brand's visual identity kit: colors (primary, accent, background, foreground, palette), fonts (fontFamily, headingFont), logoUrl, voiceDescription.

writeupdate_strategy_brief

Update the brand's strategy brief (onboarding brief).

readget_voice_profile

Get the brand's AI-derived voice profile (status, confidence, profile, exemplars) and form profile (status, profile, stats).

writeupdate_brand_profile

Rename a brand or change its contentLanguage (a supported Dalea locale).

readget_brand_site_analysis

Read the brand's business analysis: product, audience, pains, benefits, differentiators, competitors and confidence, plus source URL, status and error.

write5/dayanalyze_brand_site

Analyze a public website to understand the brand's business.

write20/daycreate_brand_kit_upload

Create a private signed upload URL for a brand manual PDF up to 10 MiB.

write10/dayextract_brand_kit

Extract visual identity from exactly one of siteUrl or pdfPath (from create_brand_kit_upload).

write20/dayupload_brand_logo

Upload 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_brief

Infer updated positioning, audience, pillars and insights from connected social profiles.

Group 02

Performance

11 tools
readget_account_overview

Get 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_growth

Follower growth and views per day (or week) for the brand's connected accounts, per account and in total.

readlist_videos

List the brand's published posts with metrics, classificationSources and classification (funnelStage, format, communicationStyle, mediaType).

readget_video

Get an own post by platformVideoId (optional platform disambiguates).

write10/dayanalyze_video

Analyze one of the brand's own published video posts using the same pipeline as Dalea.

readget_performance_summary

Totals 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_performers

Rank the brand's videos published in the last N days (default 30) by metric: views | engagement | saves | shares | likes.

readget_metrics_daily

Per-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_benchmarks

Get median/p75/p90 view and engagement benchmarks for the brand's niche.

writeset_video_classification

Manually 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_metrics

Fetch fresh metrics from every connected TikTok/Instagram account.

Group 03

Insights

3 tools

Group 04

Content & calendar

22 tools
readlist_contents

List the brand's content cards (board + calendar) as summaries: id, title, idea, status, platforms, postedAt, mediaType, category, funnelStage, format, createdAt, updatedAt.

readget_content

Get 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_references

List the references attached to a content card, in order: referenceType (video | creator | link | document), title, referenceUrl and referenceId.

writecreate_content

Create a new content card on the board/calendar (no AI).

writebulk_create_contents

Create 1-20 content cards in one call (no AI).

writeupdate_content

Edit a content card's editorial fields (no AI).

writeduplicate_content

Create 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_content

Move a content card on the kanban board: change its column (status) and/or its order within a column.

writereorder_contents

Set the order of cards inside one kanban column (status: idea | draft | edited | posted).

writeschedule_content

Set the planned calendar date for a content card (the day it should be posted).

writeunschedule_content

Clear a content card's planned calendar date (sets posted_at to null).

writedelete_content

Delete a content card from the board/calendar by id.

readget_calendar

Get 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_title

AI-generate a working title.

writeattach_content_reference

Attach a catalog/owned video or catalog creator to a content card.

writedetach_content_reference

Remove an attachment (video, creator or source) from a content card.

write20/daycreate_content_source_upload

Prepare a private signed PDF upload for this brand (10 MiB, expires in 2 hours).

write30/dayadd_content_source

Attach an article URL, raw text (200, 150000 characters), or uploaded PDF and start AI extraction in the background.

readget_content_source

Read source extraction status, errors, highlights and a paginated excerpt of the full text, without generating AI output.

write15/dayretry_content_source

Retry a failed or stalled source extraction in the background.

writecreate_content_from_source

Create a content card from an article URL, raw text or uploaded PDF.

writeset_content_web_search

Enable or disable manual web research for script generation on this card, preserving existing citations and script options.

Group 05

Scripts

9 tools

Group 06

Ideas

4 tools

Group 07

Saved references

9 tools

Group 08

Viral catalog

8 tools

Group 09

Creator knowledge

17 tools
readlist_creator_facts

List facts the app has learned about the creator (story, pillars, arguments, restrictions, preferences, products, milestones, voice, audience, goals).

writeadd_creator_fact

Record a fact about the creator in the learning ledger (source manual, status active).

writearchive_creator_fact

Archive a creator fact by id so it stops feeding generation.

readget_creator_memory

Get the AI-maintained memory of who this creator is (free text plus structured fields).

readget_creator_context

Get the creator interview outcome: phase, origin story, 90-day goals, what content already works, struggles, themes and voice.

readlist_macro_topics

List the brand's macro content topics grouped from its creator facts, with usage counts and the fact ids behind each one.

readlist_restrictions

List things the brand never wants in its content (restrictions), with where each one came from.

writeadd_restriction

Add a restriction: something the brand never wants in its content.

writeremove_restriction

Permanently delete one restriction by id (from list_restrictions).

readget_script_preferences

Get the brand's script preferences: content pillars with weights, preferred formats, default duration, approved and banned hooks, standing instructions.

writeupdate_script_preferences

Update the brand's script preferences.

writereview_creator_fact

Review 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_memory

Replace the consolidated creator memory with exactly one of memoryText or structured.

write5/dayregenerate_creator_memory

Rebuild creator memory from the latest stored facts, interview, strategy and content.

readget_strategy_interview

Read the current strategy interview, including messages, profile, phase and whether it is applied.

write60/daystrategy_interview

Run 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_context

Save structured context from an interview conducted by the agent: origin, goals90, winningContent, struggles, themes and voice.

Group 10

Studio

11 tools
readlist_carousel_drafts

List the brand's carousel drafts from the Carousel Studio (title, slide count, last edit).

readget_carousel_draft

Get one carousel draft with its slides (role, image prompt, headline/body/CTA texts) and funnelStage (tofu | mofu | bofu).

write10/daycreate_carousel

Create 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_generation

Check a carousel being created with create_carousel: status (generating | ready | failed), the phase and how many slides and pictures are done.

readrender_carousel_draft

Render 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_posts

List carousel/video publish jobs sent to Instagram or TikTok: status, scheduled time, per-platform result (permalink or error).

writeschedule_carousel_post

Schedule a carousel draft from the Carousel Studio to be posted on the brand's connected Instagram account at a given time.

writereschedule_carousel_post

Move a scheduled post (from schedule_carousel_post or list_carousel_posts) to a new time.

writecancel_carousel_post

Cancel a scheduled post so it is not published.

readlist_video_projects

List the brand's video editor projects (name, status queued|processing|preview_ready|ready|expired|failed, language, enabled edits, durations).

readget_video_job_status

Get 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.