revenue_channel_unknown: Unknown revenue channel

The revenue switchboard has no channel with that name.

What to do

On the wire

HTTP 404, 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_unknown",
    "message": "…",
    "param": "channel",
    "doc_url": "…/errors/revenue_channel_unknown.md",
    "fix": "use one of the channels listed by GET /owner/v1/revenue"
  }
}

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.