---
title: "Update Channel Route"
method: PATCH
path: "/api/user/channels/routes/{channel}"
---

# Update Channel Route

`PATCH /api/user/channels/routes/{channel}`

Toggle enabled status for a channel route.

Single-channel enforcement: when enabling a channel, all other
non-webchat routes for this user are automatically disabled so
exactly one messaging channel is active at a time.

If the user has no route and no known identifier for this channel yet
(fresh onboarding), the selection is persisted via ``preferred_channel``
only. The route row is created later when the identifier arrives,
either via an inbound message (OSS) or via an explicit link call
(premium). This keeps placeholder rows out of the database and avoids
leaking the user's internal UUID into identifier-shaped UI fields.

## Path parameters

- `channel` string, required

## Request body

- ChannelRouteUpdate
  - `enabled` boolean, required

## Response `200`

Successful Response

- ChannelRouteResponse
  - `channel` string, required
  - `channel_identifier` string, required
  - `enabled` boolean, required
  - `created_at` string, required
  - `last_inbound_at` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mozilla-ai/apis/clawbolt.md) · [All operations](https://skmtc.net/mozilla-ai/apis/clawbolt/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mozilla-ai/clawbolt/revisions/0e52fe5f8d33/schema)