---
title: "GET /api/v1/hosting/apps/{app_id}/deployment_dashboard"
method: GET
path: "/api/v1/hosting/apps/{app_id}/deployment_dashboard"
tags: ["hosting"]
---

# GET /api/v1/hosting/apps/{app_id}/deployment_dashboard

`GET /api/v1/hosting/apps/{app_id}/deployment_dashboard`

## Request

- Base URL: `https://composal.com` (the document declares no server; this is the origin it was published from)
- URL: `https://composal.com/api/v1/hosting/apps/{app_id}/deployment_dashboard`
- Auth: HTTP bearer

## Path parameters

- `app_id` string, required

## Query parameters

- `metrics_range` '1h' | '6h' | '24h' | '7d'

## Response `200`

Hosted app deployment dashboard

- DeploymentDashboard
  - `app` HostedApp, required
    - `id` string, required
    - `organization_id` string, required
    - `repository_id` string, required
    - `repository_kind` string, nullable, required
    - `slug` string, required
    - `name` string, required
    - `description` string, nullable, required
    - `root_path` string, required
    - `root_path_display` string, required
    - `framework` string, nullable, required
    - `status` 'draft' | 'active' | 'archived', required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `created_at_label` string, nullable, required
    - `updated_at_label` string, nullable, required
  - `observability` DeploymentDashboardObservability, required
    - `grafana_embed` GrafanaEmbed, required
      - `provider` 'grafana', required
      - `scope` 'app' | 'service' | 'environment', required
      - `title` string, required
      - `description` string, required
      - `url` string, required
      - `external_url` string, uri, required
    - `environment_embeds` EnvironmentGrafanaEmbed[], required
      - `environment` AppEnvironment, required
        - `id` string, required
        - `hosted_app_id` string, required
        - `location_id` string, required
        - `slug` string, required
        - `name` string, required
        - `kind` 'production' | 'staging' | 'development' | 'preview' | 'ephemeral' | 'custom', required
        - `status` 'active' | 'paused' | 'archived', required
        - `location` HostingLocation, required
          - `id` string, required
          - `code` string, required
          - `name` string, required
          - `nomad_datacenter` string, required
          - `created_at` string, date-time, required
          - `updated_at` string, date-time, required
        - `branch_pattern` string, nullable, required
        - `base_domain` string, nullable, required
        - `auto_deploy` boolean, required
        - `created_at` string, date-time, required
        - `updated_at` string, date-time, required
        - `created_at_label` string, nullable, required
        - `updated_at_label` string, nullable, required
      - `grafana_embed` GrafanaEmbed, required
        - `provider` 'grafana', required
        - `scope` 'app' | 'service' | 'environment', required
        - `title` string, required
        - `description` string, required
        - `url` string, required
        - `external_url` string, uri, required
    - `observed_metrics` ObservedMetricsSnapshot, required
      - `state` 'ready' | 'collecting' | 'unavailable', required
      - `range` '1h' | '6h' | '24h' | '7d', required
      - `available_ranges` string[], required
      - `results` ObservedMetricResult[], required
        - `name` string, required
        - `title` string, required
        - `unit` 'percent' | 'bytes' | 'count' | 'requests_per_second' | 'seconds' | 'milliseconds', required
        - `step_seconds` integer, required
        - `series` ObservedMetricSeries[], required
          - `key` string, required
          - `label` string, required
          - `unit` 'percent' | 'bytes' | 'count' | 'requests_per_second' | 'seconds' | 'milliseconds', required
          - `points` array[], required
            - number[]
        - `truncated` boolean, required
        - `rejected_series_count` integer, required
      - `error` string, nullable, required
  - `summary` DeploymentDashboardSummary, required
    - `service_count` integer, required
    - `environment_count` integer, required
    - `desired_state_count` integer, required
    - `deployment_count` integer, required
    - `active_release_count` integer, required
    - `in_flight_release_count` integer, required
    - `running_instance_count` integer, required
    - `unhealthy_instance_count` integer, required
    - `nomad_job_count` integer, required
    - `nomad_deployment_count` integer, required
    - `nomad_eval_count` integer, required
    - `nomad_allocation_count` integer, required
    - `recent_event_count` integer, required
  - `capacity` DeploymentCapacity, required
    - `cpu_mhz` integer, required
    - `memory_mb` integer, required
    - `disk_mb` integer, required
    - `cpu_label` string, required
    - `memory_label` string, required
    - `disk_label` string, required
    - `running_instances` integer, required
    - `desired_instances` integer, required
    - `public_endpoints` integer, required
  - `activity` DeploymentActivityItem[], required
    - `id` string, required
    - `source` 'deployment' | 'release' | 'rollout' | 'reconciler' | 'event', required
    - `title` string, required
    - `subtitle` string, required
    - `timestamp` string, date-time, required
    - `timestamp_label` string, required
    - `service_id` string, nullable, required
    - `environment_id` string, nullable, required
    - `status` string, required
    - `tone` 'neutral' | 'success' | 'warning' | 'danger' | 'info', required
    - `detail` string, nullable, required
  - `locations` HostingLocation[], required
    - `id` string, required
    - `code` string, required
    - `name` string, required
    - `nomad_datacenter` string, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `environments` AppEnvironment[], required
    - `id` string, required
    - `hosted_app_id` string, required
    - `location_id` string, required
    - `slug` string, required
    - `name` string, required
    - `kind` 'production' | 'staging' | 'development' | 'preview' | 'ephemeral' | 'custom', required
    - `status` 'active' | 'paused' | 'archived', required
    - `location` HostingLocation, required
      - `id` string, required
      - `code` string, required
      - `name` string, required
      - `nomad_datacenter` string, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `branch_pattern` string, nullable, required
    - `base_domain` string, nullable, required
    - `auto_deploy` boolean, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `created_at_label` string, nullable, required
    - `updated_at_label` string, nullable, required
  - `services` AppService[], required
    - `id` string, required
    - `hosted_app_id` string, required
    - `slug` string, required
    - `name` string, required
    - `kind` 'web' | 'worker' | 'cron' | 'static' | 'private', required
    - `runtime` 'docker' | 'node' | 'ruby' | 'python' | 'go' | 'rust' | 'static' | 'generic', required
    - `runtime_adapter_kind` 'nomad' | 'database', required
    - `runtime_adapter_settings_json` string, nullable, required
    - `nomad_namespace` string, nullable, required
    - `nomad_region` string, nullable, required
    - `cpu_mhz` integer, nullable, required
    - `memory_mb` integer, nullable, required
    - `memory_max_mb` integer, nullable, required: Hard memory limit in MB the task may burst to (Nomad MemoryMaxMB). memory_mb stays the reservation the scheduler places against, so raising this does not make a rollout harder to place. Must be >= memory_mb. Memory above the reservation is oversubscribed and best effort: under node pressure the kernel reclaims it and can OOM-kill the task. Null/absent renders no limit beyond the reservation.
    - `disk_mb` integer, nullable, required
    - `nomad_constraints_json` string, nullable, required
    - `nomad_update_strategy_json` string, nullable, required
    - `nomad_ulimits_json` string, nullable, required: Docker task ulimits as a JSON object of rlimit name to "soft:hard" (e.g. {"nofile":"65536:65536"}). Null/absent leaves the container on the daemon default.
    - `nomad_kill_timeout_seconds` integer, nullable, required: Seconds the task gets after SIGTERM before SIGKILL. Null/absent leaves Nomad's 5s default. Capped at 30 because a Nomad client silently clamps kill_timeout to its own max_kill_timeout (default 30s).
    - `nomad_shutdown_delay_seconds` integer, nullable, required: Seconds Nomad waits between deregistering the group's services and sending SIGTERM, so the edge stops routing new requests to the allocation before it is signalled. Null/absent leaves Nomad's 0s default.
    - `source_path` string, required
    - `repo_source_path` string, required
    - `build_command` string, nullable, required
    - `release_command` string, nullable, required
    - `prestart_command` string, nullable, required
    - `start_command` string, nullable, required
    - `healthcheck_path` string, nullable, required
    - `schedule` string, nullable, required
    - `internal_port` integer, nullable, required
    - `desired_instances` integer, required
    - `publicly_accessible` boolean, required
    - `auto_deploy` boolean, required
    - `deploy_paths` string[], required: Explicit repo-root-relative path prefixes/globs a push must touch to auto-deploy. Empty means default to the app root_path.
    - `effective_deploy_paths` string[], required: Tracked paths actually applied by the auto-deploy trigger (explicit deploy_paths, else [root_path]).
    - `bindings` AppServiceBinding[], required
      - `id` string, required
      - `hosted_app_id` string, required
      - `app_service_id` string, required
      - `bindable_type` string, required
      - `bindable_id` string, required
      - `binding_type` string, required
      - `name` string, required
      - `mount_path` string, nullable, required
      - `read_only` boolean, required
      - `required` boolean, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `created_at_label` string, nullable, required
    - `updated_at_label` string, nullable, required
    - `cpu_label` string, nullable, required
    - `memory_label` string, nullable, required
    - `memory_max_label` string, nullable, required
    - `disk_label` string, nullable, required
  - `data_resources` AppDataResource[], required
    - `id` string, required
    - `hosted_app_id` string, required
    - `app_environment_id` string, nullable, required
    - `slug` string, required
    - `name` string, required
    - `kind` 'database' | 'cache' | 'queue' | 'search' | 'vector', required
    - `engine` 'postgres' | 'mysql' | 'valkey', required
    - `version` string, nullable, required
    - `plan` string, nullable, required
    - `region` string, nullable, required
    - `status` 'provisioning' | 'available' | 'updating' | 'failed' | 'archived', required
    - `storage_gb` integer, nullable, required
    - `storage_label` string, nullable, required
    - `high_availability` boolean, required
    - `provider_metadata` object, required
    - `failure_message` string, nullable, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `managed_database_catalog` ManagedDatabaseCatalog, required
    - `default_provider_kind` string, required
    - `fallback_provider_kind` string, required
    - `provider_configured` boolean, required
    - `live_catalog` boolean, required
    - `engines` ManagedDatabaseEngine[], required
      - `engine` 'postgres' | 'mysql' | 'valkey', required
      - `kind` 'database' | 'cache', required
      - `label` string, required
      - `provider_kind` string, required
      - `provider_database_kind` string, nullable
      - `default_version` string, nullable
      - `default_plan` string, nullable
      - `default_cluster_size` string, nullable
      - `default_connection_mode` string, nullable
      - `sslmode` string, nullable
      - `ssl_mode` string, nullable
      - `supported_versions` string[]
      - `regions` ManagedDatabaseRegion[]
        - `slug` string, required
        - `display_name` string, nullable
        - `location` string, nullable
        - `vex_location_code` string, nullable
        - `provider` string, nullable
        - `enabled` boolean, nullable
        - `postgresql_supported` boolean, nullable
        - `mysql_supported` boolean, nullable
        - `current_default` boolean, nullable
        - `source` string, nullable
      - `cluster_sizes` ManagedDatabaseClusterSize[]
        - `name` string, required
        - `display_name` string, nullable
        - `enabled` boolean, nullable
        - `production` boolean, nullable
        - `development` boolean, nullable
        - `cpu` union
          - string
          - number
        - `ram` union
          - string
          - number
        - `storage` union
          - string
          - number
        - `metal` union
          - string
          - boolean
        - `architecture` string, nullable
  - `storage_resources` AppStorageResource[], required
    - `id` string, required
    - `hosted_app_id` string, required
    - `app_environment_id` string, nullable, required
    - `location_id` string, nullable, required: Volume datacenter pin (volume kind only)
    - `location_code` string, nullable, required
    - `slug` string, required
    - `name` string, required
    - `kind` 'bucket' | 'volume', required
    - `provider` 's3' | 'tigris' | 'nomad_csi' | 'local_nvme' | 'local_nvme_authority', required: Storage backend. `local_nvme` is a directory on the node's own NVMe, created as a Nomad dynamic host volume — fast, node-local and EPHEMERAL: the platform may delete it at any time and it does not survive the loss of its node. Use it as a cache, never as a system of record. `local_nvme_authority` is a single-node, single-writer authority volume that refuses destructive repair. Node loss requires restoration from remote replication into a new volume.
    - `region` string, nullable, required
    - `access_mode` 'private' | 'public' | 'internal', required: Object-store semantics only; ignored for volume resources
    - `mount_path` string, nullable, required
    - `capacity_gb` integer, nullable, required
    - `capacity_label` string, nullable, required
    - `status` 'provisioning' | 'available' | 'updating' | 'failed' | 'archived', required
    - `external_volume_id` string, nullable, required: Nomad/CSI volume id assigned at provisioning
    - `attachment` object, nullable, required: Attachment readback: CSI publish state for nomad_csi, or the nodes carrying the directory for local_nvme. Nil until provisioned
      - `state` 'attached' | 'detached'
      - `node_ids` string[]
      - `alloc_ids` string[]
    - `ephemeral` boolean, required: True when the contents may be deleted at any time and do not survive the loss of the underlying node. Ephemeral storage is a cache and must never hold a system of record.
    - `provider_error` string, nullable, required: Last provisioning/teardown error from the storage provider
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `service_bindings` AppServiceBinding[], required
    - `id` string, required
    - `hosted_app_id` string, required
    - `app_service_id` string, required
    - `bindable_type` string, required
    - `bindable_id` string, required
    - `binding_type` string, required
    - `name` string, required
    - `mount_path` string, nullable, required
    - `read_only` boolean, required
    - `required` boolean, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `connections` ServiceConnection[], required
    - `source_service_id` string, required
    - `target_kind` 'service' | 'data_resource' | 'storage_resource', required
    - `target_id` string, required
    - `binding_types` string[], required
  - `placements` AppServicePlacement[], required
    - `id` string, required
    - `organization_id` string, required
    - `hosted_app_id` string, required
    - `app_service_id` string, required
    - `app_environment_id` string, required
    - `mode` 'single_region' | 'multi_region', required
    - `rollout_strategy` 'health_gated' | 'burst', required
    - `deployment_channel` 'stable' | 'blue_green', nullable, required: Preview-only override; null inherits the captured source channel.
    - `replicas_per_region` integer, required
    - `region_count` integer, required
    - `total_replicas` integer, required
    - `targets` object[], required
      - `id` string, required
      - `location_id` string, required
      - `location` HostingLocation, required
        - `id` string, required
        - `code` string, required
        - `name` string, required
        - `nomad_datacenter` string, required
        - `created_at` string, date-time, required
        - `updated_at` string, date-time, required
      - `position` integer, required
      - `enabled` boolean, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `desired_states` AppDesiredState[], required
    - `id` string, required
    - `organization_id` string, required
    - `hosted_app_id` string, required
    - `app_environment_id` string, required
    - `app_service_id` string, required
    - `network_segment_id` string, nullable, required
    - `slug` string, required
    - `status` 'active' | 'paused' | 'archived', required
    - `desired_instances` integer, required
    - `desired_version` string, nullable, required
    - `image_locator` string, nullable, required
    - `command` string, nullable, required
    - `env_fingerprint` string, nullable, required
    - `config_fingerprint` string, nullable, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `created_at_label` string, nullable, required
    - `updated_at_label` string, nullable, required
  - `operations` DeploymentOperation[], required
    - `rollout_predecessor_id` string, nullable, required
    - `id` string, required
    - `number` integer, required
    - `status` 'queued' | 'building' | 'deploying' | 'active' | 'failed' | 'rolled_back' | 'canceled', required
    - `app` object, required
      - `id` string, required
      - `slug` string, required
      - `name` string, required
    - `service` object, required
      - `id` string, required
      - `slug` string, required
      - `name` string, required
    - `environment` object, required
      - `id` string, required
      - `slug` string, required
      - `name` string, required
      - `kind` string, required
    - `placement` object, nullable, required
      - `id` string, required
      - `mode` 'single_region' | 'multi_region', required
      - `rollout_strategy` 'health_gated' | 'burst', required
      - `replicas_per_region` integer, required
      - `total_replicas` integer, required
    - `rollout_strategy` 'health_gated' | 'burst', required
    - `replicas_per_region` integer, required
    - `total_replicas` integer, required
    - `trigger_kind` 'manual' | 'push' | 'schedule' | 'api' | 'rollback', required
    - `is_rollback` boolean, required
    - `rollback_source_release_id` string, nullable, required
    - `rollback_target_release_id` string, nullable, required
    - `rollback_reason` string, nullable, required
    - `source_ref` string, nullable, required
    - `commit_sha` string, nullable, required
    - `artifact_locator` string, nullable, required
    - `deployed_url` string, uri, nullable, required
    - `build_duration_seconds` integer, nullable, required
    - `duration_seconds` integer, nullable, required
    - `creator` object, nullable, required
      - `id` string, required
      - `name` string, nullable, required
      - `picture_url` string, nullable, required
    - `build_status` 'queued' | 'building' | 'succeeded' | 'failed' | 'canceled' | 'skipped', required
    - `rollout_status` 'not_started' | 'queued' | 'running' | 'succeeded' | 'failed' | 'canceled' | 'mixed', required
    - `history_kind` 'current' | 'superseded' | 'stale' | 'historical', required
    - `history_reason` string, nullable, required
    - `ci_pipeline_id` string, nullable, required
    - `ci_pipeline_run_id` string, nullable, required
    - `build_source` object, nullable, required
      - `phase` 'waiting' | 'reused', required
      - `deployment_id` string, required
      - `canonical_deployment_id` string, required
      - `number` integer, required
    - `region_count` integer, required
    - `live_region_count` integer, required
    - `is_live` boolean, required
    - `children` DeploymentOperationChild[], required
      - `deployment_id` string, required
      - `target_id` string, nullable, required
      - `number` integer, required
      - `environment` object, required
        - `id` string, required
        - `slug` string, required
        - `name` string, required
        - `kind` string, required
      - `location` object, nullable, required
        - `id` string, required
        - `code` string, required
        - `name` string, required
      - `build_role` 'leader' | 'follower' | 'standalone', required
      - `build_status` 'queued' | 'building' | 'succeeded' | 'failed' | 'canceled' | 'skipped', required
      - `rollout_status` 'not_started' | 'queued' | 'running' | 'succeeded' | 'failed' | 'canceled', required
      - `history_kind` 'current' | 'superseded' | 'stale' | 'historical', required
      - `history_reason` string, nullable, required
      - `recorded_status` 'queued' | 'building' | 'deploying' | 'active' | 'failed' | 'rolled_back' | 'canceled', required
      - `desired_replicas` integer, required
      - `live_replicas` integer, required
      - `is_live` boolean, required
      - `release_id` string, nullable, required
      - `rollout_id` string, nullable, required
      - `failure_message` string, nullable, required
      - `superseded_by_deployment_id` string, nullable, required
      - `ci_pipeline_id` string, nullable, required
      - `ci_pipeline_run_id` string, nullable, required
      - `started_at` string, date-time, nullable, required
      - `finished_at` string, date-time, nullable, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `deployments` AppDeployment[], required
    - `id` string, required
    - `hosted_app_id` string, required
    - `organization_id` string, required
    - `app_service_id` string, required
    - `app_environment_id` string, required
    - `location_id` string, required
    - `creator_user_id` string, nullable, required
    - `number` integer, required
    - `display_id` integer, required
    - `status` 'queued' | 'building' | 'deploying' | 'active' | 'failed' | 'rolled_back' | 'canceled', required
    - `location` HostingLocation, required
      - `id` string, required
      - `code` string, required
      - `name` string, required
      - `nomad_datacenter` string, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `source_ref` string, nullable, required
    - `commit_sha` string, nullable, required
    - `artifact_locator` string, nullable, required
    - `deployed_url` string, nullable, required
    - `trigger_kind` 'manual' | 'push' | 'schedule' | 'api' | 'rollback', required
    - `operation_key` string, nullable, required
    - `build_role` 'leader' | 'follower' | 'standalone', nullable, required
    - `is_rollback` boolean, required
    - `rollback_source_release_id` string, nullable, required
    - `rollback_target_release_id` string, nullable, required
    - `rollback_source_deployment_id` string, nullable, required
    - `rollback_reason` string, nullable, required
    - `idempotency_key` string, nullable, required
    - `failure_message` string, nullable, required
    - `started_at` string, date-time, nullable, required
    - `finished_at` string, date-time, nullable, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `started_at_label` string, nullable, required
    - `finished_at_label` string, nullable, required
    - `created_at_label` string, nullable, required
    - `updated_at_label` string, nullable, required
  - `rollback_deployments` AppDeployment[], required
    - `id` string, required
    - `hosted_app_id` string, required
    - `organization_id` string, required
    - `app_service_id` string, required
    - `app_environment_id` string, required
    - `location_id` string, required
    - `creator_user_id` string, nullable, required
    - `number` integer, required
    - `display_id` integer, required
    - `status` 'queued' | 'building' | 'deploying' | 'active' | 'failed' | 'rolled_back' | 'canceled', required
    - `location` HostingLocation, required
      - `id` string, required
      - `code` string, required
      - `name` string, required
      - `nomad_datacenter` string, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `source_ref` string, nullable, required
    - `commit_sha` string, nullable, required
    - `artifact_locator` string, nullable, required
    - `deployed_url` string, nullable, required
    - `trigger_kind` 'manual' | 'push' | 'schedule' | 'api' | 'rollback', required
    - `operation_key` string, nullable, required
    - `build_role` 'leader' | 'follower' | 'standalone', nullable, required
    - `is_rollback` boolean, required
    - `rollback_source_release_id` string, nullable, required
    - `rollback_target_release_id` string, nullable, required
    - `rollback_source_deployment_id` string, nullable, required
    - `rollback_reason` string, nullable, required
    - `idempotency_key` string, nullable, required
    - `failure_message` string, nullable, required
    - `started_at` string, date-time, nullable, required
    - `finished_at` string, date-time, nullable, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `started_at_label` string, nullable, required
    - `finished_at_label` string, nullable, required
    - `created_at_label` string, nullable, required
    - `updated_at_label` string, nullable, required
  - `releases` AppRelease[], required
    - `id` string, required
    - `organization_id` string, required
    - `hosted_app_id` string, required
    - `app_environment_id` string, required
    - `app_service_id` string, required
    - `location_id` string, required
    - `created_by_user_id` string, nullable, required
    - `app_deployment_id` string, nullable, required
    - `ci_pipeline_run_id` string, nullable, required
    - `slug` string, required
    - `version` string, required
    - `location` HostingLocation, required
      - `id` string, required
      - `code` string, required
      - `name` string, required
      - `nomad_datacenter` string, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `release_command_execution` AppReleaseCommandExecution, required
      - `id` string, required
      - `app_release_id` string, required
      - `app_deployment_id` string, required
      - `ci_pipeline_run_id` string, nullable, required
      - `status` 'queued' | 'running' | 'succeeded' | 'failed' | 'timed_out', required
      - `provider_kind` string, required
      - `attempt_count` integer, required
      - `max_attempts` integer, required
      - `timeout_seconds` integer, required
      - `logs` string, nullable, required
      - `exit_code` integer, nullable, required
      - `failure_message` string, nullable, required
      - `started_at` string, date-time, nullable, required
      - `finished_at` string, date-time, nullable, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
      - `started_at_label` string, nullable, required
      - `finished_at_label` string, nullable, required
      - `created_at_label` string, nullable, required
      - `updated_at_label` string, nullable, required
    - `nomad_job_id` string, nullable, required
    - `nomad_namespace` string, nullable, required
    - `nomad_job_version` integer, nullable, required
    - `nomad_deployment_id` string, nullable, required
    - `nomad_eval_id` string, nullable, required
    - `rendered_job_spec_digest` string, nullable, required
    - `source_ref` string, nullable, required
    - `commit_sha` string, nullable, required
    - `release_kind` 'deployment' | 'rollback' | 'hotfix', required
    - `release_command` string, nullable, required
    - `prestart_command` string, nullable, required
    - `image_digest` string, nullable, required
    - `image_reference` string, nullable, required
    - `image_repository` string, nullable, required
    - `source_commit` string, nullable, required
    - `builder_image` string, nullable, required
    - `builder_version` string, nullable, required
    - `target_platform` string, nullable, required
    - `ci_run_identity` string, nullable, required
    - `is_rollback` boolean, required
    - `rollback_target_release_id` string, nullable, required
    - `status` 'draft' | 'ready' | 'deploying' | 'active' | 'failed' | 'rolled_back', required
    - `deployment_phase` 'failed' | 'active' | 'deploying' | 'ready' | 'rolled_back' | 'unknown', required
    - `rollout_status` 'queued' | 'running' | 'succeeded' | 'failed' | 'canceled', nullable, required
    - `rollback_reason` string, nullable, required
    - `self_hosted_managed` boolean, required
    - `self_hosted_reconcile_enabled` boolean, required
    - `self_hosted_apply_enabled` boolean, required
    - `notes` string, nullable, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `created_at_label` string, nullable, required
    - `updated_at_label` string, nullable, required
  - `rollouts` AppRollout[], required
    - `id` string, required
    - `organization_id` string, required
    - `app_release_id` string, required
    - `strategy` string, required
    - `status` 'queued' | 'running' | 'succeeded' | 'failed' | 'canceled', required
    - `deployment_phase` 'queued' | 'deploying' | 'active' | 'failed' | 'unknown', required
    - `auto_safe_rollout` boolean, required
    - `nomad_deployment_id` string, nullable, required
    - `nomad_eval_id` string, nullable, required
    - `target_percentage` integer, required
    - `summary` string, nullable, required
    - `started_at` string, date-time, nullable, required
    - `finished_at` string, date-time, nullable, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `started_at_label` string, nullable, required
    - `finished_at_label` string, nullable, required
    - `created_at_label` string, nullable, required
    - `updated_at_label` string, nullable, required
  - `runtime_instances` RuntimeInstance[], required
    - `id` string, required
    - `organization_id` string, required
    - `hosted_app_id` string, required
    - `app_environment_id` string, required
    - `app_service_id` string, required
    - `app_release_id` string, nullable, required
    - `location_id` string, required
    - `network_peer_id` string, nullable, required
    - `slug` string, required
    - `instance_key` string, required
    - `service_name` string, required: Name of the Vex service this instance runs, in the same vocabulary as `vex deploy list`. `nomad_task_name` is the scheduler's own name for the same workload.
    - `location` HostingLocation, required
      - `id` string, required
      - `code` string, required
      - `name` string, required
      - `nomad_datacenter` string, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `status` 'starting' | 'running' | 'degraded' | 'stopped' | 'terminated' | 'failed', required
    - `adapter_kind` 'database' | 'nomad', required
    - `provider_instance_id` string, nullable, required
    - `nomad_allocation_id` string, nullable, required
    - `nomad_task_name` string, nullable, required
    - `private_ipv4` string, nullable, required
    - `private_ipv6` string, nullable, required
    - `public_endpoint` string, nullable, required
    - `booted_at` string, date-time, nullable, required
    - `terminated_at` string, date-time, nullable, required
    - `last_seen_at` string, date-time, nullable, required
    - `last_reconciled_at` string, date-time, nullable, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `booted_at_label` string, nullable, required
    - `terminated_at_label` string, nullable, required
    - `last_seen_at_label` string, nullable, required
    - `last_reconciled_at_label` string, nullable, required
    - `created_at_label` string, nullable, required
    - `updated_at_label` string, nullable, required
  - `reconciler_ticks` ReconcilerTick[], required
    - `id` string, required
    - `organization_id` string, required
    - `hosted_app_id` string, nullable, required
    - `app_environment_id` string, nullable, required
    - `app_service_id` string, nullable, required
    - `kind` 'generic' | 'release' | 'runtime' | 'network' | 'health' | 'cdn', required
    - `status` 'queued' | 'running' | 'succeeded' | 'failed', required
    - `observed_version` string, nullable, required
    - `summary` string, nullable, required
    - `started_at` string, date-time, nullable, required
    - `finished_at` string, date-time, nullable, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `started_at_label` string, nullable, required
    - `finished_at_label` string, nullable, required
    - `created_at_label` string, nullable, required
    - `updated_at_label` string, nullable, required
  - `audit_events` AuditEvent[], required
    - `id` string, required
    - `observability_space_id` string, nullable, required
    - `organization_id` string, required
    - `actor_user_id` string, nullable, required
    - `actor_kind` 'user' | 'service' | 'system' | 'agent', required
    - `action` string, required
    - `subject_kind` string, required
    - `subject_id` string, required
    - `subject_name` string, nullable, required
    - `request_id` string, nullable, required
    - `severity` 'info' | 'notice' | 'warn' | 'error', required
    - `payload` unknown, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `created_at_label` string, nullable, required
    - `updated_at_label` string, nullable, required
  - `service_views` ServiceView[], required
    - `service` AppService, required
      - `id` string, required
      - `hosted_app_id` string, required
      - `slug` string, required
      - `name` string, required
      - `kind` 'web' | 'worker' | 'cron' | 'static' | 'private', required
      - `runtime` 'docker' | 'node' | 'ruby' | 'python' | 'go' | 'rust' | 'static' | 'generic', required
      - `runtime_adapter_kind` 'nomad' | 'database', required
      - `runtime_adapter_settings_json` string, nullable, required
      - `nomad_namespace` string, nullable, required
      - `nomad_region` string, nullable, required
      - `cpu_mhz` integer, nullable, required
      - `memory_mb` integer, nullable, required
      - `memory_max_mb` integer, nullable, required: Hard memory limit in MB the task may burst to (Nomad MemoryMaxMB). memory_mb stays the reservation the scheduler places against, so raising this does not make a rollout harder to place. Must be >= memory_mb. Memory above the reservation is oversubscribed and best effort: under node pressure the kernel reclaims it and can OOM-kill the task. Null/absent renders no limit beyond the reservation.
      - `disk_mb` integer, nullable, required
      - `nomad_constraints_json` string, nullable, required
      - `nomad_update_strategy_json` string, nullable, required
      - `nomad_ulimits_json` string, nullable, required: Docker task ulimits as a JSON object of rlimit name to "soft:hard" (e.g. {"nofile":"65536:65536"}). Null/absent leaves the container on the daemon default.
      - `nomad_kill_timeout_seconds` integer, nullable, required: Seconds the task gets after SIGTERM before SIGKILL. Null/absent leaves Nomad's 5s default. Capped at 30 because a Nomad client silently clamps kill_timeout to its own max_kill_timeout (default 30s).
      - `nomad_shutdown_delay_seconds` integer, nullable, required: Seconds Nomad waits between deregistering the group's services and sending SIGTERM, so the edge stops routing new requests to the allocation before it is signalled. Null/absent leaves Nomad's 0s default.
      - `source_path` string, required
      - `repo_source_path` string, required
      - `build_command` string, nullable, required
      - `release_command` string, nullable, required
      - `prestart_command` string, nullable, required
      - `start_command` string, nullable, required
      - `healthcheck_path` string, nullable, required
      - `schedule` string, nullable, required
      - `internal_port` integer, nullable, required
      - `desired_instances` integer, required
      - `publicly_accessible` boolean, required
      - `auto_deploy` boolean, required
      - `deploy_paths` string[], required: Explicit repo-root-relative path prefixes/globs a push must touch to auto-deploy. Empty means default to the app root_path.
      - `effective_deploy_paths` string[], required: Tracked paths actually applied by the auto-deploy trigger (explicit deploy_paths, else [root_path]).
      - `bindings` AppServiceBinding[], required
        - `id` string, required
        - `hosted_app_id` string, required
        - `app_service_id` string, required
        - `bindable_type` string, required
        - `bindable_id` string, required
        - `binding_type` string, required
        - `name` string, required
        - `mount_path` string, nullable, required
        - `read_only` boolean, required
        - `required` boolean, required
        - `created_at` string, date-time, required
        - `updated_at` string, date-time, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
      - `created_at_label` string, nullable, required
      - `updated_at_label` string, nullable, required
      - `cpu_label` string, nullable, required
      - `memory_label` string, nullable, required
      - `memory_max_label` string, nullable, required
      - `disk_label` string, nullable, required
    - `grafana_embed` GrafanaEmbed, required
      - `provider` 'grafana', required
      - `scope` 'app' | 'service' | 'environment', required
      - `title` string, required
      - `description` string, required
      - `url` string, required
      - `external_url` string, uri, required
    - `runtime_summary` EnvironmentRuntimeSummary, required
      - `desired_instances` integer, required
      - `desired_version` string, nullable, required
      - `total_instances` integer, required
      - `running_instances` integer, required
      - `degraded_instances` integer, required
      - `failed_instances` integer, required
    - `status` string, required
    - `region_footprints` ServiceRegionFootprint[], required
      - `location_id` string, required
      - `location_name` string, required
      - `live` integer, required
      - `desired` integer, required
    - `capacity` ServiceCapacity, required
      - `reservation_instances` integer, required
      - `deployment_channel` string, required
      - `rollout_extra_instances` integer, required
      - `rollout_peak` RolloutPeakCapacity, required
        - `instances` integer, required
        - `cpu_mhz` integer, required
        - `memory_mb` integer, required
        - `disk_mb` integer, required
        - `cpu_label` string, required
        - `memory_label` string, required
        - `disk_label` string, required
      - `resources` object, required
        - `cpu` ServiceCapacityResource, required
          - `value` integer, required
          - `value_label` string, required
          - `defaulted` boolean, required
          - `total` integer, required
          - `total_label` string, required
        - `memory` ServiceCapacityResource, required
          - `value` integer, required
          - `value_label` string, required
          - `defaulted` boolean, required
          - `total` integer, required
          - `total_label` string, required
        - `disk` ServiceCapacityResource, required
          - `value` integer, required
          - `value_label` string, required
          - `defaulted` boolean, required
          - `total` integer, required
          - `total_label` string, required
    - `latest_release` AppRelease, required
      - `id` string, required
      - `organization_id` string, required
      - `hosted_app_id` string, required
      - `app_environment_id` string, required
      - `app_service_id` string, required
      - `location_id` string, required
      - `created_by_user_id` string, nullable, required
      - `app_deployment_id` string, nullable, required
      - `ci_pipeline_run_id` string, nullable, required
      - `slug` string, required
      - `version` string, required
      - `location` HostingLocation, required
        - `id` string, required
        - `code` string, required
        - `name` string, required
        - `nomad_datacenter` string, required
        - `created_at` string, date-time, required
        - `updated_at` string, date-time, required
      - `release_command_execution` AppReleaseCommandExecution, required
        - `id` string, required
        - `app_release_id` string, required
        - `app_deployment_id` string, required
        - `ci_pipeline_run_id` string, nullable, required
        - `status` 'queued' | 'running' | 'succeeded' | 'failed' | 'timed_out', required
        - `provider_kind` string, required
        - `attempt_count` integer, required
        - `max_attempts` integer, required
        - `timeout_seconds` integer, required
        - `logs` string, nullable, required
        - `exit_code` integer, nullable, required
        - `failure_message` string, nullable, required
        - `started_at` string, date-time, nullable, required
        - `finished_at` string, date-time, nullable, required
        - `created_at` string, date-time, required
        - `updated_at` string, date-time, required
        - `started_at_label` string, nullable, required
        - `finished_at_label` string, nullable, required
        - `created_at_label` string, nullable, required
        - `updated_at_label` string, nullable, required
      - `nomad_job_id` string, nullable, required
      - `nomad_namespace` string, nullable, required
      - `nomad_job_version` integer, nullable, required
      - `nomad_deployment_id` string, nullable, required
      - `nomad_eval_id` string, nullable, required
      - `rendered_job_spec_digest` string, nullable, required
      - `source_ref` string, nullable, required
      - `commit_sha` string, nullable, required
      - `release_kind` 'deployment' | 'rollback' | 'hotfix', required
      - `release_command` string, nullable, required
      - `prestart_command` string, nullable, required
      - `image_digest` string, nullable, required
      - `image_reference` string, nullable, required
      - `image_repository` string, nullable, required
      - `source_commit` string, nullable, required
      - `builder_image` string, nullable, required
      - `builder_version` string, nullable, required
      - `target_platform` string, nullable, required
      - `ci_run_identity` string, nullable, required
      - `is_rollback` boolean, required
      - `rollback_target_release_id` string, nullable, required
      - `status` 'draft' | 'ready' | 'deploying' | 'active' | 'failed' | 'rolled_back', required
      - `deployment_phase` 'failed' | 'active' | 'deploying' | 'ready' | 'rolled_back' | 'unknown', required
      - `rollout_status` 'queued' | 'running' | 'succeeded' | 'failed' | 'canceled', nullable, required
      - `rollback_reason` string, nullable, required
      - `self_hosted_managed` boolean, required
      - `self_hosted_reconcile_enabled` boolean, required
      - `self_hosted_apply_enabled` boolean, required
      - `notes` string, nullable, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
      - `created_at_label` string, nullable, required
      - `updated_at_label` string, nullable, required
    - `latest_rollout` AppRollout, required
      - `id` string, required
      - `organization_id` string, required
      - `app_release_id` string, required
      - `strategy` string, required
      - `status` 'queued' | 'running' | 'succeeded' | 'failed' | 'canceled', required
      - `deployment_phase` 'queued' | 'deploying' | 'active' | 'failed' | 'unknown', required
      - `auto_safe_rollout` boolean, required
      - `nomad_deployment_id` string, nullable, required
      - `nomad_eval_id` string, nullable, required
      - `target_percentage` integer, required
      - `summary` string, nullable, required
      - `started_at` string, date-time, nullable, required
      - `finished_at` string, date-time, nullable, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
      - `started_at_label` string, nullable, required
      - `finished_at_label` string, nullable, required
      - `created_at_label` string, nullable, required
      - `updated_at_label` string, nullable, required
    - `latest_deployment` AppDeployment, required
      - `id` string, required
      - `hosted_app_id` string, required
      - `organization_id` string, required
      - `app_service_id` string, required
      - `app_environment_id` string, required
      - `location_id` string, required
      - `creator_user_id` string, nullable, required
      - `number` integer, required
      - `display_id` integer, required
      - `status` 'queued' | 'building' | 'deploying' | 'active' | 'failed' | 'rolled_back' | 'canceled', required
      - `location` HostingLocation, required
        - `id` string, required
        - `code` string, required
        - `name` string, required
        - `nomad_datacenter` string, required
        - `created_at` string, date-time, required
        - `updated_at` string, date-time, required
      - `source_ref` string, nullable, required
      - `commit_sha` string, nullable, required
      - `artifact_locator` string, nullable, required
      - `deployed_url` string, nullable, required
      - `trigger_kind` 'manual' | 'push' | 'schedule' | 'api' | 'rollback', required
      - `operation_key` string, nullable, required
      - `build_role` 'leader' | 'follower' | 'standalone', nullable, required
      - `is_rollback` boolean, required
      - `rollback_source_release_id` string, nullable, required
      - `rollback_target_release_id` string, nullable, required
      - `rollback_source_deployment_id` string, nullable, required
      - `rollback_reason` string, nullable, required
      - `idempotency_key` string, nullable, required
      - `failure_message` string, nullable, required
      - `started_at` string, date-time, nullable, required
      - `finished_at` string, date-time, nullable, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
      - `started_at_label` string, nullable, required
      - `finished_at_label` string, nullable, required
      - `created_at_label` string, nullable, required
      - `updated_at_label` string, nullable, required
    - `nomad` DeploymentNomadSummary, required
      - `namespace` string, required
      - `region` string, nullable, required
      - `datacenters` string[], required
      - `constraints` unknown[], required
        - unknown
      - `update_strategy` object, required
      - `deployment_channel` string, required
      - `ownership_layer` string, required
      - `managed_by_vex` boolean, required
      - `self_hosted_managed` boolean, required
      - `self_hosted_reconcile_enabled` boolean, required
      - `self_hosted_apply_enabled` boolean, required
      - `managed_service_allowlist` string[], required
      - `latest_job_id` string, nullable, required
      - `latest_job_version` integer, nullable, required
      - `latest_deployment_id` string, nullable, required
      - `latest_eval_id` string, nullable, required
      - `allocation_ids` string[], required
      - `task_names` string[], required
    - `audit_events` AuditEvent[], required
      - `id` string, required
      - `observability_space_id` string, nullable, required
      - `organization_id` string, required
      - `actor_user_id` string, nullable, required
      - `actor_kind` 'user' | 'service' | 'system' | 'agent', required
      - `action` string, required
      - `subject_kind` string, required
      - `subject_id` string, required
      - `subject_name` string, nullable, required
      - `request_id` string, nullable, required
      - `severity` 'info' | 'notice' | 'warn' | 'error', required
      - `payload` unknown, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
      - `created_at_label` string, nullable, required
      - `updated_at_label` string, nullable, required
    - `environment_views` ServiceEnvironmentView[], required
      - `environment` AppEnvironment, required
        - `id` string, required
        - `hosted_app_id` string, required
        - `location_id` string, required
        - `slug` string, required
        - `name` string, required
        - `kind` 'production' | 'staging' | 'development' | 'preview' | 'ephemeral' | 'custom', required
        - `status` 'active' | 'paused' | 'archived', required
        - `location` HostingLocation, required
          - `id` string, required
          - `code` string, required
          - `name` string, required
          - `nomad_datacenter` string, required
          - `created_at` string, date-time, required
          - `updated_at` string, date-time, required
        - `branch_pattern` string, nullable, required
        - `base_domain` string, nullable, required
        - `auto_deploy` boolean, required
        - `created_at` string, date-time, required
        - `updated_at` string, date-time, required
        - `created_at_label` string, nullable, required
        - `updated_at_label` string, nullable, required
      - `grafana_embed` GrafanaEmbed, required
        - `provider` 'grafana', required
        - `scope` 'app' | 'service' | 'environment', required
        - `title` string, required
        - `description` string, required
        - `url` string, required
        - `external_url` string, uri, required
      - `desired_state` AppDesiredState, required
        - `id` string, required
        - `organization_id` string, required
        - `hosted_app_id` string, required
        - `app_environment_id` string, required
        - `app_service_id` string, required
        - `network_segment_id` string, nullable, required
        - `slug` string, required
        - `status` 'active' | 'paused' | 'archived', required
        - `desired_instances` integer, required
        - `desired_version` string, nullable, required
        - `image_locator` string, nullable, required
        - `command` string, nullable, required
        - `env_fingerprint` string, nullable, required
        - `config_fingerprint` string, nullable, required
        - `created_at` string, date-time, required
        - `updated_at` string, date-time, required
        - `created_at_label` string, nullable, required
        - `updated_at_label` string, nullable, required
      - `latest_deployment` AppDeployment, required
        - `id` string, required
        - `hosted_app_id` string, required
        - `organization_id` string, required
        - `app_service_id` string, required
        - `app_environment_id` string, required
        - `location_id` string, required
        - `creator_user_id` string, nullable, required
        - `number` integer, required
        - `display_id` integer, required
        - `status` 'queued' | 'building' | 'deploying' | 'active' | 'failed' | 'rolled_back' | 'canceled', required
        - `location` HostingLocation, required
          - `id` string, required
          - `code` string, required
          - `name` string, required
          - `nomad_datacenter` string, required
          - `created_at` string, date-time, required
          - `updated_at` string, date-time, required
        - `source_ref` string, nullable, required
        - `commit_sha` string, nullable, required
        - `artifact_locator` string, nullable, required
        - `deployed_url` string, nullable, required
        - `trigger_kind` 'manual' | 'push' | 'schedule' | 'api' | 'rollback', required
        - `operation_key` string, nullable, required
        - `build_role` 'leader' | 'follower' | 'standalone', nullable, required
        - `is_rollback` boolean, required
        - `rollback_source_release_id` string, nullable, required
        - `rollback_target_release_id` string, nullable, required
        - `rollback_source_deployment_id` string, nullable, required
        - `rollback_reason` string, nullable, required
        - `idempotency_key` string, nullable, required
        - `failure_message` string, nullable, required
        - `started_at` string, date-time, nullable, required
        - `finished_at` string, date-time, nullable, required
        - `created_at` string, date-time, required
        - `updated_at` string, date-time, required
        - `started_at_label` string, nullable, required
        - `finished_at_label` string, nullable, required
        - `created_at_label` string, nullable, required
        - `updated_at_label` string, nullable, required
      - `latest_release` AppRelease, required
        - `id` string, required
        - `organization_id` string, required
        - `hosted_app_id` string, required
        - `app_environment_id` string, required
        - `app_service_id` string, required
        - `location_id` string, required
        - `created_by_user_id` string, nullable, required
        - `app_deployment_id` string, nullable, required
        - `ci_pipeline_run_id` string, nullable, required
        - `slug` string, required
        - `version` string, required
        - `location` HostingLocation, required
          - `id` string, required
          - `code` string, required
          - `name` string, required
          - `nomad_datacenter` string, required
          - `created_at` string, date-time, required
          - `updated_at` string, date-time, required
        - `release_command_execution` AppReleaseCommandExecution, required
          - `id` string, required
          - `app_release_id` string, required
          - `app_deployment_id` string, required
          - `ci_pipeline_run_id` string, nullable, required
          - `status` 'queued' | 'running' | 'succeeded' | 'failed' | 'timed_out', required
          - `provider_kind` string, required
          - `attempt_count` integer, required
          - `max_attempts` integer, required
          - `timeout_seconds` integer, required
          - `logs` string, nullable, required
          - `exit_code` integer, nullable, required
          - `failure_message` string, nullable, required
          - `started_at` string, date-time, nullable, required
          - `finished_at` string, date-time, nullable, required
          - `created_at` string, date-time, required
          - `updated_at` string, date-time, required
          - `started_at_label` string, nullable, required
          - `finished_at_label` string, nullable, required
          - `created_at_label` string, nullable, required
          - `updated_at_label` string, nullable, required
        - `nomad_job_id` string, nullable, required
        - `nomad_namespace` string, nullable, required
        - `nomad_job_version` integer, nullable, required
        - `nomad_deployment_id` string, nullable, required
        - `nomad_eval_id` string, nullable, required
        - `rendered_job_spec_digest` string, nullable, required
        - `source_ref` string, nullable, required
        - `commit_sha` string, nullable, required
        - `release_kind` 'deployment' | 'rollback' | 'hotfix', required
        - `release_command` string, nullable, required
        - `prestart_command` string, nullable, required
        - `image_digest` string, nullable, required
        - `image_reference` string, nullable, required
        - `image_repository` string, nullable, required
        - `source_commit` string, nullable, required
        - `builder_image` string, nullable, required
        - `builder_version` string, nullable, required
        - `target_platform` string, nullable, required
        - `ci_run_identity` string, nullable, required
        - `is_rollback` boolean, required
        - `rollback_target_release_id` string, nullable, required
        - `status` 'draft' | 'ready' | 'deploying' | 'active' | 'failed' | 'rolled_back', required
        - `deployment_phase` 'failed' | 'active' | 'deploying' | 'ready' | 'rolled_back' | 'unknown', required
        - `rollout_status` 'queued' | 'running' | 'succeeded' | 'failed' | 'canceled', nullable, required
        - `rollback_reason` string, nullable, required
        - `self_hosted_managed` boolean, required
        - `self_hosted_reconcile_enabled` boolean, required
        - `self_hosted_apply_enabled` boolean, required
        - `notes` string, nullable, required
        - `created_at` string, date-time, required
        - `updated_at` string, date-time, required
        - `created_at_label` string, nullable, required
        - `updated_at_label` string, nullable, required
      - `latest_rollout` AppRollout, required
        - `id` string, required
        - `organization_id` string, required
        - `app_release_id` string, required
        - `strategy` string, required
        - `status` 'queued' | 'running' | 'succeeded' | 'failed' | 'canceled', required
        - `deployment_phase` 'queued' | 'deploying' | 'active' | 'failed' | 'unknown', required
        - `auto_safe_rollout` boolean, required
        - `nomad_deployment_id` string, nullable, required
        - `nomad_eval_id` string, nullable, required
        - `target_percentage` integer, required
        - `summary` string, nullable, required
        - `started_at` string, date-time, nullable, required
        - `finished_at` string, date-time, nullable, required
        - `created_at` string, date-time, required
        - `updated_at` string, date-time, required
        - `started_at_label` string, nullable, required
        - `finished_at_label` string, nullable, required
        - `created_at_label` string, nullable, required
        - `updated_at_label` string, nullable, required
      - `runtime_instances` RuntimeInstance[], required
        - `id` string, required
        - `organization_id` string, required
        - `hosted_app_id` string, required
        - `app_environment_id` string, required
        - `app_service_id` string, required
        - `app_release_id` string, nullable, required
        - `location_id` string, required
        - `network_peer_id` string, nullable, required
        - `slug` string, required
        - `instance_key` string, required
        - `service_name` string, required: Name of the Vex service this instance runs, in the same vocabulary as `vex deploy list`. `nomad_task_name` is the scheduler's own name for the same workload.
        - `location` HostingLocation, required
          - `id` string, required
          - `code` string, required
          - `name` string, required
          - `nomad_datacenter` string, required
          - `created_at` string, date-time, required
          - `updated_at` string, date-time, required
        - `status` 'starting' | 'running' | 'degraded' | 'stopped' | 'terminated' | 'failed', required
        - `adapter_kind` 'database' | 'nomad', required
        - `provider_instance_id` string, nullable, required
        - `nomad_allocation_id` string, nullable, required
        - `nomad_task_name` string, nullable, required
        - `private_ipv4` string, nullable, required
        - `private_ipv6` string, nullable, required
        - `public_endpoint` string, nullable, required
        - `booted_at` string, date-time, nullable, required
        - `terminated_at` string, date-time, nullable, required
        - `last_seen_at` string, date-time, nullable, required
        - `last_reconciled_at` string, date-time, nullable, required
        - `created_at` string, date-time, required
        - `updated_at` string, date-time, required
        - `booted_at_label` string, nullable, required
        - `terminated_at_label` string, nullable, required
        - `last_seen_at_label` string, nullable, required
        - `last_reconciled_at_label` string, nullable, required
        - `created_at_label` string, nullable, required
        - `updated_at_label` string, nullable, required
      - `reconciler_ticks` ReconcilerTick[], required
        - `id` string, required
        - `organization_id` string, required
        - `hosted_app_id` string, nullable, required
        - `app_environment_id` string, nullable, required
        - `app_service_id` string, nullable, required
        - `kind` 'generic' | 'release' | 'runtime' | 'network' | 'health' | 'cdn', required
        - `status` 'queued' | 'running' | 'succeeded' | 'failed', required
        - `observed_version` string, nullable, required
        - `summary` string, nullable, required
        - `started_at` string, date-time, nullable, required
        - `finished_at` string, date-time, nullable, required
        - `created_at` string, date-time, required
        - `updated_at` string, date-time, required
        - `started_at_label` string, nullable, required
        - `finished_at_label` string, nullable, required
        - `created_at_label` string, nullable, required
        - `updated_at_label` string, nullable, required
      - `audit_events` AuditEvent[], required
        - `id` string, required
        - `observability_space_id` string, nullable, required
        - `organization_id` string, required
        - `actor_user_id` string, nullable, required
        - `actor_kind` 'user' | 'service' | 'system' | 'agent', required
        - `action` string, required
        - `subject_kind` string, required
        - `subject_id` string, required
        - `subject_name` string, nullable, required
        - `request_id` string, nullable, required
        - `severity` 'info' | 'notice' | 'warn' | 'error', required
        - `payload` unknown, required
        - `created_at` string, date-time, required
        - `updated_at` string, date-time, required
        - `created_at_label` string, nullable, required
        - `updated_at_label` string, nullable, required
      - `stats` EnvironmentRuntimeSummary, required
        - `desired_instances` integer, required
        - `desired_version` string, nullable, required
        - `total_instances` integer, required
        - `running_instances` integer, required
        - `degraded_instances` integer, required
        - `failed_instances` integer, required
      - `nomad` DeploymentNomadSummary, required
        - `namespace` string, required
        - `region` string, nullable, required
        - `datacenters` string[], required
        - `constraints` unknown[], required
          - unknown
        - `update_strategy` object, required
        - `deployment_channel` string, required
        - `ownership_layer` string, required
        - `managed_by_vex` boolean, required
        - `self_hosted_managed` boolean, required
        - `self_hosted_reconcile_enabled` boolean, required
        - `self_hosted_apply_enabled` boolean, required
        - `managed_service_allowlist` string[], required
        - `latest_job_id` string, nullable, required
        - `latest_job_version` integer, nullable, required
        - `latest_deployment_id` string, nullable, required
        - `latest_eval_id` string, nullable, required
        - `allocation_ids` string[], required
        - `task_names` string[], required

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `422`: Unprocessable entity
- `502`: Bad gateway

---

[API](https://skmtc.dev/composal/apis/vex-api.md) - [All operations](https://skmtc.dev/composal/apis/vex-api/llms.txt) - [OpenAPI document](https://skmtc.dev/composal/apis/vex-api/revisions/74298a24e040?raw)