# Update an Atlas database user in a project

**PATCH /api/v1/atlas/projects/{project_id}/database-users/{username}**

Proxies Atlas Admin API PATCH /groups/{id}/databaseUsers/admin/{username} using a human caller's delegated token or a paired Agent Engine service account. Agent Engine API keys are not accepted. Rotates the password and grants readWriteAnyDatabase on admin, scoped to the selected cluster, so setup can reuse an existing workspace-named user instead of creating a colliding replacement. The password is never echoed in error responses or logs. Invalid project_id or username is rejected before any Atlas call. Requires the same Atlas Project Owner gate as create.


## Servers
- https://agentengine.mongodb.com: https://agentengine.mongodb.com ()


## Authentication methods
- Bearer auth


## Parameters

### Path parameters

- **project_id** (string)
  Atlas project ID

- **username** (string)
  Atlas database username



### Body: application/json (object)
Database user update
object

## Responses
### 406
Unsupported or malformed API version, an operation unavailable in the selected published contract, or an unacceptable representation (including unsupported media-type parameters or excluded SSE). Existing authentication, authorization, and rate-limit failures take precedence.

#### Body: application/json (object)
- **badRequestDetail** (object)
  Optional validation details defined by the standard error schema; API negotiation errors do not emit this field.

- **detail** (string)
  Human-readable error details.

- **error** (integer)
  HTTP status code.

- **errorCode** (string)
  Machine-readable error code.

- **parameters** (array[string])
  Request parameter names associated with the error; omitted when none apply.

- **reason** (string)
  HTTP status reason phrase.


### 200
OK

#### Body: application/json (object)
- **username** (string)


### 400
Bad Request

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 401
Unauthorized

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 402
ATLAS_PAYMENT_METHOD_REQUIRED

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 403
ATLAS_PERMISSION_REQUIRED, ATLAS_SERVICE_ACCOUNT_NOT_PAIRED, or FORBIDDEN

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 404
NOT_FOUND

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 409
Conflict

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 413
request body too large

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 500
INTERNAL_ERROR

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 502
Bad Gateway

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 503
PLATFORM_OAUTH_NOT_CONFIGURED or SERVICE_UNAVAILABLE when a delegated token refresh is already in progress

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)



[Powered by Bump.sh](https://bump.sh)