# Get organization policy rollout status

**GET /api/v1/organizations/{id}/policies/rollout**

Reports whether every project in the organization is running the latest platform policy generation, separating projects the gateway has not yet materialized from projects the data plane has not yet acknowledged.


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


## Authentication methods
- Bearer auth


## Parameters

### Path parameters

- **id** (string)
  Organization ID




## 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)
- **converged** (integer)

- **dead_lettered** (integer)

- **lagging_projects** (array[object])
  LaggingProjects samples the projects behind the latest generation, capped at
  policyRolloutLaggingProjectLimit. Truncated reports whether the sample is partial.

- **missing_config** (integer)
  MissingConfig counts active projects with no runtime config at all. Expected
  when the org has no policies (there is nothing to materialize); otherwise it is
  a gap, which is why it is reported rather than folded into Converged.

- **org_id** (string)

- **pending_materialization** (integer)

- **pending_publish** (integer)

- **projects_total** (integer)
  ProjectsTotal counts the org's active projects, not its runtime-config rows, so
  a project that has never materialized still shows up in the denominator.

- **truncated** (boolean)


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


### 500
Internal Server Error

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

- **error** (string)

- **success** (boolean)



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