AKakuity
Core
Project-Level

List PromotionRollouts

Changed on

List a project's PromotionRollouts, one page at a time, as a PromotionRolloutList resource. A Project or a Stage may have had any number of rollouts, so a list is never more than one page, newest first: the Project's, or a Stage's, or a Stage's of one piece of Freight. When a page is full, the list's metadata.continue names where the next page starts; pass it as continue to read on. With after, a Stage's rollouts numbered above it are listed oldest first instead. With latest, the list is instead each Stage's latest rollouts -- the one it is promoting through, if any, and the newest that has finished, if any -- which is what a reader of a Stage's state wants without reading its history.

get/v1beta1/projects/{project}/promotion-rollouts

Request

  • Base URL
    / (relative, and the document was published on a file host, not at the API’s origin)
  • Auth
    API key in header Authorization

Path parameters

projectstring required

Project name

Query parameters

stagestring

Only PromotionRollouts of this Stage

freightstring

Only PromotionRollouts of this Freight; requires stage

latestboolean

Each Stage's latest rollouts, or the named Stage's; takes only stage besides

afterinteger

Only the Stage's PromotionRollouts numbered above this, oldest first; requires stage

continuestring

Previous page's metadata.continue; with stage, one of the Stage's; resend after

limitinteger

The page size, at most 500; 50 if omitted

Response

PromotionRolloutList resource

Changes