bytedance/deer-flow · error · HTTPException

Channel provider is not enabled

Error message

Channel provider is not enabled

What it means

Error "Channel provider is not enabled" thrown in bytedance/deer-flow.

Source

Thrown at backend/app/gateway/routers/channel_connections.py:579

    disconnected = await repo.disconnect_connection(
        connection_id=connection_id,
        owner_user_id=_get_user_id(request),
    )
    if not disconnected:
        raise HTTPException(status_code=404, detail="Channel connection not found")
    return Response(status_code=204)


@router.delete("/{provider}/runtime-config", response_model=ChannelProviderResponse)
async def disconnect_channel_provider_runtime(provider: str, request: Request) -> ChannelProviderResponse:
    await require_admin_user(request, detail=_ADMIN_REQUIRED_DETAIL)
    config = await _get_channel_connections_config(request)
    if not config.enabled:
        raise HTTPException(status_code=400, detail="Channel connections are disabled")

    provider_config = _provider_config(config, provider)
    if not provider_config.enabled:
        raise HTTPException(status_code=400, detail="Channel provider is not enabled")

    try:
        repo = _get_repository(request, config)
    except HTTPException as exc:
        if exc.status_code != 503:
            raise
        repo = None

    current_channels_config = await _get_channels_config(request)
    candidate_channels_config = dict(current_channels_config)
    candidate_channels_config.pop(provider, None)

    stopped = await _sync_runtime_channel_after_removal(provider, candidate_channels_config)
    if stopped is False:
        display_name = _PROVIDER_META[provider]["display_name"]
        raise HTTPException(status_code=400, detail=f"Failed to stop {display_name} channel. Try again.")

    # Revoke the DB connection rows before committing the store/cache so a repo

View on GitHub (pinned to 1dd6ba1acb)

Solutions

1. Enable this channel provider in config.yaml under channels.<provider>.enabled=true, then restart the Gateway.
2. Check that the provider's required configuration block exists and is valid.

When it happens

Trigger: Thrown at backend/app/gateway/routers/channel_connections.py:579 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of bytedance/deer-flow@1dd6ba1acb (2026-08-14). Data as JSON: /api/errors/f7053b67eb9e9be5. Report an issue: GitHub.