---
title: "Answer a card"
method: POST
path: "/v1/cards/{id}/answer"
tags: ["cards"]
---

# Answer a card

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

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.

## Path parameters

- `id` string, required

## Headers

- `Pending-You-Version` '2026-10-05'
- `Pending-You-Client` string
- `DPoP` string
- `Pending-You-Yes` string
- `Idempotency-Key` string, required

## Request body

- AnswerRequest
  - `version` integer, required
  - `choiceIds` string[]
  - `approved` boolean
  - `text` string
  - `note` object
    - `text` string, required
    - `via` 'text' | 'voice'
  - `theyDecide` true
  - `answers` object
  - `failedStep` integer
  - `askId` string
  - `handled` 'self' | 'leave'
  - `holdSeconds` integer

## Response `200`

Answer a card

- AnswerResponse
  - `id` string, required
  - `askId` string
  - `status` 'answered', required
  - `version` integer, required
  - `undoUntil` string, date-time, required
  - `toast` Toast
    - `title` Line, required
      - `key` string, required
      - `args` object
      - `text` string, required
    - `detail` Line
      - `key` string, required
      - `args` object
      - `text` string, required

## Other responses

- `400`: invalid
- `401`: invalid_token, invalid_dpop_proof or use_dpop_nonce (OAuth, with WWW-Authenticate)
- `403`: app_not_available; high_stakes; yes_required; area_change; forbidden; insufficient_scope (OAuth, with WWW-Authenticate naming the scope)
- `404`: not_found
- `409`: version_conflict; not_waiting; delegated; conflict; idempotency_in_progress
- `422`: idempotency_mismatch
- `426`: client_outdated
- `429`: rate_limited
- `500`: server_error
- `501`: not_available
- `503`: unavailable

---

[API](https://skmtc.dev/pendingyou/apis/pending-you-person-api.md) · [All operations](https://skmtc.dev/pendingyou/apis/pending-you-person-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pendingyou/apis/pending-you-person-api/revisions/4c0d997495a6?raw)