yes_key

Register the key that signs the person’s yes

The key that signs the person’s yes to a high-stakes card (Pending-You-Yes), kept on the device behind Face ID. proof is a JWS of type pending-you-yes-key+jwt, signed by that key with it in its header, naming this sign-in (grant), when it was made (iat) and a jti. A new key replaces the last. Pending You’s own apps only (cards:high_stakes).

post/v1/yes-key

Request

  • Base URL: https://www.pendingyou.com
  • URL: https://www.pendingyou.com/v1/yes-key
  • Auth: OAuth 2 (authorization code, authorization URL https://www.pendingyou.com/oauth/authorize, token URL https://www.pendingyou.com/oauth/token, scopes: cards:high_stakes)

Headers

Pending-You-Version'2026-10-05'

The dated behaviour to follow. Without it: the app’s registered version.

Pending-You-Clientstring

Pending You’s own apps only: which app and version is calling, ios/1.4.0+120 (its version, then its build) or web/<build>.

DPoPstring

The request’s DPoP proof, for a bound token (every public app’s).

Idempotency-Keystring

8 to 200 visible characters. The same key and request within 24 hours get the first answer again.

Request body

proofstring required

Response

Register the key that signs the person’s yes

registeredAtstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.