@oore/client 0.16.0 → 0.18.0

package/openapi/openapi.json

@@ -2926,6 +2926,54 @@
         ]
       }
     },
+    "/v1/builds/{build_id}/sizes": {
+      "get": {
+        "tags": [
+          "Artifacts"
+        ],
+        "summary": "Get build artifact sizes",
+        "description": "Returns the size of each artifact the build published and its change\nfrom the latest earlier successful build of the same pipeline on the\nbase branch: a pull request's target branch, otherwise the project's\ndefault branch.",
+        "operationId": "get_build_size_report",
+        "parameters": [
+          {
+            "name": "build_id",
+            "in": "path",
+            "description": "Build ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Artifact sizes and changes",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/BuildSizeReport"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Build not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "bearer_auth": []
+          }
+        ]
+      }
+    },
     "/v1/builds/{build_id}/stream-token": {
       "post": {
         "tags": [
@@ -6125,13 +6173,14 @@
         ]
       }
     },
-    "/v1/projects/{project_id}/members": {
+    "/v1/projects/{project_id}/environments": {
       "get": {
         "tags": [
-          "Project Members"
+          "Environments"
         ],
-        "summary": "List project members",
-        "operationId": "list_project_members",
+        "summary": "List project environments",
+        "description": "Environments in promotion order, each with its newest release, plus pending promotions and the most recent decided ones.",
+        "operationId": "list_project_environments",
         "parameters": [
           {
             "name": "project_id",
@@ -6145,11 +6194,11 @@
         ],
         "responses": {
           "200": {
-            "description": "Member list",
+            "description": "Environments and promotions",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/ListProjectMembersResponse"
+                  "$ref": "#/components/schemas/ListProjectEnvironmentsResponse"
                 }
               }
             }
@@ -6173,10 +6222,11 @@
       },
       "post": {
         "tags": [
-          "Project Members"
+          "Environments"
         ],
-        "summary": "Add a member to a project",
-        "operationId": "add_project_member",
+        "summary": "Create environment",
+        "description": "Adds an environment at the end of the promotion path. Requires the project maintainer role. A release recorded on the environment's store and track belongs to it.",
+        "operationId": "create_project_environment",
         "parameters": [
           {
             "name": "project_id",
@@ -6192,25 +6242,35 @@
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/AddProjectMemberRequest"
+                "$ref": "#/components/schemas/CreateProjectEnvironmentRequest"
               }
             }
           },
           "required": true
         },
         "responses": {
-          "201": {
-            "description": "Member added",
+          "200": {
+            "description": "Created environment",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/AddProjectMemberResponse"
+                  "$ref": "#/components/schemas/ProjectEnvironment"
                 }
               }
             }
           },
           "400": {
-            "description": "Invalid user or user already has implicit access",
+            "description": "Invalid input",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Permission denied",
             "content": {
               "application/json": {
                 "schema": {
@@ -6230,7 +6290,7 @@
             }
           },
           "409": {
-            "description": "User is already a member",
+            "description": "Key, or store and track, already used",
             "content": {
               "application/json": {
                 "schema": {
@@ -6247,13 +6307,14 @@
         ]
       }
     },
-    "/v1/projects/{project_id}/members/candidates": {
-      "get": {
+    "/v1/projects/{project_id}/environments/{environment_id}": {
+      "delete": {
         "tags": [
-          "Project Members"
+          "Environments"
         ],
-        "summary": "List eligible project member candidates",
-        "operationId": "list_project_member_candidates",
+        "summary": "Delete environment",
+        "description": "Its releases stay without an environment; its promotions are removed. Requires the project maintainer role.",
+        "operationId": "delete_project_environment",
         "parameters": [
           {
             "name": "project_id",
@@ -6263,21 +6324,30 @@
             "schema": {
               "type": "string"
             }
+          },
+          {
+            "name": "environment_id",
+            "in": "path",
+            "description": "Environment ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
           }
         ],
         "responses": {
           "200": {
-            "description": "Eligible member candidates",
+            "description": "Deleted",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/ListProjectMemberCandidatesResponse"
+                  "$ref": "#/components/schemas/OkResponse"
                 }
               }
             }
           },
           "403": {
-            "description": "Manage Members permission required",
+            "description": "Permission denied",
             "content": {
               "application/json": {
                 "schema": {
@@ -6287,7 +6357,17 @@
             }
           },
           "404": {
-            "description": "Project not found",
+            "description": "Not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "A promotion is in progress",
             "content": {
               "application/json": {
                 "schema": {
@@ -6302,15 +6382,14 @@
             "bearer_auth": []
           }
         ]
-      }
-    },
-    "/v1/projects/{project_id}/members/{user_id}": {
-      "delete": {
+      },
+      "patch": {
         "tags": [
-          "Project Members"
+          "Environments"
         ],
-        "summary": "Remove a member from a project",
-        "operationId": "remove_project_member",
+        "summary": "Update environment",
+        "description": "Changes the name, track, approval rule, rollout policy or position. Requires the project maintainer role.",
+        "operationId": "update_project_environment",
         "parameters": [
           {
             "name": "project_id",
@@ -6322,28 +6401,68 @@
             }
           },
           {
-            "name": "user_id",
+            "name": "environment_id",
             "in": "path",
-            "description": "User ID",
+            "description": "Environment ID",
             "required": true,
             "schema": {
               "type": "string"
             }
           }
         ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/UpdateProjectEnvironmentRequest"
+              }
+            }
+          },
+          "required": true
+        },
         "responses": {
           "200": {
-            "description": "Member removed",
+            "description": "Updated environment",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/RemoveProjectMemberResponse"
+                  "$ref": "#/components/schemas/ProjectEnvironment"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid input",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Permission denied",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
                 }
               }
             }
           },
           "404": {
-            "description": "Project or member not found",
+            "description": "Not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "Store and track already used",
             "content": {
               "application/json": {
                 "schema": {
@@ -6358,13 +6477,15 @@
             "bearer_auth": []
           }
         ]
-      },
-      "patch": {
+      }
+    },
+    "/v1/projects/{project_id}/members": {
+      "get": {
         "tags": [
           "Project Members"
         ],
-        "summary": "Update a project member's role",
-        "operationId": "update_project_member",
+        "summary": "List project members",
+        "operationId": "list_project_members",
         "parameters": [
           {
             "name": "project_id",
@@ -6374,11 +6495,47 @@
             "schema": {
               "type": "string"
             }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Member list",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ListProjectMembersResponse"
+                }
+              }
+            }
           },
+          "404": {
+            "description": "Project not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          }
+        },
+        "security": [
           {
-            "name": "user_id",
+            "bearer_auth": []
+          }
+        ]
+      },
+      "post": {
+        "tags": [
+          "Project Members"
+        ],
+        "summary": "Add a member to a project",
+        "operationId": "add_project_member",
+        "parameters": [
+          {
+            "name": "project_id",
             "in": "path",
-            "description": "User ID",
+            "description": "Project ID",
             "required": true,
             "schema": {
               "type": "string"
@@ -6389,25 +6546,563 @@
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/UpdateProjectMemberRequest"
+                "$ref": "#/components/schemas/AddProjectMemberRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "201": {
+            "description": "Member added",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/AddProjectMemberResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid user or user already has implicit access",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Project not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "User is already a member",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "bearer_auth": []
+          }
+        ]
+      }
+    },
+    "/v1/projects/{project_id}/members/candidates": {
+      "get": {
+        "tags": [
+          "Project Members"
+        ],
+        "summary": "List eligible project member candidates",
+        "operationId": "list_project_member_candidates",
+        "parameters": [
+          {
+            "name": "project_id",
+            "in": "path",
+            "description": "Project ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Eligible member candidates",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ListProjectMemberCandidatesResponse"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Manage Members permission required",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Project not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "bearer_auth": []
+          }
+        ]
+      }
+    },
+    "/v1/projects/{project_id}/members/{user_id}": {
+      "delete": {
+        "tags": [
+          "Project Members"
+        ],
+        "summary": "Remove a member from a project",
+        "operationId": "remove_project_member",
+        "parameters": [
+          {
+            "name": "project_id",
+            "in": "path",
+            "description": "Project ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "user_id",
+            "in": "path",
+            "description": "User ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Member removed",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/RemoveProjectMemberResponse"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Project or member not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "bearer_auth": []
+          }
+        ]
+      },
+      "patch": {
+        "tags": [
+          "Project Members"
+        ],
+        "summary": "Update a project member's role",
+        "operationId": "update_project_member",
+        "parameters": [
+          {
+            "name": "project_id",
+            "in": "path",
+            "description": "Project ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "user_id",
+            "in": "path",
+            "description": "User ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/UpdateProjectMemberRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Member role updated",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/UpdateProjectMemberResponse"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Project or member not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "bearer_auth": []
+          }
+        ]
+      }
+    },
+    "/v1/projects/{project_id}/pipelines": {
+      "get": {
+        "tags": [
+          "Pipelines"
+        ],
+        "summary": "List pipelines",
+        "operationId": "list_pipelines",
+        "parameters": [
+          {
+            "name": "project_id",
+            "in": "path",
+            "description": "Project ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "search",
+            "in": "query",
+            "description": "Case-insensitive pipeline name search",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "sort",
+            "in": "query",
+            "description": "Sort by created_at or name",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "direction",
+            "in": "query",
+            "description": "Sort direction: asc or desc",
+            "required": false,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "limit",
+            "in": "query",
+            "description": "Page size",
+            "required": false,
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            }
+          },
+          {
+            "name": "offset",
+            "in": "query",
+            "description": "Page offset",
+            "required": false,
+            "schema": {
+              "type": "integer",
+              "format": "int64"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Pipeline list",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ListPipelinesResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid sort or direction",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "bearer_auth": []
+          }
+        ]
+      },
+      "post": {
+        "tags": [
+          "Pipelines"
+        ],
+        "summary": "Create pipeline",
+        "operationId": "create_pipeline",
+        "parameters": [
+          {
+            "name": "project_id",
+            "in": "path",
+            "description": "Project ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CreatePipelineRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "201": {
+            "description": "Pipeline created",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CreatePipelineResponse"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Invalid input",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "bearer_auth": []
+          }
+        ]
+      }
+    },
+    "/v1/projects/{project_id}/promotions": {
+      "post": {
+        "tags": [
+          "Environments"
+        ],
+        "summary": "Promote build",
+        "description": "Puts the version a build's live Google Play release already uploaded on the environment's track and records a release with the environment's rollout policy. Nothing is rebuilt. Promoting straight in requires the maintainer role; when the environment requires approval, a developer may ask and the promotion waits as `pending` without touching the store. Writes an audit log entry.",
+        "operationId": "promote_build",
+        "parameters": [
+          {
+            "name": "project_id",
+            "in": "path",
+            "description": "Project ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CreatePromotionRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "The promotion, completed or pending",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/EnvironmentPromotion"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Permission denied",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Project, environment or build not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "Already in the environment, pending, unsupported store, or no live release to promote",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          },
+          "502": {
+            "description": "The store rejected the promotion",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "bearer_auth": []
+          }
+        ]
+      }
+    },
+    "/v1/projects/{project_id}/promotions/{promotion_id}/approve": {
+      "post": {
+        "tags": [
+          "Environments"
+        ],
+        "summary": "Approve promotion",
+        "description": "Approves a pending promotion and makes the store change as the approver. Requires the maintainer role. Writes an audit log entry.",
+        "operationId": "approve_promotion",
+        "parameters": [
+          {
+            "name": "project_id",
+            "in": "path",
+            "description": "Project ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "promotion_id",
+            "in": "path",
+            "description": "Promotion ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "description": "Optional reason",
+          "content": {
+            "application/json": {
+              "schema": {
+                "oneOf": [
+                  {
+                    "type": "null"
+                  },
+                  {
+                    "$ref": "#/components/schemas/PromotionDecisionRequest"
+                  }
+                ]
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Completed promotion",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/EnvironmentPromotion"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Permission denied",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
               }
             }
           },
-          "required": true
-        },
-        "responses": {
-          "200": {
-            "description": "Member role updated",
+          "409": {
+            "description": "Not pending, or the build changed while it waited",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/UpdateProjectMemberResponse"
+                  "$ref": "#/components/schemas/ApiError"
                 }
               }
             }
           },
-          "404": {
-            "description": "Project or member not found",
+          "502": {
+            "description": "The store rejected the promotion",
             "content": {
               "application/json": {
                 "schema": {
@@ -6424,13 +7119,14 @@
         ]
       }
     },
-    "/v1/projects/{project_id}/pipelines": {
-      "get": {
+    "/v1/projects/{project_id}/promotions/{promotion_id}/reject": {
+      "post": {
         "tags": [
-          "Pipelines"
+          "Environments"
         ],
-        "summary": "List pipelines",
-        "operationId": "list_pipelines",
+        "summary": "Reject promotion",
+        "description": "Rejects a pending promotion; nothing changes at the store. Requires the maintainer role. Writes an audit log entry.",
+        "operationId": "reject_promotion",
         "parameters": [
           {
             "name": "project_id",
@@ -6442,66 +7138,45 @@
             }
           },
           {
-            "name": "search",
-            "in": "query",
-            "description": "Case-insensitive pipeline name search",
-            "required": false,
-            "schema": {
-              "type": "string"
-            }
-          },
-          {
-            "name": "sort",
-            "in": "query",
-            "description": "Sort by created_at or name",
-            "required": false,
-            "schema": {
-              "type": "string"
-            }
-          },
-          {
-            "name": "direction",
-            "in": "query",
-            "description": "Sort direction: asc or desc",
-            "required": false,
+            "name": "promotion_id",
+            "in": "path",
+            "description": "Promotion ID",
+            "required": true,
             "schema": {
               "type": "string"
             }
-          },
-          {
-            "name": "limit",
-            "in": "query",
-            "description": "Page size",
-            "required": false,
-            "schema": {
-              "type": "integer",
-              "format": "int64"
-            }
-          },
-          {
-            "name": "offset",
-            "in": "query",
-            "description": "Page offset",
-            "required": false,
-            "schema": {
-              "type": "integer",
-              "format": "int64"
-            }
           }
         ],
+        "requestBody": {
+          "description": "Optional reason",
+          "content": {
+            "application/json": {
+              "schema": {
+                "oneOf": [
+                  {
+                    "type": "null"
+                  },
+                  {
+                    "$ref": "#/components/schemas/PromotionDecisionRequest"
+                  }
+                ]
+              }
+            }
+          }
+        },
         "responses": {
           "200": {
-            "description": "Pipeline list",
+            "description": "Rejected promotion",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/ListPipelinesResponse"
+                  "$ref": "#/components/schemas/EnvironmentPromotion"
                 }
               }
             }
           },
-          "400": {
-            "description": "Invalid sort or direction",
+          "403": {
+            "description": "Permission denied",
             "content": {
               "application/json": {
                 "schema": {
@@ -6509,54 +7184,19 @@
                 }
               }
             }
-          }
-        },
-        "security": [
-          {
-            "bearer_auth": []
-          }
-        ]
-      },
-      "post": {
-        "tags": [
-          "Pipelines"
-        ],
-        "summary": "Create pipeline",
-        "operationId": "create_pipeline",
-        "parameters": [
-          {
-            "name": "project_id",
-            "in": "path",
-            "description": "Project ID",
-            "required": true,
-            "schema": {
-              "type": "string"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/CreatePipelineRequest"
-              }
-            }
           },
-          "required": true
-        },
-        "responses": {
-          "201": {
-            "description": "Pipeline created",
+          "404": {
+            "description": "Not found",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/CreatePipelineResponse"
+                  "$ref": "#/components/schemas/ApiError"
                 }
               }
             }
           },
-          "400": {
-            "description": "Invalid input",
+          "409": {
+            "description": "Not pending",
             "content": {
               "application/json": {
                 "schema": {
@@ -12908,6 +13548,53 @@
           "ios"
         ]
       },
+      "ArtifactSizeComparison": {
+        "type": "object",
+        "description": "One artifact's size, and its change from the matching baseline artifact.",
+        "required": [
+          "artifact_id",
+          "name",
+          "artifact_type",
+          "size_bytes"
+        ],
+        "properties": {
+          "artifact_id": {
+            "type": "string"
+          },
+          "artifact_type": {
+            "$ref": "#/components/schemas/ArtifactType"
+          },
+          "baseline_name": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "Name of the baseline artifact this one was matched with."
+          },
+          "baseline_size_bytes": {
+            "type": [
+              "integer",
+              "null"
+            ],
+            "format": "int64"
+          },
+          "delta_bytes": {
+            "type": [
+              "integer",
+              "null"
+            ],
+            "format": "int64",
+            "description": "`size_bytes - baseline_size_bytes`; absent when nothing matched."
+          },
+          "name": {
+            "type": "string"
+          },
+          "size_bytes": {
+            "type": "integer",
+            "format": "int64"
+          }
+        }
+      },
       "ArtifactStorageProvider": {
         "type": "string",
         "enum": [
@@ -13879,6 +14566,59 @@
           }
         }
       },
+      "BuildSizeBaseline": {
+        "type": "object",
+        "description": "The earlier build a size report compares against.",
+        "required": [
+          "build_id",
+          "build_number",
+          "branch"
+        ],
+        "properties": {
+          "branch": {
+            "type": "string"
+          },
+          "build_id": {
+            "type": "string"
+          },
+          "build_number": {
+            "type": "integer",
+            "format": "int64"
+          }
+        }
+      },
+      "BuildSizeReport": {
+        "type": "object",
+        "required": [
+          "artifacts"
+        ],
+        "properties": {
+          "artifacts": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ArtifactSizeComparison"
+            }
+          },
+          "base_branch": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "Branch the build is compared with: a pull request's target branch,\notherwise the project's default branch. Absent when neither is known."
+          },
+          "baseline": {
+            "oneOf": [
+              {
+                "type": "null"
+              },
+              {
+                "$ref": "#/components/schemas/BuildSizeBaseline",
+                "description": "The latest earlier successful build of the same pipeline on\n`base_branch` that recorded artifact sizes."
+              }
+            ]
+          }
+        }
+      },
       "BuildStatus": {
         "type": "string",
         "enum": [
@@ -14603,6 +15343,43 @@
           }
         }
       },
+      "CreateProjectEnvironmentRequest": {
+        "type": "object",
+        "required": [
+          "key",
+          "name",
+          "store",
+          "track"
+        ],
+        "properties": {
+          "approval_required": {
+            "type": "boolean"
+          },
+          "key": {
+            "type": "string"
+          },
+          "name": {
+            "type": "string"
+          },
+          "rollout_policy": {
+            "oneOf": [
+              {
+                "type": "null"
+              },
+              {
+                "$ref": "#/components/schemas/ReleasePolicy",
+                "description": "Defaults to the standard schedule with no crash-rate halt."
+              }
+            ]
+          },
+          "store": {
+            "$ref": "#/components/schemas/ReleaseStore"
+          },
+          "track": {
+            "type": "string"
+          }
+        }
+      },
       "CreateProjectRequest": {
         "type": "object",
         "required": [
@@ -14649,6 +15426,28 @@
           }
         }
       },
+      "CreatePromotionRequest": {
+        "type": "object",
+        "required": [
+          "build_id",
+          "environment_id"
+        ],
+        "properties": {
+          "build_id": {
+            "type": "string"
+          },
+          "environment_id": {
+            "type": "string",
+            "description": "The environment to promote into."
+          },
+          "reason": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        }
+      },
       "CreateReleaseRequest": {
         "type": "object",
         "required": [
@@ -14889,6 +15688,134 @@
           }
         }
       },
+      "EnvironmentPromotion": {
+        "type": "object",
+        "description": "A request to put an existing build into an environment.",
+        "required": [
+          "id",
+          "project_id",
+          "build_id",
+          "environment_id",
+          "environment_name",
+          "source_release_id",
+          "source_track",
+          "state",
+          "can_decide",
+          "created_at",
+          "updated_at"
+        ],
+        "properties": {
+          "build_id": {
+            "type": "string"
+          },
+          "build_number": {
+            "type": [
+              "integer",
+              "null"
+            ],
+            "format": "int64"
+          },
+          "can_decide": {
+            "type": "boolean",
+            "description": "Whether the caller may approve or reject this promotion now."
+          },
+          "created_at": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "decided_at": {
+            "type": [
+              "integer",
+              "null"
+            ],
+            "format": "int64"
+          },
+          "decided_by_email": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "decision_reason": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "environment_id": {
+            "type": "string"
+          },
+          "environment_name": {
+            "type": "string"
+          },
+          "error": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "Why the promotion failed."
+          },
+          "id": {
+            "type": "string"
+          },
+          "project_id": {
+            "type": "string"
+          },
+          "reason": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "release_id": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "The release the promotion created, once completed."
+          },
+          "requested_by_email": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source_environment_name": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "Where the source release was, when it belongs to an environment."
+          },
+          "source_release_id": {
+            "type": "string",
+            "description": "The release the build is promoted from."
+          },
+          "source_track": {
+            "type": "string"
+          },
+          "state": {
+            "$ref": "#/components/schemas/PromotionState"
+          },
+          "updated_at": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "version_code": {
+            "type": [
+              "integer",
+              "null"
+            ],
+            "format": "int64"
+          },
+          "version_name": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        }
+      },
       "EventStreamReady": {
         "type": "object",
         "description": "`ready` event, the first event on every `GET /v1/events` connection.\nClients refetch once on `ready` after a reconnect, since events sent while\ndisconnected are not replayed.",
@@ -16196,6 +17123,29 @@
           }
         }
       },
