Struct BundleDeployPayload 

pub struct BundleDeployPayload {
    pub environment_id: String,
    pub bundle_id: String,
    pub customer_id: Option<String>,
    pub bundle_path: Option<PathBuf>,
    pub bundle_source_uri: Option<String>,
    pub remote_pins: Option<RemoteBundlePins>,
    pub idempotency_key: Option<String>,
    pub config_overrides: Option<BTreeMap<String, BTreeMap<String, Value>>>,
    pub route_binding: Option<RouteBindingPayload>,
    pub revenue_share: Option<Vec<RevenueShareEntryPayload>>,
}

Input to deploy. Everything but bundle_id and bundle_path has a sensible default; the CLI requires --bundle and derives bundle_id from its filename stem.

Fields

environment_id: String

bundle_id: String

customer_id: Option<String>

Billing principal (P6). Defaults to local-dev on the local env; required for every other env. Forwarded verbatim to bundles add.

bundle_path: Option<PathBuf>

Local .gtbundle to stage. Required (on every path): deploy refuses to publish an artifact-less revision. Optional in the struct only so an --answers payload that omits it fails with a clear error rather than a deserialization error.

bundle_source_uri: Option<String>

Registry reference the bundle was resolved from, recorded on the staged revision so a remote worker can pull it at boot. None (default) keeps the revision local-serve only. op deploy still stages from the local --bundle file; this only records where the worker can re-fetch it.

remote_pins: Option<RemoteBundlePins>

Caller-pinned artifact pointers, required only on the remote (--store-url) path (the local --bundle path derives them from the artifact and ignores this). See RemoteBundlePins.

idempotency_key: Option<String>

Idempotency key for the traffic cut-over. Defaults to a value derived from the freshly-minted revision id, so each deploy is a distinct (non-replay) cut-over.

config_overrides: Option<BTreeMap<String, BTreeMap<String, Value>>>

D.4: per-pack provider config overrides applied at egress time (<pack_id> -> <key> -> <json value>). Forwarded into the new BundleAddPayload.config_overrides on a fresh deploy, or applied via bundles update to the existing deployment on a re-deploy (blue-green version bump).

Three-valued semantics (Codex finding 3):

• None (default, no CLI input) = leave existing overrides untouched
• Some(empty) = explicit clear (e.g. --config-overrides-from with {})
• Some(non-empty) = replace

route_binding: Option<RouteBindingPayload>

Route binding (hosts, path prefixes, tenant selector). Set at deploy time so a fresh add doesn’t need a follow-up bundles update.

None (the default) means: on fresh add, use the default empty binding; on re-deploy, leave the existing binding untouched. Some(...) replaces the whole binding (same all-or-nothing shape as bundles update --route-binding).

revenue_share: Option<Vec<RevenueShareEntryPayload>>

Revenue-share split applied on a FRESH deploy (forwarded to bundles add). None = the greentic@10000 default. Ignored on a re-deploy (a blue-green version bump leaves the existing split untouched — change it via bundles update).

Trait Implementations

impl Clone for BundleDeployPayload

fn clone(&self) -> BundleDeployPayload

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for BundleDeployPayload

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for BundleDeployPayload

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for BundleDeployPayload

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.