> For the complete documentation index, see [llms.txt](https://help.contouron.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.contouron.com/support/faqs.md). # FAQs > For the complete documentation index, see [llms.txt](https://help.contouron.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.contouron.com/support/faqs.md). ## FAQs ### How do I get back to the main page? Click the Contouron logo in the top left corner from any screen. This takes you back to the home page. You can also use the left sidebar to navigate between sections (New post, Published, Calendar, Videos, Settings). The sidebar is collapsed by default and expands when you hover over it. *** ### Don't know where to start? 1. To make your first 5 posts, follow this guide: [Make Your First 5 Posts](https://help.contouron.com/getting-started/make-your-first-5-posts) 2. To make your first video or carousel, open the [Contouron AI Agent](https://my.contouron.com/agent) and describe what you want. The AI Agent uses your [Brand Kit](https://help.contouron.com/settings/brand-kit) for on-brand copywriting and visuals. You can chat with the AI to make changes to your visuals. 3. To use Contouron with Claude.ai, Claude Code, or other AI tools, start here: [MCP Server Setup](https://help.contouron.com/api/mcp) *** ### Where is the AI Agent screen? The AI Agent is in the left sidebar. The sidebar is collapsed by default -- hover over it to expand, then click "New post." You can also go directly to: [my.contouron.com/agent](https://my.contouron.com/agent) *** ### My screen is blank and only shows "What would you like to do?" / I can't see my calendar or settings Type anything into the prompt box and press Enter. This takes you into the full AI Agent. This screen is not broken or blank. The "What would you like to do?" screen is the AI Agent prompt screen, not an error. 1. Type anything into the prompt box, then press Enter. 2. You go straight into the full AI Agent at [my.contouron.com/agent](https://my.contouron.com/agent). 3. To reach Calendar, Videos, or Settings, hover over the left sidebar to expand it, or click the Contouron logo in the top left. *** ### Where are my generated images and videos? All visuals you generate — images, carousels, videos, infographics, slideshows — are saved at [Videos](https://my.contouron.com/videos), regardless of how you created them (web app, API, or MCP). If you can't find a visual, go directly to [my.contouron.com/videos](https://my.contouron.com/videos) and look for your recent creations there. To download or publish a visual, click on it in the Videos library to open the editor. *** ### What are the AI Agents in Contouron? Contouron has two ways to create with AI: 1. **AI Agent** — the main agent at [my.contouron.com/agent](https://my.contouron.com/agent). Chat to write posts and captions and to create visuals, using your [Brand Kit](/settings/brand-kit.md). 2. **Video AI Agent** — generates AI videos and image carousels from templates. Go to [Videos > New](https://my.contouron.com/videos/new) and choose "Create Everything with AI Agent." *** ### My post shows "published" but does not appear on the platform Platforms sometimes delay surfacing new posts, or suppress them after accepting the upload. This is common when uploading video content. 1. Wait 10-15 minutes -- some platforms delay new posts before they appear in feeds 2. Check your [API Dashboard](https://my.contouron.com/api-dashboard) or [Published Posts](https://my.contouron.com/queue/calendar) for the post URL 3. Open the post URL directly -- if it returns a 404, the platform removed it after accepting the upload 4. If posts are consistently suppressed, reduce posting frequency and engage with your account organically for a few days If Contouron shows "published" with a valid post URL, the post was delivered to the platform. Removal or suppression after delivery is a platform-side action. *** ### Which social platforms does Contouron support? Is Substack supported? Contouron publishes and crossposts to: Instagram, TikTok, LinkedIn, Facebook, X (Twitter), Threads, Bluesky, Pinterest, and YouTube. Substack is not a supported platform. You cannot crosspost to Substack from Contouron -- not in the web app, the API, or via MCP/Cowork. #### Unofficial workaround for Substack Notes Contouron does not officially support this method, and Substack does not officially allow automated posting, so you use it at your own risk. You build and run it yourself, outside Contouron. 1. Open Substack in your browser with Claude for Chrome 2. Post a Note on Substack manually 3. Ask Claude to reverse engineer the network request Substack sends when you post the Note 4. Replicate that request in your own automation tool, such as n8n 5. Send your Note content through that request to post programmatically For the account types supported per platform, see [Social Accounts](/settings/social-accounts.md). *** ### Can I add a blog or publish to WordPress? You cannot connect a blog or WordPress site as a social account in Contouron. The account connection flow is for social platforms only (Instagram, TikTok, LinkedIn, Facebook, X, Threads, Bluesky, Pinterest, and YouTube). To publish to a blog, WordPress, or any other custom destination, use the **webhook** publish target. Contouron sends your post data to a webhook URL you control, and your own automation receives it and posts to your blog. #### Using Contouron API (n8n / Make.com) 1. In the Publish Post node, set the target type to `webhook` 2. Set `url` to your webhook endpoint 3. Contouron sends the post content (text and media URLs) to that URL 4. Your workflow (n8n, Make, Zapier, or a custom endpoint) receives the data and publishes it to WordPress or your blogging platform See: Publish Post -- Webhook target *** ### How do I connect my social accounts? 1. Go to [Settings](https://my.contouron.com/settings) 2. Log into the social account you want to connect (in a separate tab) 3. Click the "Login with \[Platform]" button for your platform 4. Approve the permissions For platform-specific instructions and troubleshooting, see: [Connect Social Accounts](https://help.contouron.com/settings/social-accounts) *** ### When do posts publish immediately vs get scheduled? Posts publish **immediately** when: * No scheduling fields are provided (`scheduledTime` and `useNextFreeSlot` are both omitted) * `useNextFreeSlot: true` but no available slots exist in your calendar for that platform Posts get **scheduled** when: * `scheduledTime` is provided (exact time scheduling) * `useNextFreeSlot: true` and available slots exist **Priority order** (if both scheduling options are provided): 1. `scheduledTime` takes priority over `useNextFreeSlot` **Common mistake**: Setting `useNextFreeSlot: true` without setting up any schedule slots at [Schedule Slots](https://my.contouron.com/queue/slots). This causes immediate publishing because no slots are available. To schedule posts: 1. First create schedule slots at [Schedule Slots](https://my.contouron.com/queue/slots) 2. Then use `useNextFreeSlot: true` or provide a specific `scheduledTime` *** ### How do I create an Instagram Reel or TikTok video? There are two ways, depending on whether you already have a video or need Contouron to generate one. #### Option A: Post your own video Use this if you already filmed a video on your phone or have a video file ready. The easiest way is the [Contouron AI Agent](https://my.contouron.com/agent). Upload your video, describe what you want, and crosspost to multiple platforms in a few clicks. The AI Agent writes captions using your [Brand Kit](/settings/brand-kit.md) and lets you publish to all your platforms at once. You can also use the [AI Agent](https://my.contouron.com/agent) directly: 1. Add Context (your website, a text description, etc.) so Contouron generates relevant captions 2. Select your platforms (Instagram, TikTok, etc.) and click "Generate Posts" 3. Edit the generated captions to match your voice 4. Click "Add Media" on the post and upload your video file (MP4 format) 5. When you attach a video to Instagram, it automatically posts as a Reel 6. Schedule or publish Note: You do not need to select "media type" or "Reel" anywhere. When you attach a video, Contouron automatically publishes it as a Reel. #### Option B: Generate a video with Contouron Use this if you want Contouron to create an AI video from a script or idea. 1. Open the [Contouron AI Agent](https://my.contouron.com/agent) and describe the video you want 2. The AI Agent generates your video using your [Brand Kit](/settings/brand-kit.md) for on-brand visuals and copywriting 3. Chat with the AI to make changes -- update text, swap images, change styles 4. For AI video with AI voice, ask the AI Agent for a video with voiceover 5. Click "Export Video" when done 6. Click "Create Post" to publish it as an Instagram Reel or TikTok video You can also create visuals directly in Claude Code and Antigravity: [Watch tutorial](https://youtu.be/3HVH2Iuplqo) *** ### How do I edit my video with prompts? Open the [Contouron AI Agent](https://my.contouron.com/agent) and chat with the AI to create or edit your visuals. The AI Agent uses your [Brand Kit](/settings/brand-kit.md) and lets you describe changes in plain language -- swap images, update text, change colors, or adjust the style. For manual editing in the video editor: 1. Open the video in the editor 2. Click any GREEN image or video clip 3. Update the prompt in the left panel to describe the new scene 4. Click "Generate" or "Regenerate" to remake that clip 5. Be specific in your prompts -- vague prompts give the AI too much freedom *** ### How do I add audio or music to my content? It depends on the content type: * In the Contouron video editor, click "Audio" in the left sidebar to upload your own music or sounds before exporting your video. See: Custom Assets * For AI-generated voiceover, select the 2nd template when creating a new video. This generates AI voice synced to each scene. See: AI Voiceover & Captions * For TikTok slideshows via API, set `autoAddMusic: true` in the Publish node to add TikTok's recommended music (photo/slideshow posts only). * For Instagram Reels, if your video already has audio it will play when posted. To add a music track before posting, use the Contouron video editor. For single image posts and carousels, music cannot be added through Contouron — publish first, then add music in the Instagram app. * To add trending music to an existing video before posting, use the "Combine Clips and Apply Basic Edits" template. Pass your video and a music URL. See: How do I add music to my video/reel before posting? *** ### How do I add music to Instagram posts, reels, and carousels? **Reels:** If your video already has audio, it will play when posted. To add a music track before posting, use the Contouron video editor — click "Audio" in the left sidebar to upload a music file, then export the video with the audio included. **Single image posts and carousels:** Music cannot be added through Contouron. Publish your post first, then open it in the Instagram app and add music there. Note: TikTok supports auto-adding music via API with `autoAddMusic: true`. Instagram does not have an equivalent. *** ### If I post to Instagram through Contouron, will it also cross-post to Facebook automatically? Yes — if you have Instagram's native "Share to Facebook" setting enabled, posts made through Contouron will still be automatically cross-posted to Facebook by Instagram. This works because the cross-post happens at the Instagram platform level, not at the Contouron level. Contouron posts to Instagram via the API, and Instagram then applies your account's cross-posting settings just like it would for any other post. To enable or disable this: open the Instagram app → Profile → Settings → Account → Sharing to other apps → Facebook. If you want to post to both Instagram and Facebook independently (with different captions or formats), connect both accounts in Contouron and select each one when publishing. *** ### What uses credits and what doesn't? Credits are only used for AI-generated images and videos: Uses credits: * Generating AI images (text-to-image) * Generating AI video clips (image-to-video) Does NOT use credits: * AI voiceover generation * Publishing or scheduling posts * Adding context (YouTube, articles, text) * Generating text captions with AI * Uploading your own images or videos * Using the AI Agent On the free trial, you receive a limited number of AI credits. Each time you click "Generate" on an image or video, credits are spent -- even if you're testing. To check your balance, go to [Settings > Billing](https://my.contouron.com/settings/billing). For a full credit cost breakdown per model, see: AI Video Credits *** ### How do I upload my own video or image to schedule a post? The easiest way is the [Contouron AI Agent](https://my.contouron.com/agent). Upload your media, describe your post, and crosspost to multiple platforms in a few clicks. You can also upload directly in the [AI Agent](https://my.contouron.com/agent): 1. Open an existing draft post or click "+ Add Post" to create a new one 2. Click "Add Media" on the post 3. Upload your video or image file 4. Click Schedule > Next Free Slot to schedule it "Add Media" is for attaching your own images or videos to a post. This is different from "+ Add Context", which is for adding raw materials that Contouron uses to generate draft content. You cannot upload images or photos as Context. Supported context types: YouTube video, TikTok video, article/website URL, PDF, audio file, tweet/X post, raw text, and AI web research (Perplexity). *** ### How do I get AI to write a caption for my photo? You cannot upload a photo as Context. Context is for text-based content (YouTube links, articles, text, etc.). To get an AI-generated caption for your photo: 1. Go to the [AI Agent](https://my.contouron.com/agent) 2. Add text Context describing what the photo is about 3. Click "+ Add Post" to generate a draft post from your text 4. Click "Add Media" on the post to attach your photo 5. Edit the caption with Chat as needed *** ### Can I create content in both English and Spanish? Do I need to switch a language setting each time? Yes, you can create content in both languages. There is no language setting or toggle to switch. The output language follows your input: * AI videos: write your script in Spanish and Contouron generates the Spanish voiceover automatically. Spanish is fully supported. * Text posts: the AI Agent writes in whatever language you prompt it in. To publish to both audiences, create two separate posts (one per language) and cross-post each to the matching accounts. For example, publish the Spanish post to your Spanish YouTube channel and the English post to your English channel. You can connect more than one YouTube channel to Contouron. For the full list of supported languages, see [Translate languages](/tips-and-tricks/translate-languages.md). *** ### Stuck in onboarding? 1. Click "Reveal Full Week" 2. Wait for all 7 days of posts to be created 3. Click "Schedule Week" to enter the app *** ### What are the current plans and pricing? For the most up-to-date pricing and plan details, visit: [contouron.com/pricing](https://www.contouron.com/pricing) Contouron includes AI video generation, AI carousels, AI copywriting, scheduling, and publishing to all platforms. For comparison, [Buffer charges $83/month](https://buffer.com/pricing) for posting to 20 channels, and that covers scheduling and posting only -- no AI content creation, no video generation, no carousels. ![Buffer pricing for 20 channels](/files/J6xMVZ1mq36bkItsoCHm) *** ### How do I get the $50 Trustpilot review reward? Contouron sends a $50 gift card to customers who leave a review on Trustpilot. 1. Write a review for Contouron on Trustpilot 2. Reply in the in-app support chat to let the team know you left a review 3. Sabrina verifies your review and emails your $50 gift card Sabrina handles each reward personally, so allow a few business days for your gift card to arrive. If you already left a review and have not received your gift card, reply in the support chat with the name on your Trustpilot review and the email where you want the gift card sent. *** ### Can I schedule a call, Zoom meeting, or screen-share with the Contouron team? Contouron does not offer Zoom calls, phone calls, or live meetings with customers. All support happens in the in-app chat. The support team guides you step by step in chat instead. Describe what you are trying to do, and share screenshots or screen recordings of where you are stuck. You get the same walkthrough you would get on a call, in writing you keep. *** ### How does the referral program work? / My referral wasn't credited Contouron's referral and affiliate program runs through Tolt. Referrals are tracked and approved automatically, not by hand in Contouron. 1. Share your referral link from your Tolt affiliate dashboard. 2. When someone signs up through your link and completes a paid subscription through Stripe, Tolt tracks the referral and credits you per the program's rules. 3. Commission approval and payout timing are managed in Tolt, so check your Tolt affiliate dashboard for status. A referral does not get credited if the referral link was not used, cookies were blocked, or the purchase did not go through the tracked checkout. If you believe a referral was missed, reply in the support chat with the referred customer's email so the team can check. *** ### How do I start my paid subscription? / How do I pay? You have 2 options to start your paid subscription: 1. **Upgrade in-app** — go to [Settings > Billing](https://my.contouron.com/settings/billing) and click "Upgrade" on the plan you want. 2. **Upgrade via Stripe checkout link** — use the checkout link from the pricing page or from a Contouron email. Contouron uses Stripe for billing. After checkout, your plan activates immediately and credits refresh per your plan. *** ### How many scheduled posts can I have in my queue? The number of future-dated posts you can schedule depends on your plan: | Plan | Scheduled posts limit | | ------- | --------------------- | | Starter | 100 | | Creator | 500 | | Agency | Unlimited | These limits apply to posts with a future `scheduledTime` or posts waiting in schedule slots. Published posts do not count toward the limit. If you hit the limit, publish or delete some scheduled posts, or upgrade your plan. See: [Plan Limits](/settings/billing-and-credits.md#plan-limits) *** ### How far in advance can I schedule posts? How far ahead you can schedule depends on your plan: | Plan | Scheduling horizon | | ------- | ------------------ | | Starter | 9 months ahead | | Creator | 1 year ahead | | Agency | 2 years ahead | If you try to schedule a post past your plan's horizon, Contouron returns an error. Pick a time within your plan's window or break longer campaigns into shorter batches. See: [Plan Limits](/settings/billing-and-credits.md#plan-limits) *** ### Can I send a post for approval before publishing? Contouron does not have a built-in approval-link feature in the web app. You have two options: #### Using Contouron Web App 1. Create your post and schedule it for a future time. 2. Review all scheduled posts in the **Upcoming Posts** screen ([my.contouron.com/queue/schedules](https://my.contouron.com/queue/schedules)). 3. To pause a post for edits, open the three-dot menu and choose **Move to Drafts**. 4. Publish or reschedule once you are satisfied. #### Using Contouron API (n8n / Make.com) Build an approval gate in your workflow: 1. Generate the post content. 2. Add a Slack or email notification step that sends the draft to your reviewer. 3. Wait for an approval signal, for example a webhook triggered by the reviewer. 4. Run the Publish step only after approval, using `scheduledTime` to publish at a set time. See: Write and publish social posts with AI *** ### What is the maximum file size I can upload? Upload size depends on your plan: | Plan | Max media upload size | | ------- | --------------------- | | Starter | 400 MB | | Creator | 1 GB | | Agency | 1 GB | If your file is too large, compress or trim it, or upgrade your plan. See: [Plan Limits](/settings/billing-and-credits.md#plan-limits) *** ### Can I manage multiple client accounts as an agency? Currently, agencies using Contouron have each client sign up for a separate Contouron account with a shared email address so you can log in and manage it. Your client signs up, connects their social accounts, and then you log in to manage their account. There is no automatic way to connect another business's or client's social pages into your own account -- each business uses its own Contouron account, so you connect their pages once inside that account rather than adding each one manually to yours. A master agency account for managing all client subaccounts from one dashboard is not available yet, and there is no firm release date. *** ### How do I connect ChatGPT? You do not need to connect ChatGPT to Contouron. Contouron already integrates with ChatGPT under the hood. *** ### How do I connect multiple social accounts? / Connecting to the wrong account? You don't need to create multiple Contouron accounts -- connect all your social accounts under one Contouron login. You can connect up to **20** social accounts on the **Starter** plan, **40** on **Creator**, and **100** on **Agency**. Facebook Pages and LinkedIn Company Pages don't count toward this limit. To connect an account, go to [Settings](https://my.contouron.com/settings) and click the **"Login with \[Platform]"** button. If you're connecting a second account for the same platform, look for a button with 3 dots to switch between accounts and select the correct one. If that doesn't work, or if it keeps auto-logging into the wrong account, use an incognito browser as a last resort: 1. Open an incognito Chrome browser 2. Log into the social account you want to connect 3. Go to [my.contouron.com/settings](https://my.contouron.com/settings) 4. Connect your social account See [Social accounts](/settings/social-accounts.md#account-limits) for full account limits. *** ### How do I reconnect a social account? / My social account expired Social platforms require you to reauthorize 3rd-party apps periodically for security. To reconnect your account: 1. Go to [Settings](https://my.contouron.com/settings) 2. Find the account you want to reconnect 3. Click the blue "Reconnect" button Only use "Login with \[Platform]" if you want to connect a new social account. If you have issues reconnecting, use an incognito Chrome browser, log into the social account first, then log into Contouron and reconnect. *** ### Unable to login? Log in here: [my.contouron.com/login](https://my.contouron.com/login) Contouron uses magic link authentication, so there is no password. Simply enter your email, then grab the verification code sent to your email. There is no way to change or manage your password because Contouron does not use passwords. :bulb: Magic link authentication is more secure than passwords because it eliminates the risk of choosing weak or reused passwords that can be phished or brute-forced. It relies on one-time, time-limited links sent to a verified email, reducing the overall attack surface and risk of compromised passwords. *** ### How do you update your email? 1. Log into Contouron with your current email 2. Go to [Profile](https://my.contouron.com/settings/profile) 3. Change your email to the new one and click "Update Email" 4. Contouron sends a verification code to your new email 5. Enter the verification code in the prompt that appears in Contouron The verification code is sent to the new email address, not the old one. Check your spam folder if you do not see it. The code expires after a few minutes -- if it expires, click "Update Email" again to get a new code. You must be logged in to make the change. If you are locked out of your account, submit a help request via the in-app support messenger (orange circle in the bottom right corner). *** ### I want to use Contouron with a different email. Do I lose my credits or content? Change the email on your existing account instead of creating a new one. This keeps your credits, videos, posts, and settings. 1. Log into Contouron with your current email 2. Go to [Profile](https://my.contouron.com/settings/profile) 3. Change your email to the new one and click "Update Email" 4. Enter the verification code sent to your new email Credits and content are tied to your account and do not transfer between separate accounts. If you cancel a subscription, your remaining credits are deleted, so creating a second account means starting fresh. Changing your email on your existing account avoids this. *** ### How do I log out of Contouron? To log out of Contouron, go to [Settings](https://my.contouron.com/settings), click Profile tab, and click Log Out button. *** ### Where do I find key Contouron pages? * [Settings](https://my.contouron.com/settings) * [AI Agent](https://my.contouron.com/agent) * [Videos Dashboard](https://my.contouron.com/videos) * [Create New Video](https://my.contouron.com/videos/new) * [Upcoming Posts Calendar](https://my.contouron.com/queue/schedules) * [API Dashboard](https://my.contouron.com/api-dashboard) * [Billing](https://my.contouron.com/settings/billing) * [API Keys](https://my.contouron.com/settings/api) * [Brand Kit](https://my.contouron.com/settings/brand) * [Profile](https://my.contouron.com/settings/profile) *** ### Can I add a first comment to a scheduled post? Contouron has no one-click first comment field on scheduled posts. For Instagram, add the comment through the Contouron API or MCP after your post publishes. Call [Post Comment](/api/comments.md#post-comment) (or the `contouron_post_comment` MCP tool) with the published post's ID. In n8n or Make, add a Post Comment step after your publish step. For other platforms, open the post on the platform after it publishes and add your comment manually. *** ### How do I delete my account? / How do I cancel my account? Go to [Settings > Billing](https://my.contouron.com/settings/billing) and click "Open Billing Portal" to cancel your subscription. There are no long-term commitments. You can cancel anytime. For more details, see: [Billing & Credits](https://help.contouron.com/settings/billing-and-credits#cancel-account) *** ### Can I pause or freeze my subscription instead of cancelling? Contouron does not have a pause or freeze feature. You have two choices: 1. Keep your subscription active to retain your credits, scheduled posts, and access. 2. Cancel from [Settings > Billing](https://my.contouron.com/settings/billing) > Open Billing Portal. Cancelling takes effect immediately and you lose: * All remaining AI credits. If you resubscribe, you start fresh with your plan's default credits. * All scheduled posts. They will not be published. If you only want a short break, keep your subscription rather than cancelling, because cancelling removes your remaining credits and scheduled posts. *** ### I cancelled my subscription but want to access my old videos After cancelling your subscription, Contouron shows a reactivation modal when you log in. You cannot access the app (including previously created videos, posts, and settings) without an active subscription. To regain access: 1. Go to [my.contouron.com/login](https://my.contouron.com/login) and log in 2. Click "Reactivate" on the subscription modal 3. Your old videos, posts, and settings will still be there Your content is not deleted when you cancel. It remains saved and will be available when you reactivate. *** ### Markdown (e.g. asterisks) appearing in your post? Most social platforms do NOT support markdown. You have 2 options to remove markdown from your post: 1. Instruct Chat to "remove markdown" 2. Permanently disable markdown by going to Settings > Disable Markdown (toggle). *** ### How do I add or tag collaborators to my Instagram post? > **Note:** Collaborators are supported on **single image posts and reels**. They are **not supported on carousels** (multi-image/video posts) - a carousel with collaborators will fail to publish. For a carousel, publish it first, then add collaborators manually in the Instagram app. 1. Create your post in Contouron with a single image or video attached. 2. In the post editor, find the **Collaborators** field. 3. Enter the Instagram username(s) of your collaborator(s). 4. Publish or schedule the post. Your collaborator(s) receive an invitation in Instagram and must accept before the post appears on their profile. *** ### Why is my Pinterest account not verified? New Pinterest accounts need a 2-3 week manual warm-up and validation before boards appear through automation. See [Why is my Pinterest account not verified?](#why-is-my-pinterest-account-not-verified). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.contouron.com/support/faqs.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.