Rename an Organization¶

On this page

Syntax
Response
Example
- Example Request
- Example Response

The Atlas API authenticates using HTTP Digest Authentication. Provide a programmatic API public key and corresponding private key as the username and password when constructing the HTTP request.

To learn how to configure API access for an Atlas project, see Configure Atlas API Access.

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

Syntax¶

copy

PATCH /orgs/{ORG-ID}

Request Path Parameters¶

Name	Type	Description
`ORG-ID`	string	The id of the organization that you want to rename.

Request Query Parameters¶

The following query parameters are optional:

Query Parameter	Type	Description	Default
`pretty`	boolean	Displays response in a prettyprint format.	`false`
`envelope`	boolean	Specifies whether or not to wrap the response in an envelope.	`false`

Request Body Parameters¶

Name	Type	Description
`name`	string	The new name for the organization.

Response¶

Name	Type	Description
`id`	ObjectId	Unique identifier for the organization.
`links`	document array	One or more links to sub-resources and/related resources. The relations between URLs are explained in the Web Linking Specification.
`name`	string	New name of the organization.

Example¶

Example Request¶

copy

curl -X PATCH --include --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest --header "Content-Type: application/json" \
     "https://cloud.mongodb.com/api/atlas/v1.0/orgs/6001f2c580eef55aedbc6bb1?pretty=true" \
     --data '{"name":"MyAtlasCluster"}'

Example Response¶

copy

{
  "id" : "6001f2c580eef55aedbc6bb1",
  "links" : [ {
    "href" : "https://cloud.mongodb.com/api/atlas/v1.0/orgs/6001f2c580eef55aedbc6bb1",
    "rel" : "self"
  }, {
    "href" : "https://cloud.mongodb.com/api/atlas/v1.0/orgs/6001f2c580eef55aedbc6bb1/groups",
    "rel" : "http://mms.mongodb.com/groups"
  }, {
    "href" : "https://cloud.mongodb.com/api/atlas/v1.0/orgs/6001f2c580eef55aedbc6bb1/teams",
    "rel" : "http://mms.mongodb.com/teams"
  }, {
    "href" : "https://cloud.mongodb.com/api/atlas/v1.0/orgs/6001f2c580eef55aedbc6bb1/users",
    "rel" : "http://mms.mongodb.com/users"
  } ],
  "name" : "MyAtlasCluster"
}

← Get All Organization Users Delete an Organization →