---
title: "Withdraw marketing consent for a board user"
method: POST
path: "/marketing-permissions/{id}/withdraw"
tags: ["Marketing permissions"]
---

# Withdraw marketing consent for a board user

`POST /marketing-permissions/{id}/withdraw`

## Request

- Base URL: `https://api.cavuno.com/v1`
- URL: `https://api.cavuno.com/v1/marketing-permissions/{id}/withdraw`
- Auth: HTTP bearer

Operator-initiated withdrawal (`reason: operator_request`) — the right move when someone asks the operator directly to be removed. `{id}` is the board user id. Idempotent: re-withdrawing changes nothing and emits no event. Emits `marketing_permission.withdrawn` on a real transition.

## Path parameters

- `id` string, required

## Response `200`

The consent after the withdrawal.

- MarketingPermission
  - `id` string, required
  - `object` 'marketing_permission', required
  - `email` string, required
  - `display_name` string, nullable, required
  - `role` string, required
  - `status` 'granted' | 'withdrawn', required
  - `source` string, required
  - `reason` 'person_request' | 'operator_request' | 'account_deleted', nullable, required
  - `granted_at` string, nullable, required
  - `withdrawn_at` string, nullable, required
  - `updated_at` string, required
  - `revision` integer, required

## Other responses

- `401`: Missing or invalid API key.
- `403`: Key lacks `marketing_permissions.manage`.
- `404`: Board user not found.
- `429`: Rate limited.

## Changes

- **2026-10-19** `c34152c38176`: 4 info
  - added the optional property `error/upgrade` to the response with the `401` status
  - added the optional property `error/upgrade` to the response with the `403` status
  - added the optional property `error/upgrade` to the response with the `404` status
  - added the optional property `error/upgrade` to the response with the `429` status

[Operation history](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/changes/marketing-permissions/:id/withdraw/post.md)

---

[API](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api.md) · [All operations](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/revisions/d5974dabff14?raw)