Apps

A Chat app is the hosted configuration object the widget loads. Ids use the cha_ prefix. It is the Chat equivalent of a Feedback board: name, draft, published revision, toggles, branding, and allowed origins. It is not a conversation.

Create apps in the dashboard, via secret-key REST, or via MCP (create_app). MCP and the secret API can draft and publish. They cannot mint keys, delete apps, or open the Hosted inbox.

What an app is not

• Not a public chat URL. Chat is embed-only.
• Not a message store by itself. Storage is BYO or Hosted depending on mode.
• Not an end-user directory. Membership uses host-asserted ids inside conversations.

Draft then publish

Edit a draft, then publish a revision. Live clients keep the last published revision until you publish again. Publishing does not skip live entitlements. See revisions and configuration.

Related: Configuration · API overview · AGENTS.md · Conversations