client_keyed_hold: Approve this open from the client that opened it

A widget tried to approve (POST /widgets/v1/approvals/{id}/approve) a pending approval for a stream open that is bound to a session key held by the client that asked for the open. Only that client can complete the open, because only it holds the key, so the widget cannot approve it. Nothing was opened and the approval stays pending.

Rejecting the same approval from the widget works. Approvals of other actions, and opens not bound to a client's session key, are approved from the widget as usual. With Dynamo-Version: 1.8.0 the approvals list marks these holds with clientKeyed: true.

The multi-tenant hosted tier answers the same way: the front door passes the request to the account's core. Widget requests reach the core without a Dynamo-Version, so this answer does not depend on the account's default version; an owner reading the approvals list through the front door is served the account's default (1.8.0 for new accounts), which marks clientKeyed.

What to do

On the wire

HTTP 409, error type state_error, param: "id".

{
  "error": "state",
  "errorDetail": {
    "type": "state_error",
    "code": "client_keyed_hold",
    "message": "this open completes only with the session key of the client that opened it: approve it from that client; reject is available here (fail closed, still pending)",
    "param": "id",
    "doc_url": "…/developers/widgets.md#client-keyed-hold",
    "fix": "approve this open from the client that opened it (it holds the session key); reject it here if it should not run"
  }
}

See all error codes.