v31

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

Core

Project-Level

Retrieve a Freight resource

Retrieve a Freight resource from a project's namespace by name or alias.

get/v1beta1/projects/{project}/freight/{freight-name-or-alias}

Path parameters

projectstring required

Project name

freight-name-or-aliasstring required

Freight name or alias

Response

Freight custom resource (github.com/akuity/kargo/api/v1alpha1.Freight)

aliasstring

Alias is a human-friendly alias for a piece of Freight. This is an optional field. A defaulting webhook will sync this field with the value of the kargo.akuity.io/alias label. When the alias label is not present or differs from the value of this field, the defaulting webhook will set the label to the value of this field. If the alias label is present and this field is empty, the defaulting webhook will set the value of this field to the value of the alias label. If this field is empty and the alias label is not present, the defaulting webhook will choose an available alias and assign it to both the field and label.

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

discoveredAtstring

DiscoveredAt is the time at which this Freight was discovered/created. A defaulting webhook initializes this to the creation time of the Freight.

+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