/api/public/v1/workers/{id}/core-channelworkers.core_channel_set
workers.core_channel_set — Select stable or qualified beta core channel with an idempotent command.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
idpath | string (uuid) | Yes | Device id |
command_idbody | string (uuid) | Yes | Client-generated UUID for this command. Send the same id (and body) again to get the stored receipt instead of a second change; a different body under the same id is CONFLICT. |
channelbody | "stable" | "beta" | Yes |
Examples
curl -X POST "https://browlix.com/api/public/v1/workers/<id>/core-channel" \
-H "Authorization: Bearer $BROWLIX_API_KEY" \
-H "Content-Type: application/json" \
-d '{"command_id":"<uuid>","channel":"stable"}'Response
201 with { data, replayed: false, correlation_id } the first time; 200 with replayed: true when the same command_id and body come again.
| Field | Type | Always present | Description |
|---|---|---|---|
| data | object | Yes | |
| data.device_id | string (uuid) | No | |
| data.channel | "stable" | "beta" | No | |
| correlation_id | string (uuid) | Yes | |
| ok | true | No | |
| operation_id | string | null | No | |
| state_version | integer | No | (min 0) |
| retryable | false | No | |
| next | null | No | |
| replayed | boolean | No | true when this command_id was already applied and the stored receipt came back |
Errors
| Code | HTTP | Retryable |
|---|---|---|
| UNAUTHENTICATED | 401 | No |
| FORBIDDEN | 403 | No |
| RATE_LIMITED | 429 | Yes |
| VALIDATION_FAILED | 422 | No |
| NOT_FOUND | 404 | No |
| CONFLICT | 409 | No |
| OUTCOME_UNKNOWN | 202 | Yes |
| DEPENDENCY_UNAVAILABLE | 503 | Yes |
| UNKNOWN | 500 | No |
All operations
- GETlist
- GETget
- POSTcreate
- PATCHupdate
- POSTaccept_egress_change
- POSTtrash
- POSTrestore
- GETsync.get
- POSTsync.restore
- GETcleanup.preflight
- POSTcleanup.run
- GETcleanup.list
- POSTsync.release
- GETextensions
- GETbookmarks
- GETeffective_fingerprint
- GETnoise_status
- POSTnoise_upgrade
- GETdrift_list
- GETconsistency_report
- POSTcreate_from_context
- POSTdrift_accept
- GETexit_diagnostics
Using an AI agent?
Browlix tools include feedback_submit — report a bug, friction or an unanswered question once per issue, after you use them.
How feedback works