revenue_channel_locked: The revenue channel is locked

The channel is read-only, or switched off on this deployment.

What to do

On the wire

HTTP 409, error type state_error.

POST /owner/v1/revenue/{channel} was added in owner-api 1.4.0, so every client receives errorDetail, with or without Dynamo-Error-Detail: 1:

{
  "error": "state",
  "detail": "…",
  "errorDetail": {
    "type": "state_error",
    "code": "revenue_channel_locked",
    "message": "…",
    "param": "channel",
    "doc_url": "…/errors/revenue_channel_locked.md",
    "fix": "this channel is read-only or off on this deployment"
  }
}

Only a single-tenant core answers this code. On the multi-tenant hosted tier the front door refuses every change to a revenue switch from a tenant credential before it reaches the core, with 403 key_scope ("revenue switches are set by the deployment operator; tenant credentials may only read them").

See all error codes.