A mongdb atlas api client for nodejs.

npm install mongodb-atlas-api-client

The basic syntax is:

Atlas API uses HTTP Digest Authentication. It essentially requires a username and a password which are hashed using a unique server-generated value called a nonce. The username is the API public key and the password is the corresponding private key.

const getClient = require("mongodb-atlas-api-client");
const {user, cluster} = getClient({
  "publicKey": "some public key",
  "privateKey": "some private key",
  "baseUrl": "https://cloud.mongodb.com/api/atlas/v1.0",
  "projectId": "some project/group id"
});

const options = {
  "envelope": true,
  "itemsPerPage": 10,
  "pretty": true
}

const response = await user.getAll(options); // get All users
const response = await cluster.get("someClusterName"); // get single cluster
const response = await user.delete("someUserName", options); // delete single user
const response = await user.create(body, options); // create user
const response = await user.update("someUserName", body, options); // update user

npm test

Following entities are currently supported

• User
• Cluster
• CustomDbRole
• ProjectWhitelist
• ProjectAccesslist
• Project
• Organization
• AtlasUser
• Event
• Alert
• DataLake
• AtlasSearch

Function - Returns the details of user name passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/database-users-get-single-user/

Function - Returns all the users. Pagination can be controlled via options object.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/database-users-get-all-users/

Function - Creates the user as per body passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/database-users-create-a-user/

Function - Updates the user for the username passed. It only updates the properties passed in body.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/database-users-update-a-user/

Function - Deletes the user name passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/database-users-delete-a-user/

Function - Returns the details of cluster name passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/clusters-get-one/

Function - Returns all the clusters. Pagination can be controlled via options object.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/clusters-get-all/

Function - Returns the advance configuration of cluster name passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/clusters-get-advanced-configuration-options/

Function - Creates the cluster as per body passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/clusters-create-one/

Function - Updates the cluster for the clustername passed. It only updates the properties passed in body.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/clusters-modify-one/

Function - Updates the advance configuration of cluster for the clustername passed. It only updates the properties passed in body.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/clusters-modify-advanced-configuration-options/

Function - Tests failure of primary replica set member.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/clusters-test-failover/

Function - Deletes the cluster name passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/clusters-delete-one/

Function - Returns the details of role name passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/custom-roles-get-single-role/

Function - Returns all the roles. Pagination can be controlled via options object.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/custom-roles-get-all-roles/

Function - Creates the role as per body passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/custom-roles-create-a-role/

Function - Updates the role for the rolename passed. It only updates the properties passed in body.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/custom-roles-update-a-role/

Function - Deletes the role name passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/custom-roles-delete-a-role/

Function - Returns the details of whitelistentry name passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/whitelist-get-one-entry/

Function - Returns all the whitelistentries. Pagination can be controlled via options object.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/whitelist-get-all/

Function - Creates the whitelistentry as per body passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/whitelist-add-one/

Function - Updates the whitelistentry passed. It only updates the properties passed in body.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/whitelist-update-one/

Function - Deletes the whitelistentry name passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/whitelist-delete-one/

Function - Returns the details of accesslistentry name passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/ip-access-list/get-one-access-list-entry/

Function - Returns all the accesslistentries. Pagination can be controlled via options object.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/ip-access-list/get-all-access-list-entries/

Function - Creates the accesslistentry as per body passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/ip-access-list/add-entries-to-access-list/

Function - Updates the accesslistentry passed. It only updates the properties passed in body.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/ip-access-list/add-entries-to-access-list/

Function - Deletes the accesslistentry name passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/ip-access-list/delete-one-access-list-entry/

Function - Returns the details of project id passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/project-get-one/

Function - Returns the details of project name passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/project-get-one-by-name/

Function - Returns the teams of project id passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/project-get-teams/

Function - Returns all the projects. Pagination can be controlled via options object.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/project-get-all/

Function - Creates the project as per body passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/project-create-one/

Function - Assigns the teams for the projectId passed. It only updates the properties passed in body.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/project-add-team/

Function - Deletes the project id passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/project-delete-one/

Function - Removes the user id passed from the project.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/project-remove-user/

Function - Returns the details of organization id passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/organization-get-one/

Function - Returns all the users for organization id passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/organization-users-get-all-users/

Function - Returns all the projects for organization id passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/organization-get-all-projects/

Function - Returns all the organizations. Pagination can be controlled via options object.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/organization-get-all/

Function - Renames the organization

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/organization-rename/

Function - Deletes the project id passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/organization-delete-one/

Function - Returns the details of user id passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/user-get-by-id/

Function - Returns the details of user name passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/user-get-one-by-name/

Function - Returns all the users. Pagination can be controlled via options object.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/user-get-all/

Function - Creates the atlas user as per body passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/user-create/

Function - Updates the user for the userId passed. It only updates the properties passed in body.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/user-update/

Function - Returns the details of event id passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/events-projects-get-one/

Function - Returns all the events. Pagination can be controlled via options object.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/events-projects-get-all/

Function - Returns the details of event id passed for organization id.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/events-orgs-get-one/

Function - Returns all the events. Pagination can be controlled via options object.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/events-orgs-get-all/

Function - Returns the details of alert id passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/alerts-get-alert/

Function - Returns all the alerts. Pagination can be controlled via options object.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/alerts-get-all-alerts/

Function - Acknowledge or unacknowledge an alert

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/alerts-acknowledge-alert/

Function - Returns the details of dataLake name passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.mongodb.com/datalake/reference/api/dataLakes-get-one-tenant/

Function - Returns all the dataLakes. Pagination can be controlled via options object.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.mongodb.com/datalake/reference/api/dataLakes-get-all-tenants/

Function - Returns the dataLake logs stream.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.mongodb.com/datalake/reference/api/dataLakes-download-query-logs/

Function - Creates the dataLake as per body passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.mongodb.com/datalake/reference/api/dataLakes-create-one-tenant/

Function - Updates the dataLake for the username passed. It only updates the properties passed in body.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.mongodb.com/datalake/reference/api/dataLakes-update-one-tenant/

Function - Deletes the dataLake name passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.mongodb.com/datalake/reference/api/dataLakes-delete-one-tenant/

Function - Returns all the cloudProviderAccess. Pagination can be controlled via options object.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/cloud-provider-access-get-roles/

Function - Creates the cloudProviderAccess as per body passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/cloud-provider-access-create-one-role/

Function - Updates the cloudProviderAccess for the roleId passed. It only updates the properties passed in body.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/cloud-provider-access-authorize-one-role/

Function - Deletes the cloudProviderAccess name passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/cloud-provider-access-deauthorize-one-role/

Function - Returns the details of atlas search index by cluster name and index passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/fts-indexes-get-one/

Function - Returns all the atlas search indexes. Pagination can be controlled via options object.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/fts-indexes-get-all/

Function - Returns all the Analyzers. Pagination can be controlled via options object.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/fts-analyzers-get-all/

Function - Creates the atlas search index as per body passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/fts-indexes-create-one/

Function - Updates the atlas search index for the clusterName passed. It only updates the properties passed in body.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/fts-indexes-update-one/

Function - Upserts the analyser for the clusterName passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/fts-analyzers-update-all/

Function - Deletes the atlas search index by cluster name passed.

Returns: Promise - - promise which resolves on success and rejects on error

More details - https://docs.atlas.mongodb.com/reference/api/fts-indexes-delete-one/