+      "ListProjectEnvironmentsResponse": {
+        "type": "object",
+        "required": [
+          "environments",
+          "promotions"
+        ],
+        "properties": {
+          "environments": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ProjectEnvironment"
+            },
+            "description": "Environments in promotion order."
+          },
+          "promotions": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/EnvironmentPromotion"
+            },
+            "description": "Pending promotions and the most recent decided ones, newest first."
+          }
+        }
+      },
       "ListProjectMemberCandidatesResponse": {
         "type": "object",
         "required": [
@@ -17396,6 +18346,82 @@
           }
         }
       },
+      "ProjectEnvironment": {
+        "type": "object",
+        "description": "A release environment on a project, such as `internal` or `production`,\nwith its store target, rollout policy and approval rule.",
+        "required": [
+          "id",
+          "project_id",
+          "key",
+          "name",
+          "position",
+          "store",
+          "track",
+          "approval_required",
+          "rollout_policy",
+          "promotable",
+          "created_at",
+          "updated_at"
+        ],
+        "properties": {
+          "approval_required": {
+            "type": "boolean",
+            "description": "A promotion into this environment waits for a maintainer's approval\nbefore anything changes at the store."
+          },
+          "created_at": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "id": {
+            "type": "string"
+          },
+          "key": {
+            "type": "string",
+            "description": "Stable identifier, unique in the project: lowercase letters, digits\nand dashes, starting with a letter."
+          },
+          "latest_release": {
+            "oneOf": [
+              {
+                "type": "null"
+              },
+              {
+                "$ref": "#/components/schemas/Release",
+                "description": "The newest release in this environment."
+              }
+            ]
+          },
+          "name": {
+            "type": "string"
+          },
+          "position": {
+            "type": "integer",
+            "format": "int64",
+            "description": "Order on the promotion path, lowest first."
+          },
+          "project_id": {
+            "type": "string"
+          },
+          "promotable": {
+            "type": "boolean",
+            "description": "Whether builds can be promoted into this environment. App Store\nenvironments only group the releases that uploads record for now."
+          },
+          "rollout_policy": {
+            "$ref": "#/components/schemas/ReleasePolicy",
+            "description": "Staged rollout policy for releases promoted into this environment.\nIts `approval` is always `none`; use `approval_required`."
+          },
+          "store": {
+            "$ref": "#/components/schemas/ReleaseStore"
+          },
+          "track": {
+            "type": "string",
+            "description": "Play track (`internal`, `closed`, `open`, `production` or a custom\ntrack), or the App Store release track a store upload records."
+          },
+          "updated_at": {
+            "type": "integer",
+            "format": "int64"
+          }
+        }
+      },
       "ProjectMember": {
         "type": "object",
         "required": [
@@ -17557,6 +18583,27 @@
           "viewer"
         ]
       },
