Deployments

Public Chat API

Reference for the deployed-agent public runtime endpoint.

February 15, 2026
8 min read

Endpoint

POST /api/deployed/chat/{public_key}

Request

{
  "messages": [{ "role": "user", "content": "Hello" }],
  "external_user_id": "user_123",
  "thread_id": "optional-thread-id",
  "config": {
    "configurable": {
      "web_search_enabled": false,
      "image_generation_enabled": false
    }
  }
}

Response

Streaming NDJSON lines:

{"event":"messages","data":{...}}

Metadata events include thread_id for client reuse.

Errors

  • 403 deployment inactive or origin blocked
  • 429 deployment rate/concurrency/budget limit reached
  • 501 workflow deployments not yet implemented