---
title: "Write to the assistant that asked"
method: POST
path: "/v1/cards/{id}/messages"
tags: ["cards"]
---

# Write to the assistant that asked

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

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.

## 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

## Request body

- MessageRequest
  - `body` string, required
  - `via` 'text' | 'voice'

## Response `200`

Write to the assistant that asked

- MessageResponse
  - `id` string, required
  - `messageId` string, required
  - `turn` 'agent', required
  - `version` integer, 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; forbidden; insufficient_scope (OAuth, with WWW-Authenticate naming the scope)
- `404`: not_found
- `409`: not_waiting; delegated; conflict; idempotency_in_progress
- `422`: idempotency_mismatch
- `426`: client_outdated
- `429`: rate_limited
- `500`: server_error
- `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)