---
title: "Api Users Partial Update"
method: PATCH
path: "/api/users/"
tags: ["users"]
---

# Api Users Partial Update

`PATCH /api/users/`

PATCH handler with superadmin lock and field protection.

Checks:
1. Object lock (is_managed=True -> non-superadmins can't modify)
2. Field protection (non-superadmins can't modify specific fields)

## Headers

- `Authorization` string, required

## Request body

- PatchedCustomerUserListRequest — Serializer for customer user list responses from ClickHouse. Combines ClickHouse analytics data with PostgreSQL budget data for backward compatibility with the legacy /api/users/ endpoint. Budget data enrichment: - View passes budget_data_map in context (keyed by customer_identifier+environment) - SerializerMethodFields look up budget values from context
  - `environment` string
  - `customer_identifier` string
  - `unique_organization_id` string
  - `name` string
  - `email` string
  - `first_seen` string, date-time
  - `last_active_timeframe` string
  - `active_days` integer
  - `number_of_requests` integer
  - `total_requests` integer
  - `total_tokens` integer
  - `tokens` integer
  - `total_cost` number, double
  - `cost` number, double
  - `average_latency` number, double
  - `average_ttft` number, double

## Response `200`

- CustomerUserList — Serializer for customer user list responses from ClickHouse. Combines ClickHouse analytics data with PostgreSQL budget data for backward compatibility with the legacy /api/users/ endpoint. Budget data enrichment: - View passes budget_data_map in context (keyed by customer_identifier+environment) - SerializerMethodFields look up budget values from context
  - `id` string, required
  - `environment` string, required
  - `customer_identifier` string, required
  - `unique_organization_id` string
  - `name` string
  - `email` string
  - `first_seen` string, date-time, required
  - `last_active_timeframe` string, required
  - `active_days` integer, required
  - `number_of_requests` integer, required
  - `total_requests` integer, required
  - `total_tokens` integer, required
  - `tokens` integer, required
  - `total_cost` number, double, required
  - `cost` number, double, required
  - `average_latency` number, double, required
  - `average_ttft` number, double, required
  - `average_monthly_cost` string, required
  - `period_budget` string, required
  - `budget_duration` string, required
  - `total_budget` string, required

---

[API](https://skmtc.net/keywordsai/apis/api-reference.md) · [All operations](https://skmtc.net/keywordsai/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/keywordsai/api-reference/versions/c26d550029f8/schema)