---
title: "POST /v1/access-requests/{id}/decline"
method: POST
path: "/v1/access-requests/{id}/decline"
---

# POST /v1/access-requests/{id}/decline

`POST /v1/access-requests/{id}/decline`

## Request

- The document declares no server URL.
- Auth: one of:
  - HTTP bearer
  - API key in cookie `__Secure-better-auth.session_token`

Decline an access request.

## Path parameters

- `id` string, required

## Response `200`

The request has succeeded.

- AccessRequest
  - `id` string, required
  - `principalId` string, required
  - `mailboxId` string, required
  - `capabilities` string[], required: What was ASKED for. The grant carries what was approved, which may be less.
  - `reason` string, nullable, required
  - `status` 'pending' | 'approved' | 'declined', required
  - `requestedAt` string, date-time, required
  - `decidedAt` string, date-time, nullable, required
  - `decidedBy` string, nullable, required: Who answered. Null while pending; the audit trail once decided.

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/foundermail/apis/org.md) - [All operations](https://skmtc.dev/foundermail/apis/org/llms.txt) - [OpenAPI document](https://skmtc.dev/foundermail/apis/org/revisions/8bbb36e378ab?raw)