agent-embed

Put Embed Settings

Replace this agent's embed configuration. Owner only.

Origins are normalized and validated here rather than at read time, so a typo is a 422 the owner sees immediately instead of an allowlist entry that silently never matches anything.

put/api/agents/{agent_identity_id}/embed

Request

  • Base URL: https://app.thinqos.com (the document declares no server; this is the origin it was published from)
  • URL: https://app.thinqos.com/api/agents/{agent_identity_id}/embed
  • Auth: none declared

Path parameters

agent_identity_idstring uuid required

Headers

x-impersonate-identity-idstring nullable

Request body

expected_revisionstring nullable
enabledboolean
allowed_originsstring[]
display_namestring nullable
greetingstring nullable
starter_promptsstring[]
daily_turn_limitinteger
visitor_turn_limitinteger
page_awareness'manual' | 'text' | 'text_and_picture'
visitor_screen_shareboolean
acknowledge_public_exposureboolean

Response

Successful Response

revisionstring required
eligibleboolean required
eligibility_messagestring nullable required
app_urlstring required
agent_identity_idstring required
enabledboolean required
allowed_originsstring[] required
display_namestring nullable required
greetingstring nullable required
starter_promptsstring[] required
daily_turn_limitinteger required
visitor_turn_limitinteger required
page_awareness'manual' | 'text' | 'text_and_picture' required
visitor_screen_shareboolean required
snippetstring required

Changes

No recorded changes to this operation across all 2 revisions of this API.