+      "PromotionDecisionRequest": {
+        "type": "object",
+        "properties": {
+          "reason": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        }
+      },
+      "PromotionState": {
+        "type": "string",
+        "enum": [
+          "pending",
+          "promoting",
+          "completed",
+          "rejected",
+          "failed"
+        ]
+      },
       "PublishStore": {
         "type": "string",
         "enum": [
@@ -17805,6 +18852,19 @@
             "type": "integer",
             "format": "int64"
           },
+          "environment_id": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "The project environment this release belongs to. Absent for projects\nwithout environments."
+          },
+          "environment_name": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
           "health": {
             "$ref": "#/components/schemas/ReleaseHealth"
           },
@@ -17847,6 +18907,13 @@
               "null"
             ]
           },
+          "promoted_from_release_id": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "The release this one was promoted from, without a new build."
+          },
           "rollout_fraction": {
             "type": "number",
             "format": "double",
@@ -20662,6 +21729,47 @@
           }
         }
       },
+      "UpdateProjectEnvironmentRequest": {
+        "type": "object",
+        "description": "Changes to an environment. The key and store are fixed once created.",
+        "properties": {
+          "approval_required": {
+            "type": [
+              "boolean",
+              "null"
+            ]
+          },
+          "name": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "position": {
+            "type": [
+              "integer",
+              "null"
+            ],
+            "format": "int64"
+          },
+          "rollout_policy": {
+            "oneOf": [
+              {
+                "type": "null"
+              },
+              {
+                "$ref": "#/components/schemas/ReleasePolicy"
+              }
+            ]
+          },
+          "track": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        }
+      },
       "UpdateProjectMemberRequest": {
         "type": "object",
         "required": [
@@ -21231,6 +22339,10 @@
       "name": "Releases",
       "description": "Store releases — staged rollout records with pause, halt, resume, complete and approval."
     },
+    {
+      "name": "Environments",
+      "description": "Release environments on a project, such as internal, beta and production, and promotion of a build between them without a new build."
+    },
     {
       "name": "Runners",
       "description": "Build runner management — register, heartbeat, job claim/status."