Kinetik

Add the user's attached photos, videos or documents so they can be used in new content. Use it when the user attaches files for a post. Returns their paths for the inputs of create_content. With no attachments it returns how to show an upload form instead.

upload_files

Analyze a social account's content and results: what works, what does not, and ideas for what to post next. Use it when the user asks how their account or a competitor's account is doing. Public accounts need no connection; private insights of the user's own account need it connected, and get_job then returns a card to connect it. Read-only; uses the user's Kinetik credits. Returns a job_id: call get_job until it is done, then show the findings with the markup it returns.

analyze_account

Check a task's status and get its result once it is done. Use it with the job_id from research, create_content, edit_content, list_content, analyze_account, publish_content, setup_content_recommendations or get_content_recommendations. Waits up to about 40 seconds, then returns running (call it again, and keep calling until the job is done, failed or needs the user's input; do not end your turn while it runs), feedback (pass it on: a question to ask the user, or what went wrong and what would help), confirm (a post's preview to show and confirm with the user before it goes out), failed, or done with the result and the markup that shows it; once every job you started is done, show all their results together in one view. Read-only.

get_job

Create new content in the user's brand: an image, a carousel, a short video, or a media project of several pieces for one goal (posts for several platforms, a series of carousels, a launch pack). Use it when the user asks for a post visual, carousel slides with a caption, a reel, or a set of posts. Everything made is kept, and list_content finds it in any chat. Returns a job_id: call get_job until it is done, then show the result with the markup get_job returns. If something is missing or goes wrong, get_job returns feedback for the user. Spends the user's Kinetik credits. Photos of real people only with their consent. Does not publish anything.

create_content

Change content already made: restyle it, adjust a slide, shorten a caption, recut a video, or change a whole media project. Use it when the user wants a change to something already made rather than something new. The change is saved as a new version and the earlier one is kept. When changing a content-recommendations issue, pass its delivery_receipt so the revision replaces that issue. Returns a job_id: call get_job until it is done, then show the returned markup. Spends the user's Kinetik credits.

edit_content

Find what the user has made, in any chat: single pieces and media projects, by a question in their words or all of it. Use it when the user asks what they have, to show earlier work again, or to find the content edit_content needs. Read-only; uses a little of the user's Kinetik credits. Returns a job_id: call get_job until it is done; its answer lists the content found and the markup that shows it.

list_content

Prepare the next issue of a recurring digest of content ideas, from its saved brief and earlier issues. Use it when the user asks for the digest's next issue, or when a scheduled run calls it. Returns a job_id: call get_job until it is done, then show the returned markup. Omit query to follow the saved brief; pass it for a first brief or a direction for this issue. Uses the user's Kinetik credits.

get_content_recommendations

Kinetik's home: the effects to make content with. A picked effect is attached to the user's next message.

open_home

Give this mounted Kinetik widget short-lived access to one render's live data. App-only infrastructure: models do not call it.

charms_widget_session

Publish a finished piece to the user's social account: an Instagram image, carousel or reel, a TikTok video as a draft, or a LinkedIn text post. Use it only when the user asks to post something. Without confirm it returns a preview of the post: show it with the markup get_job returns and ask the user to confirm; then call again with confirm true to post. Needs the account connected; otherwise get_job returns a card to connect it. Posts publicly on the user's behalf.

publish_content