FruxonDocs
ApiEmbed configs

Updates an embed config's origins, presentation draft, and enabled state.

Presentation is saved as a <b>draft</b> and does not reach visitors until publish — appearance is live on the customer's site the moment it changes, so the studio edits a working copy. Everything else applies immediately. Set `enabled=false` to disable an embed without deleting it — the gateway then rejects new sessions for its key while history is preserved. The key is unchanged; use rotateKey to invalidate live snippets.

PUT
/v1/tenants/{tenant}/agents/{agent}/embedConfigs/{embedConfig}

Authorization

Bearer
AuthorizationBearer <token>

JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.

In: header

Path Parameters

agent*string

The agent identifier.

embedConfig*string

The embed config id.

tenant*string

The tenant identifier

Request Body

The new origins, enabled state, and draft presentation.

allowedOrigins?array<string>
enabled?boolean
greeting?string|null
suggestedPrompts?array<string>
draftThemeJson?string|null

The presentation manifest being edited. Saved as a draft — it reaches visitors only on publish, because appearance changes are live on the customer's site the instant they land. Null clears the draft.

customCss?string|null

Operator CSS for the panel. Stored whatever the licence says, so a downgrade doesn't destroy it; served only while the licence allows it.

maxTurnsPerSession?integer|null

Maximum turns one visitor conversation may spend. Null removes the ceiling.

Formatint32
maxCostPerSession?number|null

Maximum USD one visitor conversation may accrue. Null removes the ceiling.

Formatdouble
accessMode?string

Who the widget admits. Null leaves it unchanged, so the appearance studio — which saves through this same full-replace body — cannot alter it by omission.

Value in"UNSPECIFIED" | "PUBLIC" | "REQUIRE_IDENTITY"
trustAnchorId?string|null

When present, points the widget at a tenant-level trust anchor — the anchor's secret (HMAC) or issuer (OIDC) then verifies identities, and verified users key per anchor rather than per widget. Null leaves the current anchor alone; Fruxon.Model.EmbedWidget.UpdateAgentEmbedConfigRequest.ClearTrustAnchor detaches it, returning the widget to its own local signing secret.

Formatuuid
clearTrustAnchor?boolean
[key: string]?never

Response Body

curl -X PUT "https://api.fruxon.com/v1/tenants/string/agents/string/embedConfigs/string" \  -H "Content-Type: application/json" \  -d '{}'
{
  "id": "string",
  "agentId": "string",
  "key": "string",
  "enabled": false,
  "allowedOrigins": [
    "string"
  ],
  "greeting": "string",
  "suggestedPrompts": [
    "string"
  ],
  "themeJson": "string",
  "draftThemeJson": "string",
  "hasUnpublishedChanges": false,
  "publishedAt": 0,
  "customCss": "string",
  "maxTurnsPerSession": 0,
  "maxCostPerSession": 0,
  "accessMode": "PUBLIC",
  "hasIdentitySecret": false,
  "trustAnchorId": "00000000-0000-0000-0000-000000000000",
  "createdAt": 0,
  "modifiedAt": 0
}
Empty
Empty
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}