cards

Hand a card to another assistant

One of the person’s assistants in reach (GET /v1/assistants). freely: its answer goes straight back; loop: it comes to the person first. Until undoUntil the helper can’t see it.

post/v1/cards/{id}/delegate

Request

  • Base URL: https://www.pendingyou.com
  • URL: https://www.pendingyou.com/v1/cards/{id}/delegate
  • Auth: OAuth 2 (authorization code, authorization URL https://www.pendingyou.com/oauth/authorize, token URL https://www.pendingyou.com/oauth/token, scopes: cards:delegate)

Path parameters

idstring required

The card (req_…).

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).

Pending-You-Yesstring

Pending You’s own apps only, on a high-stakes card: the person’s yes, a JWS of type pending-you-yes+jwt by this sign-in’s yes key (POST /v1/yes-key, the key in its header), over cardId, version, answerDigest (the request body’s SHA-256, base64url), iat and jti.

Idempotency-Keystring

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

Request body

mode'freely' | 'loop' required
notestring

Response

Hand a card to another assistant

idstring required
status'delegated' required
versioninteger required
undoUntilstring date-time required

Changes

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