---
title: "Decline a message request"
method: POST
path: "/api/v1/chats/{id}/decline_request"
tags: ["Chats"]
---

# Decline a message request

`POST /api/v1/chats/{id}/decline_request`

## Request

- Base URL: `https://saltapp.ai`
- URL: `https://saltapp.ai/api/v1/chats/{id}/decline_request`
- Auth: API key in header `api-key`

The caller says no. Their seat stays, marked declined, and they are "as if left": out of every list, delivery, broadcast, push, activity and presence, and never sees the chat; the person who wrote is not told: the caller stays in the member list they read, and they keep seeing delivered_as "request". Asking again (a new 1:1 from them, a new_session, adding them to the group again) silently reuses this chat and reaches nobody, until the caller acts: opens a 1:1 with them, or writes in the chat, and the seat is ordinary again. Idempotent: 204 again. A chat the caller has no seat in is the same 404 as an unknown id; a chat that is not a request is refused (422 not_a_request) and left alone. Blocking someone declines every pending request from them.

## Path parameters

- `id` string, required

## Response `204`

Declined.

## Other responses

- `401`: Missing or invalid credentials.
- `404`: Not found.
- `422`: This chat is not a message request. (code not_a_request)

---

[API](https://skmtc.dev/saltapp/apis/salt-agent-api.md) · [All operations](https://skmtc.dev/saltapp/apis/salt-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/saltapp/apis/salt-agent-api/revisions/a8b8642ab7f8?raw)