Query Freight

Query and filter Freight resources from a project's namespace.

get/v1beta1/projects/{project}/freight

Request

Base URL
https://docs.kargo.io
Auth
API key in header Authorization
TypeScript
https://skmtc.dev/kargo/apis/kargo-api/docs/v1beta1/projects/:project/freight/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

projectstring required

Project name

Query parameters

stagestring

Stage name to get available freight for

originsstring[]

Warehouse names to get freight from

groupstring

Group filter

groupBystring

Group by (image_repo, git_repo, chart_repo)

orderBystring

Order by (first_seen, tag)

reverseboolean

Reverse order

Response

groupsobject

resourceVersionstring

ResourceVersion is the Kubernetes list resourceVersion clients use to seed a follow-up Freight watch so the API server does not replay every existing Freight as an ADDED event. It is empty for the stage-scoped query, whose result is assembled from multiple sources rather than a single watchable namespace list.

Changes

No recorded changes to this operation across all 2 revisions of this API.