cards

Answer a card

With the version you showed the person. Its assistant hears it once its 5 seconds are over; until undoUntil this app may take it back.

post/v1/cards/{id}/answer

Request

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

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 required

8 to 200 visible characters, a new one for each answer. The same key and request within 24 hours get the first answer again.

Request body

versioninteger required
choiceIdsstring[]
approvedboolean
textstring
theyDecidetrue
answersobject
failedStepinteger
askIdstring
handled'self' | 'leave'
holdSecondsinteger

Response

Answer a card

idstring required
askIdstring
status'answered' required
versioninteger required
undoUntilstring date-time required

Changes

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