Deployments

Deploying an Agent

Publish an agent for external end-user chat with managed limits and origin controls.

February 15, 2026
7 min read

Agent deployments let you expose one of your agents to end users outside the AffinityBots app.

What You Get

  • Public runtime endpoint for custom frontends
  • Hosted page at /deploy/{public_key}
  • Embeddable widget script
  • Per-deployment origin allowlists
  • Per-deployment rate and concurrency limits

Create a Deployment

  1. Open your agent page.
  2. Click Deployments.
  3. Create a deployment with a name, allowed origins, and runtime limits.
  4. Set status to active when ready.

Statuses

  • draft: not publicly callable
  • active: live and callable
  • paused: temporarily disabled
  • revoked: permanently disabled for its current key

Memory Behavior

By default, deployed chat uses external_user_id to persist conversation continuity.

  • If you provide external_user_id, the deployment reuses a mapped thread.
  • If omitted, each session is treated as anonymous.