Feature Flag Repository - API Contract

GET /api/v1/organizations/{organization_id}/feature-flags/api/v1/organizations/{organization_id}/feature-flags

List all feature flags for an organization

Public

Response Example

{
  "data": [
    {
      "flag_key": "travel_reimbursement",
      "enabled": true,
      "organization_id": "org-nansen-akademiet",
      "rollout_condition": {
        "min_version": "2.4.0",
        "activation_date": "2026-01-15T00:00:00Z"
      },
      "created_at": "2025-11-01T08:00:00Z",
      "updated_at": "2026-01-15T12:30:00Z"
    },
    {
      "flag_key": "course_administration",
      "enabled": true,
      "organization_id": "org-nansen-akademiet",
      "rollout_condition": null,
      "created_at": "2025-11-01T08:00:00Z",
      "updated_at": "2026-03-01T09:00:00Z"
    },
    {
      "flag_key": "certification",
      "enabled": false,
      "organization_id": "org-nansen-akademiet",
      "rollout_condition": {
        "min_version": "3.0.0",
        "activation_date": null
      },
      "created_at": "2025-11-01T08:00:00Z",
      "updated_at": "2026-02-10T14:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 4
  }
}

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

Get a single feature flag by key

Public

Response Example

{
  "flag_key": "encrypted_assignment_dispatch",
  "enabled": true,
  "organization_id": "org-nansen-akademiet",
  "rollout_condition": {
    "min_version": "2.6.0",
    "activation_date": "2026-02-01T00:00:00Z"
  },
  "created_at": "2025-12-01T10:00:00Z",
  "updated_at": "2026-02-01T00:00:00Z"
}

POST /api/v1/organizations/{organization_id}/feature-flags/api/v1/organizations/{organization_id}/feature-flags

Create a new feature flag for an organization

Public

Request Example

{
  "flag_key": "peer_review_module",
  "enabled": false,
  "rollout_condition": {
    "min_version": "3.1.0",
    "activation_date": "2026-06-01T00:00:00Z"
  }
}

Response Example

{
  "flag_key": "peer_review_module",
  "enabled": false,
  "organization_id": "org-nansen-akademiet",
  "rollout_condition": {
    "min_version": "3.1.0",
    "activation_date": "2026-06-01T00:00:00Z"
  },
  "created_at": "2026-03-26T11:00:00Z",
  "updated_at": "2026-03-26T11:00:00Z"
}

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

Update a feature flag's enabled state or rollout condition

Public

Request Example

{
  "enabled": true,
  "rollout_condition": {
    "min_version": "2.4.0",
    "activation_date": "2026-04-01T00:00:00Z"
  }
}

Response Example

{
  "flag_key": "travel_reimbursement",
  "enabled": true,
  "organization_id": "org-nansen-akademiet",
  "rollout_condition": {
    "min_version": "2.4.0",
    "activation_date": "2026-04-01T00:00:00Z"
  },
  "created_at": "2025-11-01T08:00:00Z",
  "updated_at": "2026-03-26T11:05:00Z"
}

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

Delete a feature flag for an organization

Public

Response Example

{
  "deleted": true,
  "flag_key": "peer_review_module"
}

PATCH

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

Update only the rollout condition for a flag

Public

Request Example

{
  "min_version": "2.8.0",
  "activation_date": "2026-05-15T00:00:00Z"
}

Response Example

{
  "flag_key": "certification",
  "organization_id": "org-nansen-akademiet",
  "rollout_condition": {
    "min_version": "2.8.0",
    "activation_date": "2026-05-15T00:00:00Z"
  },
  "updated_at": "2026-03-26T11:10:00Z"
}

Additional Metadata

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