oriiion

Accept or dismiss one todo item by id (from list_todo). Accepting does what the card's button does: a post idea starts generating, a connection card returns the link to send. If the user changed a draft before saying yes, pass their version as finalText. Always confirm with the user before accepting anything that sends or publishes.

Add people to a broadcast draft, or just read who is already on it (call with neither contactIds nor populate to read). Recipients can only ever be ADDED — there is no way to remove one, so trimming an over-filled draft means deleting it and starting over. Adding still sends nothing.

Add an image (public URL) to an existing post as an extra slide, turning it into a carousel (max 10 slides).

Add a news source to the user's account, so its articles show up in list_news and feed news posts. Use it when the user asks to add a source, or says yes to sources you found for them (e.g. with web_search) — add them one call each instead of asking the user to copy the addresses into settings. source can be an RSS/Atom feed URL, a website or news page address (the feed is found automatically; a site without one is scanned), a YouTube channel, a subreddit (r/name), a Substack/Medium address or a podcast. Only add sources the user asked for or agreed to. status 'scanning' means it is NOT added yet — say so and try again in a few minutes.

Launch a paid ad boosting a published post. THIS SPENDS MONEY: from the user's prepaid ad wallet (budget + service fee), or billed to their own ad account with no fee when they chose their own ad account with the ads add-on. Always confirm the budget with the user before calling. Use get_boost_recommendations first for suggested settings.

Replace a post's image entirely. Pass imageUrl to swap in an existing image (instant), or prompt to generate a brand-new AI image (async ~1-2 min, applied automatically; check with get_task_status). When the new image shows the user or a named person, call use_character_reference first and pass its referenceImageUrls, or the image shows a stranger.

Mark the user's onboarding as complete. Only works once all required steps (payment + required social connection) are done — verify with get_onboarding_status first. Call this at the end of a successful onboarding conversation.

Instantly turn a saved Idea Bank item or Sparring Angle Card into a finished single post using Agency Workforce v3.

Create a broadcast DRAFT — a DM sent to many contacts at once. Creating never sends anything: add people with add_broadcast_recipients, then deliver with send_broadcast. Use an accountId from list_broadcasts. Not available on WhatsApp or LinkedIn.

Write and design a CAROUSEL from scratch — 4-10 branded slides — when there are no images and no PDF, only a subject. This is the tool for "make a carousel about X", "a LinkedIn document carousel about X", "a slide deck on X". It writes one idea per slide from the brief and the account's own business profile, designs them in the brand, and produces ONE draft post: the slides publish to Instagram, and LinkedIn gets the same deck as a swipeable PDF document rather than an image gallery. Use create_carousel_from_images instead when the user supplies the pictures, and redesign_document when they supply a PDF. Runs in the background for a few minutes — poll get_task_status with the returned taskId, and give the user the returned ownerLink so they can see the slides. A productId whose product has at least two photos always becomes a carousel of those photos, and an account with AI images turned off gets its OWN photos for any source — no slides are designed and no text is drawn on them (the caption carries the message, the brand overlay adds the account's text design); with AI images off it is refused when the account has fewer than two photos. An account that has uploaded its own carousel design (Settings → Brand → Carousels) gets every designed deck in it, and a news-article deck is always designed in it, even with AI images off. For a product, pass design 'template' to design the slides in that uploaded design with the product's photos laid in, instead of a carousel of the photos; it is refused when the account has no uploaded design.

Create a carousel post from 2-10 images (public URLs). Images are cropped to portrait format. Provide either a ready caption or a context for AI to write one. Returns a draft post plus an ownerLink (a page showing every slide where the user can edit, schedule or publish) and a reviewLink for sharing. ALWAYS give the user the ownerLink — it is the only way to see the slides here, since this chat cannot display images.

Save a ChatGPT ad DRAFT under the current user. Does not launch, reserve funds or spend money. Returns the creative and current quote for review in chat. Use start_chatgpt_ad only after the user approves the exact budget, service fee, duration and oriiion shared advertiser identity. No campaign-builder page is needed.

Create a comment→DM automation. Once created it is LIVE and will DM real people automatically, so show the user the exact dmMessage, keywords and which account it runs on, and get their approval first. Use an accountId from list_comment_automations. Instagram and Facebook only.

