Rollout Evaluator - API Contract

POST

/api/v1/organizations/{organization_id}/feature-flags/rollout/api/v1/organizations/{organization_id}/feature-flags/rollout/evaluate

Evaluate whether a flag is active given a specific app version and datetime

Public

Request Example

{
  "flag_key": "travel_reimbursement",
  "app_version": "2.5.1",
  "evaluate_at": "2026-03-26T11:00:00Z"
}

Response Example

{
  "flag_key": "travel_reimbursement",
  "enabled": true,
  "version_sufficient": true,
  "date_reached": true,
  "rollout_condition": {
    "min_version": "2.4.0",
    "activation_date": "2026-01-15T00:00:00Z"
  },
  "evaluated_at": "2026-03-26T11:00:00Z"
}

POST

/api/v1/organizations/{organization_id}/feature-flags/rollout/api/v1/organizations/{organization_id}/feature-flags/rollout/evaluate-version

Check if an app version meets the minimum version requirement for a flag

Public

Request Example

{
  "flag_key": "certification",
  "current_version": "2.5.1",
  "min_version": "3.0.0"
}

Response Example

{
  "flag_key": "certification",
  "current_version": "2.5.1",
  "min_version": "3.0.0",
  "version_sufficient": false
}

GET

/api/v1/organizations/{organization_id}/feature-flags/rollout/api/v1/organizations/{organization_id}/feature-flags/rollout/{flag_key}

Get the rollout condition for a specific flag

Public

Response Example

{
  "flag_key": "encrypted_assignment_dispatch",
  "organization_id": "org-nansen-akademiet",
  "rollout_condition": {
    "min_version": "2.6.0",
    "activation_date": "2026-02-01T00:00:00Z"
  }
}

PUT

/api/v1/organizations/{organization_id}/feature-flags/rollout/api/v1/organizations/{organization_id}/feature-flags/rollout/{flag_key}

Set or update the rollout condition for a flag

Public

Request Example

{
  "min_version": "2.7.0",
  "activation_date": "2026-04-01T00:00:00Z"
}

Response Example

{
  "flag_key": "encrypted_assignment_dispatch",
  "organization_id": "org-nansen-akademiet",
  "rollout_condition": {
    "min_version": "2.7.0",
    "activation_date": "2026-04-01T00:00:00Z"
  },
  "updated_at": "2026-03-26T11:10:00Z"
}

DELETE

/api/v1/organizations/{organization_id}/feature-flags/rollout/api/v1/organizations/{organization_id}/feature-flags/rollout/{flag_key}

Remove the rollout condition from a flag (immediate rollout if enabled)

Public

Response Example

{
  "flag_key": "travel_reimbursement",
  "organization_id": "org-nansen-akademiet",
  "rollout_condition": null,
  "updated_at": "2026-03-26T11:12:00Z"
}

Additional Metadata

{
  "contract_summary": {
    "total_contracts": 410,
    "total_endpoints": 2416,
    "api_styles_used": [
      "rest"
    ]
  },
  "generated_at": "2026-03-26T06:55:53.316Z"
}