v31

latestSwagger 2.0raw.githubusercontent.com2026-08-01119317529.5 KB

Core

Project-Level

Promote to Stage

Create a Promotion resource to transition a specified Stage into the state represented by the specified Freight.

post/v1beta1/projects/{project}/stages/{stage}/promotions

Path parameters

projectstring required

Project name

stagestring required

Stage name

Request body

freightstring

freightAliasstring

originstring

Origin is the canonical Freight origin key (e.g. "Warehouse/foo"). When set, the promotion webhook resolves it to the current auto-promotion candidate. Exactly one of Freight, FreightAlias, or Origin must be set.

Response

Promotion resource (github.com/akuity/kargo/api/v1alpha1.Promotion)

apiVersionstring

APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources +optional

kindstring

Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds +optional