---
title: "Update User Status"
method: PATCH
path: "/api/v1/admin/users/{user_id}/status"
tags: ["admin-users"]
---

# Update User Status

`PATCH /api/v1/admin/users/{user_id}/status`

Update a user's status (active, inactive, suspended).

Creates an audit log entry for the change.
Requires ``users:edit`` permission.

## Path parameters

- `user_id` string, uuid, required

## Request body

- AdminUserStatusUpdate — Request to update a user's status.
  - `status` 'active' | 'inactive' | 'suspended', required

## Response `200`

Successful Response

- AdminUserListItem — User summary for admin list views. The CRM rollup block (last_activity_at → stats_computed_at) is populated ONLY when the caller also holds ``customer_followups:view`` — gated server-side in the users router so a ``users:view``-only role never receives revenue in the payload. ``None`` means "not authorized"; zeroes mean "authorized, no activity yet".
  - `id` string, uuid, required
  - `email` string, required
  - `first_name` string, required
  - `last_name` string, required
  - `company` string, nullable
  - `phone` string, nullable
  - `status` string, required
  - `created_at` string, date-time, required
  - `project_count` integer
  - `last_activity_at` string, date-time, nullable
  - `last_order_at` string, date-time, nullable
  - `last_outreach_at` string, date-time, nullable
  - `total_orders` integer, nullable
  - `total_revenue` string, nullable
  - `committed_orders` integer, nullable
  - `committed_revenue` string, nullable
  - `committed_unpaid_revenue` string, nullable
  - `brokered_orders` integer, nullable
  - `brokered_revenue` string, nullable
  - `open_quotes` integer, nullable
  - `lost_quotes` integer, nullable
  - `suppressed` boolean, nullable
  - `stats_computed_at` string, date-time, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/prototyping/apis/prototyping-io-api.md) · [All operations](https://skmtc.dev/prototyping/apis/prototyping-io-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/prototyping/prototyping-io-api/revisions/f4a0079fbb57/schema)