# List Atlas organizations for the authenticated principal

**GET /api/v1/atlas/orgs**

Proxies Atlas Admin API GET /orgs. Humans and API keys use the caller's delegated OAuth token; an Agent Engine ORG/PROJECT service account with an active Atlas pairing uses that service account's own credential.


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


## Authentication methods
- Bearer auth


## Parameters




## 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)
- **results** (array[object])

- **total_count** (integer)


### 401
PLATFORM_OAUTH_REQUIRED or PLATFORM_OAUTH_RESOURCE_REJECTED — delegated Atlas authorization unusable; do not replay

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

- **error** (string)

- **success** (boolean)


### 403
ATLAS_SERVICE_ACCOUNT_NOT_PAIRED — machine principal has no active pairing; FORBIDDEN — ineligible type or machine feature flag off

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

- **error** (string)

- **success** (boolean)


### 500
INTERNAL_ERROR — pairing lookup failed

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

- **error** (string)

- **success** (boolean)


### 502
ATLAS_SERVICE_ACCOUNT_CREDENTIAL_UNAVAILABLE or Atlas unreachable / non-OK response

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

- **error** (string)

- **success** (boolean)


### 503
PLATFORM_OAUTH_NOT_CONFIGURED — platform OAuth or machine credential path not configured; SERVICE_UNAVAILABLE — delegated token refresh already in progress

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

- **error** (string)

- **success** (boolean)



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