MongoDBMongoDB Atlas Administration API v2
PATCH/api/atlas/v2/groups/{groupId}/serviceAccounts/{clientId}
Manage update Group Service Account.
Contract-preserving PATCH endpoint for update Group Service Account in the MongoDB Atlas Administration API. Resource-specific values are supplied by the caller at runtime.
All 540 MongoDB Atlas administration endpoints from a fixed Apache-2.0 OpenAPI revision. Hub provides documentation and an independent SDK/CLI, but never proxies account, organization, project, network, backup, or operational data; callers connect directly with local credentials.
Request
- operationId
updateGroupServiceAccount- Server
https://cloud.mongodb.com- Authentication
- ServiceAccounts, DigestAuth
Request parameters
clientId
pathstringrequired
client Id value in the Atlas Administration API contract.
mdb_sa_id_1234567890abcdef12345678
groupId
pathstringrequired
group Id value in the Atlas Administration API contract.
32b6e34b3d91647abb20e7b8
envelope
queryboolean
envelope value in the Atlas Administration API contract.
pretty
queryboolean
pretty value in the Atlas Administration API contract.
Request body
GroupServiceAccountUpdateRequestrequired
Content-Type: application/vnd.atlas.2024-08-05+json
Properties: descriptionnameroles
Responses
200
GroupServiceAccountapplication/vnd.atlas.2024-08-05+json
Successful supplier response.
Properties: clientIdcreatedAtdescriptionnamerolessecrets
400
ApiErrorapplication/json
Supplier response with HTTP status 400.
Properties: badRequestDetaildetailerrorerrorCodeparametersreason
401
ApiErrorapplication/json
Supplier response with HTTP status 401.
Properties: badRequestDetaildetailerrorerrorCodeparametersreason
403
ApiErrorapplication/json
Supplier response with HTTP status 403.
Properties: badRequestDetaildetailerrorerrorCodeparametersreason
404
ApiErrorapplication/json
Supplier response with HTTP status 404.
Properties: badRequestDetaildetailerrorerrorCodeparametersreason
429
ApiErrorapplication/json
Supplier response with HTTP status 429.
Properties: badRequestDetaildetailerrorerrorCodeparametersreason
500
ApiErrorapplication/json
Supplier response with HTTP status 500.
Properties: badRequestDetaildetailerrorerrorCodeparametersreason
{
"clientId": "mdb_sa_id_1234567890abcdef12345678",
"roles": [],
"secrets": {
"id": "32b6e34b3d91647abb20e7b8",
"maskedSecretValue": "mdb_sa_sk_...",
"secret": "mdb_sa_sk_..."
}
}