Replace the sites allowed to frame the project's widgets
consoleSessionvg_session<token>The console's session cookie, set when you sign in. Every operation accepts it, at the role the operation names.
orgId*stringAuthorised orgId; the server must verify organisation/project ownership before any read.
1 <= lengthprojectId*stringAuthorised projectId; the server must verify organisation/project ownership before any read.
1 <= lengthapplication/json- body
allowedOrigins*array<>|The sites allowed to frame the project's widgets. Empty or null allows none.
items <= 20allowedOriginsRevision*integerThe allowedOriginsRevision read with the settings, checked atomically on save to prevent lost updates. It versions the sites alone; the thresholds revision does not move.
0 <= value <= 9007199254740991Persisted settings with the new revision.
application/json- response
revision*integerRevision checked atomically on save to prevent lost updates.
0 <= value <= 9007199254740991thresholds*storageBucket*|Configured storage destination label only, null when not configured. Never return access credentials.
transcriptRetentionDays*|Configured transcript retention, null when no policy is configured. No default retention is selected by this contract.
1 <= valuetraceRetentionDays*|Configured trace/metric retention, null when no policy is configured.
1 <= valuerecordingRetentionDays*|Configured audio retention, null when no policy is configured.
1 <= valueallowedOrigins*array<>|Configured embed framing origin allow-list, null when not configured. Missing configuration never authorises arbitrary origins.
allowedOriginsRevision*integerVersion of allowedOrigins alone, sent back with updateAllowedOrigins. Saving sites never moves revision, which versions the thresholds.
0 <= value <= 9007199254740991curl -X PUT 'https://example.com/api/v1/org/string/project/string/settings/allowed-origins' \ -H 'Content-Type: application/json' \ -d '{ "allowedOrigins": [ "string" ], "allowedOriginsRevision": 0}'{ "revision": 0, "thresholds": { "answerMs": 1500, "joinMs": 2000, "ttsStartMs": 1000 }, "storageBucket": "string", "transcriptRetentionDays": 1, "traceRetentionDays": 1, "recordingRetentionDays": 1, "allowedOrigins": [ "http://example.com" ], "allowedOriginsRevision": 0}Was this page helpful?