---
title: "Block the other writer and end the exchange"
method: POST
path: "/exchange/{exchangeId}/block"
tags: ["Exchange"]
---

# Block the other writer and end the exchange

`POST /exchange/{exchangeId}/block`

## Request

- Base URL: `https://whatareyoudo.ing/api/v1`
- URL: `https://whatareyoudo.ing/api/v1/exchange/{exchangeId}/block`
- Auth: HTTP bearer

As leave, and the two accounts are never paired again. The block is recorded against the other writer's alias, so the caller's block list never shows who they were, and a hash of the other writer's verified phone number is kept so a new account with the same number is not paired with the caller either. Works after the exchange is over too. In a group exchange (from the recruitment board) `member` -- the other writer's alias display name -- says who, and only the caller steps out; an exchange of two needs no body.

## Path parameters

- `exchangeId` string, uuid, required

## Request body

- ExchangeBlockRequest
  - `member` string

## Response `200`

OK

- object
  - `data` ExchangeSummary, required
    - `id` string, uuid, required
    - `status` 'active' | 'ended' | 'aborted', required
    - `endedReason` 'expired' | 'left' | 'blocked' | 'reported' | 'moderation' | 'ended_early', nullable, required
    - `startsAt` string, required
    - `endsAt` string, required
    - `writable` boolean, required
    - `groupId` string, uuid, required
    - `diaryId` string, uuid, required
    - `aliasProfileId` string, uuid, required
    - `aliasDisplayName` string, nullable, required
    - `partnerAliasDisplayName` string, nullable, required
    - `members` ExchangeMember[], required
      - `aliasDisplayName` string, nullable, required
      - `isMe` boolean, required
      - `left` boolean, required
    - `leftAt` string, nullable, required
  - `meta` object, required
    - `requestId` string, required

## Changes

- **2026-10-20** `a36285d04daa`: 2 info
  - added optional request body
  - added the required property `data/members` to the response with the `200` status
- **2026-10-20** `5babd76752f2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/whatareyoudo/apis/whatcha-api/changes/exchange/:exchangeId/block/post.md)

---

[API](https://skmtc.dev/whatareyoudo/apis/whatcha-api.md) · [All operations](https://skmtc.dev/whatareyoudo/apis/whatcha-api/llms.txt) · [OpenAPI document](https://skmtc.dev/whatareyoudo/apis/whatcha-api/revisions/48dd8a54abea?raw)
