# Get an Atlas cluster in a project

**GET /api/v1/atlas/projects/{project_id}/clusters/{cluster_name}**

Looks up an Atlas Flex cluster first, then a dedicated cluster, using a human caller's delegated token or a paired Agent Engine service account. The detail response includes the connection string that Atlas omits from list responses for idle Flex clusters. Agent Engine API keys are not accepted. Invalid project_id or cluster_name is rejected before any Atlas call.


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


## Authentication methods
- Bearer auth


## Parameters

### Path parameters

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

- **cluster_name** (string)
  Atlas cluster name




## 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.


### 200
OK

#### 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
INVALID_ID or INVALID_REQUEST

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

- **error** (string)

- **success** (boolean)


### 401
PLATFORM_OAUTH_REQUIRED or PLATFORM_OAUTH_RESOURCE_REJECTED

#### 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)


### 500
INTERNAL_ERROR

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

- **error** (string)

- **success** (boolean)


### 502
Atlas unreachable / non-OK response

#### 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)