The workspace is the business. Its name is the business name, and its business details are saved on the workspace. Posts use these details.
Steps#
- Call
get_workspacewith the selectedworkspaceId. Readprofile. - If the owner starts from a website, use
prepare_website_importand giveimportUrlto the owner. Readlist_website_importsandget_website_importfor saved results. - Call
update_workspacewith only the fields to change. A list field replaces the saved list. Use only facts that the owner gave you. - Call
create_post. A post may cite insourceFactsonly the strings inprofile.approvedFacts.
A save takes effect at once. There is no owner confirmation, and the last completed save wins. The owner edits the same details on the Dashboard.
Brand text (brandText): up to 8,000 characters of product context used by caption suggestions and Studio. Updated 2026-10-17.
A website scan saves the brand styles of the home page: colors, fonts, corner radius and button style. get_website_import returns them in branding. The owner can change them in the profile review and confirms them with the profile. The confirmed brand is in approvedProfile.profile.brand.
Only the confirmed brand is used. It guides the media prompt of a planned post and the Studio handoff of a post. A scan that the owner did not confirm has no effect on these prompts. The video brand kit suggestion uses the confirmed colors first.
Saved owner answers take priority over scan suggestions. A cleared answer stays empty after Save and reload. Suggestions fill only questions without a saved answer. A home-page refresh replaces the brand only when it captures usable colors or fonts. The previous brand remains available with Undo. A refresh without usable styles keeps the prior brand.
Updated 2026-10-31: when Spanish is available for the owner's account, the business details form, the website import and its notices show the account language, English or Spanish. The language does not change saved details, imported website text, facts, brand values or what get_workspace returns. Before a save, the owner form checks that a website is empty or starts with http:// or https://.
Website action prices#
Updated 2026-10-16. The owner sees separate Capture and Analysis credit prices before a scan. Refresh and Add page each approve both steps; Analyze saved sources approves analysis only. Both actions currently cost zero credits. When billing enforcement is enabled, they still require AI access on the account, except for an owner on the billing enforcement bypass. See billing.
A queued action keeps the displayed quotes and request identity. A price change or expired approval requires another owner action. Reopening or polling an import only reads saved state.
Updated 2026-10-23. An approval expires only when the action holds credits, and it expires when that hold ends (one hour after the action is queued). With billing off, or when the action costs zero credits, nothing is held and a queued action can start at any time. An action queued before billing existed also runs with billing off. Agents can read evidence and return an owner handoff; they cannot start these provider calls.
Capture success stays recorded if analysis or later processing fails. If a provider outcome is unknown, ShipContent keeps the submitted operation and does not send it again. Firecrawl capture has no saved retrieval receipt; website analysis uses OpenAI with response storage off. A new Refresh or Analyze action is a separate operation.
Updated 2026-10-17: after an uncertain evidence or image save, keep the same import and file. Recovery checks the existing bytes and does not issue a replacement write while the first result is unresolved. WEBSITE_FILE_CONFLICT means the requested bytes differ from that saved identity. STORAGE_FENCED pauses new file writes and asset saving; saved metadata remains readable. Imported images reserve their library bytes before writing. Evidence files remain outside the library quota.