Docs Menu

Docs HomeMongoDB Cloud Manager

Update Agent Versions

This endpoint updates the MongoDB Agent and tools to the latest versions available at the time of the request:

After this request completes, Cloud Manager modifies the agent configuration and saves the updated version.

This resource requires the Project Automation Admin role.

Base URL: https://cloud.mongodb.com/api/public/v1.0

POST /groups/{PROJECT-ID}/automationConfig/updateAgentVersions
Name
Type
Necessity
Description
PROJECT-ID
string
Required
Unique identifier of the group that owns the automation configuration.

The following query parameters are optional:

Name
Type
Necessity
Description
Default
pretty
boolean
Optional
false
envelope
boolean
Optional

Flag that indicates whether or not to wrap the response in an envelope.

Some API clients cannot access the HTTP response headers or status code. To remediate this, set envelope=true in the query.

For endpoints that return one result, the response body includes:

Name
Description
status
HTTP response code
envelope
Expected response body
false
Name
Type
Necessity
Description
automationAgentVersion
string
Optional
Version to which you want to update the MongoDB Agent.
biConnectorVersion
string
Optional
Version to which you want to update the BI Connector.
mongoDbToolsVersion
string
Optional
Version to which you want to update the MongoDB Database Tools
Parameter
Type
Description
automationAgentVersion
string
Version of the MongoDB Agent in the specified project.
backupAgentVersion
string
Version of the Backup Agent in the specified project. Cloud Manager has removed the Backup Agent, so this parameter should return null.
biConnectorVersion
string
Version of the MongoDB Connector for BI in the specified project.
mongoDbToolsVersion
string
Version of the MongoDB Database Tools in the specified project.
monitoringAgentVersion
string
Version of the Monitoring Agent in the specified project. Cloud Manager has removed the Monitoring Agent, so this parameter should return null.
1curl --user "{publicApiKey}:{privateApiKey}" --digest \
2 --header "Accept: application/json" \
3 --header "Content-Type: application/json" \
4 --include \
5 --request POST "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/automationConfig/updateAgentVersions?pretty=true" \
6 --data '{
7 "automationAgentVersion": "11.11.0.7355"
8 }'
HTTP/1.1 401 Unauthorized
Content-Type: application/json;charset=ISO-8859-1
Date: {dateInUnixFormat}
WWW-Authenticate: Digest realm="MMS Public API", domain="", nonce="{nonce}", algorithm=MD5, op="auth", stale=false
Content-Length: {requestLengthInBytes}
Connection: keep-alive
HTTP/1.1 200 OK
Vary: Accept-Encoding
Content-Type: application/json
Strict-Transport-Security: max-age=300
Date: {dateInUnixFormat}
Connection: keep-alive
Content-Length: {requestLengthInBytes}
X-MongoDB-Service-Version: gitHash={gitHash}; versionString={ApplicationVersion}
1{
2 "automationAgentVersion": "11.11.0.7355",
3 "backupAgentVersion" : null,
4 "biConnectorVersion" : "2.14.0",
5 "mongoDbToolsVersion" : null,
6 "monitoringAgentVersion" : null
7}
←  Example Automation ConfigurationGet Backup Configuration Settings →