Version Policy API

Endpoints for getting and setting the minimum version policy per environment.

Endpoints

GET/v1/environments/{env_id}/versionGet the current version policy

POST/v1/environments/{env_id}/versionCreate or update the version policy

POST /v1/environments/{env_id}/version

// Request
{
  "min_version": "2.1.0",
  "status": "force_update",
  "message": "A critical update is required to continue.",
  "store_url": "https://apps.apple.com/app/id123456"
}

// Response 200
{
  "id": "uuid",
  "environment_id": "env_uuid",
  "min_version": "2.1.0",
  "status": "force_update",
  "message": "A critical update is required to continue.",
  "store_url": "https://apps.apple.com/app/id123456",
  "updated_at": "2026-01-01T00:00:00Z"
}

Status values

force_updateUser must update — app is blocked

soft_updateUser is prompted to update — dismissible

up_to_dateNo update required — no UI shown