---
title: "Suspend User"
method: POST
path: "/admin/users/{user_id}/suspend"
tags: ["admin"]
---

# Suspend User

`POST /admin/users/{user_id}/suspend`

## Request

- Base URL: `https://api.fincept.in` (the document declares no server; this is the origin it was published from)
- URL: `https://api.fincept.in/admin/users/{user_id}/suspend`
- Auth: API key in header `X-API-Key`

Suspend a user account (admin only).

Sets api_key_status='suspended', which the auth layer rejects (auth.py:175).
Also clears the active session and invalidates the auth cache so the
suspension takes effect immediately rather than after the 5-min cache TTL.

## Path parameters

- `user_id` integer, required

## Request body

- SuspendUserRequest
  - `reason` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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