Configuration for the built-in HTTP server that powers your deployment's routes and endpoints.
HttpConfig()| Name | Type |
|---|---|
| app | str |
| disable_assistants | bool |
| disable_threads | bool |
| disable_runs | bool |
| disable_store | bool |
| disable_mcp | bool |
| disable_a2a | bool |
| disable_meta | bool |
| disable_ui | bool |
| disable_webhooks | bool |
| cors | CorsConfig | None |
| configurable_headers | ConfigurableHeaderConfig | None |
| logging_headers | ConfigurableHeaderConfig | None |
| middleware_order | MiddlewareOrders | None |
| enable_custom_route_auth | bool |
| mount_prefix | str |
Optional. Import path to a custom Starlette/FastAPI application to mount.
Format: "path/to/module.py:app_var" If provided, it can override or extend the default routes.
Optional. If True, /assistants routes are removed from the server.
Default is False (meaning /assistants is enabled).
Optional. If True, /threads routes are removed.
Default is False.
Optional. If True, /runs routes are removed.
Default is False.
Optional. If True, /store routes are removed, disabling direct store interactions via HTTP.
Default is False.
Optional. If True, /mcp routes are removed, disabling default support to expose the deployment as an MCP server.
Default is False.
Optional. If True, /a2a routes are removed, disabling default support to expose the deployment as an agent-to-agent (A2A) server.
Default is False.
Optional. Remove meta endpoints.
Set to True to disable the following endpoints: /openapi.json, /info, /metrics, /docs. This will also make the /ok endpoint skip any DB or other checks, always returning {"ok": True}.
Default is False.
Optional. If True, /ui routes are removed, disabling the UI server.
Default is False.
Optional. If True, webhooks are disabled. Runs created with an associated webhook will
still be executed, but the webhook event will not be sent.
Default is False.
Optional. Defines CORS restrictions. If omitted, no special rules are set and cross-origin behavior depends on default server settings.
Optional. Defines how headers are treated for a run's configuration.
You can include or exclude headers as configurable values to condition your agent's behavior or permissions on a request's headers.
Optional. Defines which headers are excluded from logging.
Optional. Defines the order in which to apply server customizations.
Optional. If True, authentication is enabled for custom routes,
not just the routes that are protected by default.
(Routes protected by default include /assistants, /threads, and /runs).
Default is False. This flag only affects authentication behavior
if app is provided and contains custom routes.
Optional. URL prefix to prepend to all the routes.