---
title: "Hand a card to another assistant"
method: POST
path: "/v1/cards/{id}/delegate"
tags: ["cards"]
---

# Hand a card to another assistant

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

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.

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

- DelegateRequest
  - `to` object, required
    - `assistantId` string, required
    - `agentId` string
  - `mode` 'freely' | 'loop', required
  - `note` string

## Response `200`

Hand a card to another assistant

- DelegateResponse
  - `id` string, required
  - `status` 'delegated', required
  - `version` integer, required
  - `hears` union
    - 'instant' | 'every-15-min' | 'hourly' | 'while-working' | 'by-hand'
    - string
  - `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; 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)