cards

Write to the assistant that asked

The person’s words, on its card. They hand it the turn and it acts on them as the answer, so they count against the answers’ limit.

post/v1/cards/{id}/messages

Request

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

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

bodystring required
via'text' | 'voice'

Response

Write to the assistant that asked

idstring required
messageIdstring required
turn'agent' required
versioninteger required

Changes

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