Your store's policies

Your store has seven policies, written for your business from its settings, your country and what your store runs. Each change is a new draft version; shoppers see a version only once you approve it, and every earlier version is kept for the orders placed under it.

`kind`	Served at
`terms_of_sale`	`/policies/terms`
`returns`	`/policies/returns`, with the model cancellation form
`delivery`	`/policies/delivery`
`privacy`	`/policies/privacy`
`cookies`	`/policies/cookies`
`accessibility`	`/policies/accessibility`
`product_safety`	`/policies/product-safety`

1. Write them

POST /v1/site_policies/generate drafts every policy whose words would change, and nothing for the rest. Tuppence also drafts one by itself when an input changes, such as a new returns window.

curl -sS -X POST https://api.tuppence.ai/v1/site_policies/generate \
  -H "Authorization: Bearer $TUPPENCE_SECRET_KEY"

import { Tuppence } from "@tuppence/node";

const tuppence = new Tuppence(process.env.TUPPENCE_SECRET_KEY);
const policies = await tuppence.request("POST", "/v1/site_policies/generate", { body: {} });

import os
from tuppence import Tuppence

tuppence = Tuppence(os.environ["TUPPENCE_SECRET_KEY"])
policies = tuppence.request("POST", "/v1/site_policies/generate", body={})

2. Approve a draft

Each policy has live_version and draft_version. Approving the draft makes it live: POST /v1/site_policy_versions/{id}/approve. Versions are immutable: a correction is a new version.

3. Add your own words

POST /v1/site_policies/{id}/own_words adds up to 8 paragraphs under your terms, returns or delivery text, as a new draft. They can’t take away a shopper’s legal rights: words like no refunds are refused unless the paragraph names goods the law excepts (exception, such as made_to_order) that your store sells.

Events

Event	When
`policy.version_drafted`	A new draft is written
`policy.version_published`	You approve a draft

Over MCP and the assistant

Tool	Scope	Does
`list_policies`	`policies:read`	Each policy’s address, live version and waiting draft
`approve_policy_version`	`policies:write`	Publishes a draft. A person approves it, every time

No tool writes or edits a policy’s words.

Next