---
title: "Update User Profile"
method: PUT
path: "/api/v1/auth/profile"
tags: ["auth"]
---

# Update User Profile

`PUT /api/v1/auth/profile`

Update the current user's profile information.
Requires authentication.

## Request body

- UserProfileUpdateRequest — Request model for updating user profile information. Every other field reads ``None`` as "not supplied", which cannot express clearing a column. ``agent_fill_row_ceiling`` needs that distinction — going back to inheriting the workspace is a real edit — so the route reads it through ``model_fields_set`` rather than by testing the value.
  - `display_name` string, nullable
  - `role` string, nullable
  - `avatar_color` string, nullable
  - `has_completed_onboarding` boolean, nullable
  - `column_preferences` object, nullable
  - `agent_fill_row_ceiling` integer, nullable — Rows MAIA may fill within one reply for you before asking. Omit to leave unchanged; set to null to go back to the workspace's setting. Zero means ask every time.

## Response `200`

Successful Response

- UserProfileUpdateResponse — Response model for user profile update.
  - `success` boolean, required
  - `message` string, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-19** `924eeadc29ad` — 1 info
  - added the new optional request property `agent_fill_row_ceiling`

[Change history](https://skmtc.dev/maia-analytics/apis/maia-api/changes/api/v1/auth/profile/put.md)

---

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