Skip to main content
PATCH
Set the approved sites
Needs a live key (sk_live_...): approved sites are a live setting. A test key gets 403 live_key_required. The key’s owner must be an owner or admin of the business.
The list you send replaces the saved list. Send every site each time; an empty list removes them all. This is the same list as Settings → Developers → Approved sites in the dashboard. See Embedded checkout.
For a platform: to set the sites of a business you manage, put its id in the path and in the AgentaOS-Account header. The two must match, or the call returns 403 You cannot act as this business.
Webhook: none.

Authorizations

x-api-key
string
header
required

Your secret key, from app.agentaos.ai -> Settings -> Developers -> API Keys. The key's prefix is both its identity and its environment: sk_test_... (sandbox, free, no verification) or sk_live_... (real money, requires business verification). A missing or invalid key returns 401.

Path Parameters

id
string<uuid>
required

The business UUID.

Body

application/json
embedDomains
string[]
required

Every site the business approves, as https:// addresses. This list replaces the saved list.

Maximum array length: 10

Response

The saved list, as stored.

embedDomains
string[]
required

Every site the business approves, as https:// addresses. This list replaces the saved list.

Maximum array length: 10