agentscope-ai/agentscope · error · HTTPException

{str(e)}

Error message

{str(e)}

What it means

create_channel maps ChannelError from the channel service to an HTTP error using the status code carried by the exception, with the exception message as detail. Typical causes: unsupported platform/type, invalid platform_config, or service-level channel setup failures.

Source

Thrown at src/agentscope/app/_router/_channel.py:148

    body: CreateChannelRequest,
    service: ChannelService = Depends(get_channel_service),
    registry: ChannelTypeRegistry = Depends(get_channel_type_registry),
    user_id: str = Depends(get_current_user_id),
) -> ChannelResponse:
    """Create a channel."""
    try:
        record = await service.create(
            user_id=user_id,
            channel_type=body.channel_type,
            name=body.name,
            credentials=body.credentials,
            platform_config=body.platform_config,
            routing=body.routing,
            session=body.session,
            enabled=body.enabled,
        )
    except ChannelError as e:
        raise HTTPException(e.status_code, str(e)) from e
    except ValueError as e:
        raise HTTPException(status.HTTP_400_BAD_REQUEST, str(e)) from e
    return _to_response(record, registry)


@channel_router.get("/{channel_id}")
async def get_channel(
    channel_id: str,
    storage: StorageBase = Depends(get_storage),
    registry: ChannelTypeRegistry = Depends(get_channel_type_registry),
    user_id: str = Depends(get_current_user_id),
) -> ChannelResponse:
    """Get channel details."""
    record = await _owned(channel_id, user_id, storage)
    return _to_response(record, registry)


@channel_router.patch("/{channel_id}")

View on GitHub (pinned to e90f1c7592)

Solutions

1. Read the response detail — it is the underlying ChannelError message
2. List available channel types (GET /channels/types) and use a supported one
3. Complete platform_config with required credentials/fields for that type
4. Register the channel type plugin with the app if it should be available

types_resp = requests.get(f"{base}/channels/types")
supported = {t["type"] for t in types_resp.json()}
if body["type"] not in supported:
    raise ValueError(f"unsupported channel type {body['type']}")

resp = requests.post(f"{base}/channels", json=body)
if resp.status_code >= 400:
    raise RuntimeError(f"channel create failed: {resp.json()['detail']}")

When it happens

Trigger: POSTing a channel with a platform/type the registry does not support, malformed platform_config, or a channel type whose connector fails initialization.

Common situations: Typos in channel type names; missing credentials in platform_config (e.g. no API token); using a channel type whose plugin/connector is not registered in the running app.

Related errors

• Failed to fetch bytes from URL `{url}` after {max_retries} r
• One or more tool calls raised an exception
• Input validation failed for tool '{tool_call.name}': {e.mess
• Invalid permission decision behavior: {decision.behavior}
• Model call failed after retries, but no exception was raised

AI-assisted analysis of agentscope-ai/agentscope@e90f1c7592 (2026-08-28). Data as JSON: /api/errors/52ed11662745b06f. Report an issue: GitHub.