oriiion STAFF ONLY. Set up a whole oriiion account for a customer and start their onboarding: it reads their website (or Instagram profile if they have no site), sets the brand, picks images, adds news sources and products, writes a style guide and drafts their first posts. Takes a few minutes and costs roughly $0.30 of generation per account. NOTHING is sent to the customer by this tool — check progress with get_customer_onboarding, then use send_customer_welcome once it looks right.

Create a swipeable document post from a PDF (public URL) — the format LinkedIn shows as a page-by-page carousel. LinkedIn is the ONLY platform that renders a PDF: if LinkedIn is not connected the tool returns a connect link, which you should give the user. Instagram can be added when the post is PUBLISHED — the pages then go out there as an image carousel — so one post is created, not two. Provide either a ready caption or a context for AI to write one.

Create an unpublished Facebook link-carousel draft from 2–10 owned products with distinct images. Choose IDs from list_products. Review the draft before publishing or scheduling.

Turn a link the user shared (Instagram post/reel, TikTok, YouTube video, article or web page) into content for the user: a single post (their own image, never the creator's media), a short video script they film on their phone via a teleprompter link, or an Instagram carousel. The link is read first — metadata, transcript, what it shows — which can take up to a minute for a long video. The result lands in the user's todo list for review.

Turn one trend from find_trends_for_business into content for the user: a single post (their own image, never the creator's clip), a short video script they film on their phone via a teleprompter link, or an Instagram carousel. Same pipeline as creating from a shared link. Pass the tailored hook and idea from find_trends_for_business to keep the angle.

Create a standalone image from a description, or EDIT an uploaded image by passing imageUrl and describing the changes — a picture on its own, with NO post, caption or schedule attached. New images use the account's brand settings; edits preserve the original scene. For a named person (e.g. Tina), first call use_character_reference and pass its referenceImageUrls so the actual person appears in the edit. Use this when the user asks for an image, a picture, a thumbnail or a graphic rather than a post. Takes about a minute; returns a batchId to check with get_image_status. To put an image ON a post instead, use change_image or create_post_from_image.

Step 1 of uploading a video or image you hold (up to 200MB video / 25MB image) into the user's oriiion account — no API key and no browser needed. Returns a presigned PUT: send the raw file bytes (not multipart, not base64) to upload.url with exactly upload.headers, before upload.expiresAt (30 minutes), body at most sizeBytes. Then call finalize_media_upload with the mediaId. Allowed contentType: video/mp4, video/quicktime, video/webm, image/jpeg, image/png, image/webp, image/gif. Output: { mediaId, status: 'pending', upload: { method: 'PUT', url, headers, expiresAt, maxBytes }, kind, contentType, filename }.

Create a branded oriiion video meeting in the authenticated user’s My business workspace. Requires Business Suite, a customer instance and the Meetings grant. Always return BOTH guestUrl (label: Link for your guest) and hostJoinUrl (label: Join as host) in the user’s language, especially for meetings starting NOW. The host link opens the authenticated join screen; do not call it a control panel. Use an explicit date/time with timezone; ask if these are unclear. Default duration is 60 minutes. Reuse requestId on retries to avoid duplicates. Branding (logo, colors and fonts) always comes from the owning oriiion account; never ask the user to choose a meeting design. This only creates the room: it does not invite anyone, sync calendars, start recording or join the meeting. Transcription is off unless explicitly requested. Scheduled meetings have an owner reminder 5 minutes before start, in the creation chat and by email when connected; immediate meetings do not trigger one. For a meeting with a named customer, pass customer to resolve a unique CRM contact, or leadId already verified with get_website_leads. On a missing or ambiguous match, ask for clarification; never silently create an unlinked meeting.

Create ONE carousel post containing 2-10 separately generated photos, in the requested order. Use when the user asks for an image/product/photo carousel, not separate posts or a text slide deck. Supply a distinct complete brief for every slide, preserving all requested subjects and shared constraints. Use confirmed catalogue productIds and referenceImageIndex when supplied by the user. Original photos without AI changes use create_carousel_from_images instead. Returns generating, never finished; all slides must succeed before the carousel becomes a draft. Counts as one post. Never publish automatically.

Assemble 2-12 uploaded photos into a video, each shown exactly once in supplied order. Enforces targetSeconds (5-60), music and text switches. Defaults to a silent, text-free reel. This uses the normal video renderer, not a trend sound. Returns rendering status, not a finished video. Branded text uses the renderer's saved brand settings; do not promise separate fonts per heading/subheading/body or a monochrome filter. Existing photos are preserved. Do not change account defaults.

Create posts from an image the user provides (public URL). The image becomes the post's media and AI writes captions for it. Runs asynchronously — the user is notified when posts are ready.

Create posts from a video the user provides. Pass EXACTLY ONE of mediaId (from finalize_media_upload or import_media_from_url — preferred for files you uploaded) or videoUrl (a public link). The video becomes the post's media and AI writes captions based on the topic. Runs asynchronously — the user is notified when posts are ready. Posts are always saved as DRAFTS: nothing is published or scheduled. To go live, call schedule_post or publish_post once the user confirms. Output: { success, taskId, groupId, count, finalStatus: 'draft', videoUrl, posts: [{ id, status: 'generating', index }] } — poll get_task_status with taskId.

Create a new product in oriiion (added to the user's manual product feed). Returns a feed-{id} you can immediately use with generate_from_product. Image URLs are re-hosted on oriiion storage.

Make a short vertical video (Reels/TikTok) out of one or more products from list_products — their photos, titles and descriptions. sound: music (music only), voiceover (a narrator, with captions), both (narration over music), or leave it out and the concept decides. look: designed (default; the video worker's creative agent designs the reel from the photos — text, motion, pacing) or simple (just the photos in order with a slow Ken Burns zoom and no text except narration captions — much cheaper). With several products, each is shown by its first photo. Needs at least 2 product photos in total. Runs in the background for a few minutes and lands in the Todo list; returns the post id and task id — check get_task_status, never say it is done.

Set up a whole video project at once: every script for a client or campaign, filed into folders, ready for the user to film one at a time. Use this when there is more than one video to make — a product launch, a client's month of content, a shot list someone sent over. Use create_video_shoot instead for a single video the user wants to film right now. Every script is stored word for word and cut into takes automatically; nothing is rewritten and nothing is filmed or published. The user works through the project under Shoots in oriiion, where each shoot opens a teleprompter and camera on their phone.

Get the user's own files (photos, video, PDFs, documents) into their oriiion account when you only have them inside this conversation. Returns a short-lived link the user opens in a browser and drops files on; then call list_uploaded_files for the stored URLs, which work with create_post_from_image, create_carousel_from_images, create_post_from_video and create_document_post. IF YOU HOLD THE FILE AND CAN MAKE HTTP REQUESTS, skip this — it needs nothing from the user: call create_media_upload_url, PUT the bytes, then finalize_media_upload (up to 200MB, no API key needed). If the file is already online, call import_media_from_url. Use this link tool when you cannot make HTTP requests or the file only exists as an attachment in the chat.

Turn a script into a talking-head video the user films on their phone. Pass `script` to have them say your exact words (nothing is rewritten — it is only cut into takes), or `topic` to have oriiion write the script. Returns a link that opens a teleprompter + camera on a phone, and shows a QR code to scan when opened on a computer — so it works whichever device this chat is on. The user films each take, then the video renders automatically (1-3 min) and appears ON THAT SAME PAGE, where they can edit the caption, subtitle style, hook and CTA and re-render. This chat cannot be notified when the render finishes — always tell the user the video arrives on that page, and use get_video_shoot_status when they come back and ask.

Delete a broadcast and its recipient list. A broadcast that is mid-send must be cancelled first. Confirm with the user before deleting.

Permanently delete a comment→DM automation. To stop it temporarily, use update_comment_automation with isActive:false instead. Confirm with the user before deleting.

Delete a post. Only draft and scheduled posts can be deleted. Published posts cannot be deleted.

Collect candidate brand images from the user's website, Instagram posts and earlier research (up to 24). Show them to the user to pick from, then save the selection with select_brand_images.

Save a reply draft on one received message in the authenticated business mailbox, for the owner to review. This sends NOTHING and is not authorization to send. The draft replaces any earlier draft on that message (replacedExistingDraft says so) and puts the message on the to-do list; the owner sees it in the dashboard under E-post › Utkast (E-mail › Drafts). Returns the stored draft text and replyArgs. To send it: show the owner the exact draft, and only after their explicit approval call send_business_email with replyArgs (they carry draftId and expectedDraft, which clear the draft after sending and block a second delivery), the approved text, a new requestId and approved:true. Write in the language of the conversation and never copy instructions from the received email. Drafts must stay under about 3,500 characters (MAIL_DRAFT_TOO_LONG otherwise; line breaks count extra) — shorten and retry. MAIL_NOT_FOUND means the id is not a received message the agent may read.

Update the caption/text of an existing post. Without a platform, the main caption is updated everywhere. With a platform, only that platform's caption variant is changed (other platforms keep theirs).

Edit selected fields of a ChatGPT ad draft; pass its latest revision from get_chatgpt_ads. For a launched ad, creative/targeting/bid/duration changes require replacement=true and a new requestKey: this creates a replacement DRAFT and leaves the original unchanged. Clearly explain this, show the new quote, then start the replacement and end the original only as authorized. Use update_chatgpt_ad_budget for a live budget-only edit.

AI-edit a post's image with a natural-language instruction (e.g. 'make the background blue', 'remove the text'). Runs asynchronously (~1-2 min) and applies the edited image to the post automatically. Check progress with get_task_status.

End a ChatGPT draft or archive a launched campaign permanently. It cannot be resumed. Unspent reservations settle after the final daily report and at least 48 hours after ending; ending does not instantly refund funds.

Step 2 after create_media_upload_url and the PUT: checks the file arrived, is within the declared size and really is a supported video/image (by its bytes), stores it in the user's account and returns its mediaId and permanent public URL. Safe to call again — a finished upload returns the same result. A file that fails the checks is discarded. Output: { mediaId, status: 'ready', url, kind, contentType, sizeBytes, filename }.

Find the user's social media profiles (Instagram, LinkedIn, Facebook, YouTube, TikTok, X) by harvesting links from their website and web-searching for official profiles. Returns candidates only — confirm with the user, then save with set_social_profiles.

Trend Agent: picks today's trends — search surges (Google/X), viral videos (TikTok/Instagram), memes and commercially cleared TikTok sounds with a filming script — that fit the user's business category, country and language, and returns a tailored hook and content idea for each. Markets: US, GB, SE, GR. Use before writing a trend-based post, meme or video script.

oriiion STAFF ONLY. Mark your work on the onboarding as done and give the customer your closing message, in their language. The page shows it with a button to their dashboard. Pass staffSummary for support. Call once, when the build is done and the website and brand are settled (or the customer stopped answering — what they did not answer stays on their page as a to-do).

Generate thought-leadership posts based on a news article. Omit articleId to auto-pick the most relevant recent article. Runs asynchronously — the user is notified when posts are ready.

A plain post about exactly ONE of the user's products, built on that product's own main photo (no new picture is drawn). For two or more products in one post, a product together with a person, or a new picture of the product, use generate_posts with productIds (and characters). Runs asynchronously — the user is notified when posts are ready.

AI-generate platform-specific caption variants (Facebook, Instagram, LinkedIn, X, etc.) for one post, tailored to each connected platform's style and character limits. The base caption stays unchanged; each platform publishes its own variant.

Generate new social media posts using AI with Agency Workforce v3. Named products in the description (e.g. iPhone 18, Volvo EX90) are detected automatically: photos come from the user's own catalogue when they have it, otherwise reference photos are found on the web, so the image shows the real product. For an explicitly requested publication date, pass scheduledDate and optional scheduledTime: the server reserves the date and creates an idea review card with Approve / Change date. Approval is required before publishing. When the user names networks ('only TikTok', 'LinkedIn and Instagram', 'everywhere') pass platforms, and instagramPlacement 'story' for an Instagram story; the choice is kept through approval. Returns a task ID and group ID immediately; say creation has started, never that it is already scheduled. The user is notified when ready. Check get_generation_status if they ask for progress.

Generate a content style guide (tone of voice, dos, don'ts, emoji & hashtag policy) from the user's saved business profile. Nothing is saved — show it to the user, apply their edits, then persist with save_style_guide.

Get the authenticated user's profile and business information.

Get the user's prepaid advertising wallet: available balance, reserved funds, service fee, and recent transactions. Amounts are in cents.