# Link the caller's Atlas project for egress sync

**PUT /api/v1/projects/{id}/atlas-link**

Links a project to an Atlas project for egress sync. Requires the project-owner role. When the platform enforces the Atlas access proof (the default), the request must carry an X-Atlas-Service-Account-Token header whose service account can read the Atlas project, and the Atlas project must belong to the organization's Atlas organization. The response reports sync status only — Atlas cluster topology (hosts/IPs) and raw sync errors are omitted.


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


## Authentication methods
- Bearer auth


## Parameters
### Headers

- **X-Atlas-Service-Account-Token** (string)
  Short-lived Atlas service-account access token used as a group-access proof (never the SA client secret); required when the platform enforces the Atlas access proof, which is the default


### Path parameters

- **id** (string)
  Project ID



### Body: application/json (object)
Atlas project link
- **environment** (string)

- **project_id** (string)



## 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)
- **atlas_project** (object)

- **egress_sync** (object)

- **name** (string)

- **org_id** (string)

- **project_id** (string)


### 400
Bad Request

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

- **error** (string)

- **success** (boolean)


### 403
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 Server Error

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

- **error** (string)

- **success** (boolean)


### 502
Bad Gateway

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

- **error** (string)

- **success** (boolean)



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