# Create an Atlas cluster in a project

**POST /api/v1/atlas/projects/{project_id}/clusters**

Creates a Flex cluster when tier is omitted or FLEX, or a dedicated replica set for a dedicated instance size such as M10. Uses a human caller's delegated token or a paired Agent Engine service account. Agent Engine API keys are not accepted. Invalid project_id is rejected before any Atlas call. Atlas 402 (no payment method) and 403 (insufficient Atlas permission) are mapped to distinct Agent Engine error codes.


## Servers
- https://agentengine.mongodb.com: https://agentengine.mongodb.com ()


## Authentication methods
- Bearer auth


## Parameters

### Path parameters

- **project_id** (string)
  Atlas project ID



### Body: application/json (object)
Cluster to create
object

## Responses
### 406
Unsupported or malformed API version, an operation unavailable in the selected published contract, or an unacceptable representation (including unsupported media-type parameters or excluded SSE). Existing authentication, authorization, and rate-limit failures take precedence.

#### Body: application/json (object)
- **badRequestDetail** (object)
  Optional validation details defined by the standard error schema; API negotiation errors do not emit this field.

- **detail** (string)
  Human-readable error details.

- **error** (integer)
  HTTP status code.

- **errorCode** (string)
  Machine-readable error code.

- **parameters** (array[string])
  Request parameter names associated with the error; omitted when none apply.

- **reason** (string)
  HTTP status reason phrase.


### 201
Created

#### Body: application/json (object)
- **connection_string_srv** (string)

- **id** (string)

- **is_flex** (boolean)

- **name** (string)

- **provider** (string)

- **region** (string)

- **state_name** (string)

- **tier** (string)


### 400
Bad Request

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 401
Unauthorized

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 402
ATLAS_PAYMENT_METHOD_REQUIRED

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 403
ATLAS_PERMISSION_REQUIRED, ATLAS_SERVICE_ACCOUNT_NOT_PAIRED, or FORBIDDEN

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 404
NOT_FOUND

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 409
Conflict

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 413
request body too large

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 500
INTERNAL_ERROR

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 502
Bad Gateway

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 503
PLATFORM_OAUTH_NOT_CONFIGURED or SERVICE_UNAVAILABLE when a delegated token refresh is already in progress

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)



[Powered by Bump.sh](https://bump.sh)