Settings & configuration capabilities
These PieOS capabilities read and adjust your store's configuration — the settings side of running a store. As with everything PieOS does, configuration changes stay within your permissions and route through approvals.
| Capability | Plan | What it does |
|---|---|---|
get_capability_autonomy | Free | Read the current autonomy level Pie has for each of the 8 capability classes (marketing, CRM, schedu. |
get_connected_integrations | Free | List every integration / OAuth provider the creator has connected (or attempted to connect) — paymen. |
get_creator_profile | Free | Read the saved D1 creator persona (origin / product types / volume tier / business stage / autonomy . |
get_memory_facts | Free | List the active memory facts Pie has saved for the creator. Returns id + fact_text + source_of_truth. |
get_onboarding_status | Free | Read-only view over the creator's most recent onboarding session. Returns stage, progress, is_review. |
list_self_teach_questions | Free | List the self-teach questions Pie has raised for this tenant — and which are still pending, answered. |
summarize_my_account | Free | One-shot snapshot of the creator's PersonaCart account: store identity (name / country / currency / . |
get_domains | Free | Custom domains attached to the store + verification status. |
get_store_readiness | Free | Pre-publish checklist — products, pages, branding, payment setup. |
resume_onboarding | Free | Re-engage the creator with an active onboarding session that's been idle. Returns the last question . |
set_store_currency | Free | GUIDE a creator on their storefront currency. Pie does NOT change currency — currency is set by the . |
add_voice_sample | Free | Save a creator-supplied writing sample into pieos_voice_samples (mig 00850) as source_kind='manual'.. |
advance_onboarding | Free | Advance the onboarding stage machine. Stores the creator's answer in pending_answers under the curre. |
ask_creator_to_teach | Free | Raise a canonical question for the creator to teach Pie. Use a question_key from the seed bank (pric. |
cancel_onboarding | Free | Abandon the current onboarding session (status='abandoned'). Creator can later start a fresh session. |
dismiss_worry | Free | Mark a worry dismissed when creator says 'I know about that' / 'ignore this' / 'not a real concern'.. |
forget_fact | Free | Archive a memory fact so Pie stops considering it in future turns. Use exact fact_id (preferred — ca. |
mark_not_teachable | Free | Mark a self-teach question as 'cannot be taught here' so Pie stops re-asking. Use for questions that. |
record_teaching_answer | Free | Capture the creator's answer to a self-teach question. Updates pieos_self_teach_question.answer + au. |
remove_taste_value | Free | Soft-delete a creator preference (taste). Audit preserved. |
resolve_worry | Free | Mark a worry resolved when the underlying condition is gone (low_stock replenished, integration reco. |
revert_onboarding_stage | Free | Move the onboarding session back to an earlier stage. Useful when creator wants to revise an answer . |
review_onboarding | Free | At review_1 / review_2 stages, approve or edit the recap. approve=true writes the confirmed fields t. |
seed_self_teach_questions | Free | UPSERT the canonical seed bank of self-teach questions into pieos_self_teach_question for the curren. |
set_business_address | Free | Save the storefront's public business address (line1, line2, city, state, postal_code, country) into. |
set_capability_autonomy | Free | Pause or resume Pie's autonomous action on a specific capability class (e.g. marketing publishing, C. |
set_creator_profile | Free | Save persona answers into pieos_creator_profile so the D1-base CreatorPersona block can render them . |
set_legal_pages | Free | Save the storefront's terms-of-service and/or privacy-policy URL into checkout_settings. These show . |
set_memory_fact_lock | Free | Toggle creator_locked on a memory fact. Locked facts are immune to agent-initiated updates (only the. |
set_social_handle | Free | Save the creator's social handle (Instagram, YouTube, Twitter/X, Facebook, TikTok, LinkedIn, Pintere. |
set_store_country | Free | Country/currency is LOCKED after onboarding and CANNOT be changed here. This tool does NOT change th. |
set_support_contact | Free | Save the storefront's public support email and/or support phone number into tenant_settings. These s. |
set_taste_value | Free | Save a creator preference (taste) — style, tone, taboo, philosophy. Goes BEYOND memory facts; used b. |
set_timezone | Free | Set the storefront's timezone (tenants.timezone). Every time-scoped feature — scheduled campaigns, '. |
snooze_worry | Free | Snooze a worry for N hours (default 24, max 720 = 30d). Hidden from topbar pill until snoozed_until . |
start_onboarding | Free | Start (or resume, if an active session already exists) the multi-step onboarding journey. Returns th. |
update_creator_identity | Free | Authoritatively update the creator's personal name (sign-offs) and/or store brand name across the wh. |
invite_team_member | Free | Invite a team member by email with a role (owner/admin/editor/viewer). |
update_brand_settings | Free | Update brand fields — store name, tagline, font, favicon (saved to brand settings). NOTE: storefront. |
update_checkout_settings | Free | Update checkout flags — shipping/billing required, tips, coupons, terms links. |
update_email_sender_settings | Free | Update email sender identity — sender prefix and reply-to. |
update_notification_preferences | Free | Toggle which events the creator gets notified about (orders, stock, reviews, digest). |
update_shipping_settings | Free | Update shipping config — free shipping threshold, default rate, origin country. |
43 of 201 capabilities. Generated from the live PieOS capability matrix.
Can PieOS change my store settings?
It can read and propose configuration changes, within the permissions you've granted. Consequential changes wait for your approval before they take effect.
What this screen looks like in every state
| State | When you'll see it | What you see, and what to do |
|---|---|---|
| Loading | The screen is fetching your data | A skeleton in the shape of the finished page. It should be brief — if it persists, the load has failed rather than stalled. |
| Error | The data couldn't be loaded | A message with a retry. Retry first: most of these are a dropped request, not a broken store. If it repeats, the outage is upstream and reloading won't help. |
| No access | Your role doesn't include this screen | A permission notice instead of the page. An owner or admin can grant access under Settings → Team. |
When something goes wrong
These are the messages this screen can show you, and what each one means.
| If you see | What to do |
|---|---|
| Failed to save profile | The file was rejected. Check its size and type against what the field accepts. |