MongoDBMongoDB Atlas Administration API v2
PATCH/api/atlas/v2/orgs/{orgId}/serviceAccounts/{clientId}
Manage update Org Service Account.
Contract-preserving PATCH endpoint for update Org 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
updateOrgServiceAccount- 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
orgId
pathstringrequired
org Id value in the Atlas Administration API contract.
4888442a3354817a7320eb61
envelope
queryboolean
envelope value in the Atlas Administration API contract.
pretty
queryboolean
pretty value in the Atlas Administration API contract.
Request body
OrgServiceAccountUpdateRequestrequired
Content-Type: application/vnd.atlas.2024-08-05+json
Properties: descriptionnameroles
Responses
200
OrgServiceAccountapplication/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": [
"ORG_MEMBER"
],
"secrets": {
"id": "32b6e34b3d91647abb20e7b8",
"maskedSecretValue": "mdb_sa_sk_...",
"secret": "mdb_sa_sk_..."
}
}