---
search:
  tags:
    - AppShares
    - POST
seo:
  description: >-
    User-gated (chrm_user_* or session). Declines the CALLER’s pending…
    Reference for the POST /api/v1/apps/{appId}/shares/decline endpoint in the
    Charming API.
sidebar:
  label: Decline or leave a share
  badge: POST
title: Decline or leave a share
type: openapi-operation
---
User-gated (`chrm_user_*` or session). Declines the CALLER’s pending invite or leaves an accepted share; idempotent (`removed: false` when there was nothing).

`POST /api/v1/apps/{appId}/shares/decline`

**Responses**

- `200` — Declined / left (or nothing to remove).
- `400` — Invalid app id.
- `401` — Sign-in required.

Response example, 200:

```json
{
  "ok": true,
  "removed": true
}
```

Found a bug or need a feature? [Tell us](/docs/capabilities/feedback) with `submit_feedback` or `POST /app/{id}/feedback`. Your feedback shapes what we build next.