@oore/client 0.15.0 → 0.17.0

package/openapi/openapi.json

@@ -2354,6 +2354,237 @@
         ]
       }
     },
+    "/v1/builds/{build_id}/feedback": {
+      "get": {
+        "tags": [
+          "Builds"
+        ],
+        "summary": "List build feedback",
+        "description": "Notes testers sent about this build, oldest first. Needs read access\nto the build's project.",
+        "operationId": "list_build_feedback",
+        "parameters": [
+          {
+            "name": "build_id",
+            "in": "path",
+            "description": "Build ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Feedback for the build",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ListBuildFeedbackResponse"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Build not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "bearer_auth": []
+          }
+        ]
+      },
+      "post": {
+        "tags": [
+          "Builds"
+        ],
+        "summary": "Send build feedback",
+        "description": "Files a tester's note against a build, with optional device, OS\nversion, app version and a PNG, JPEG or WebP screenshot of up to\n5 MiB. Anyone who can install the build's artifacts can send one. The\nnote shows on the build's timeline and is sent to the project's\nnotification channels as a `qa_feedback` event. Each person can send\n10 notes per 10 minutes.",
+        "operationId": "create_build_feedback",
+        "parameters": [
+          {
+            "name": "build_id",
+            "in": "path",
+            "description": "Build ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CreateBuildFeedbackRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "201": {
+            "description": "Feedback recorded",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/BuildFeedback"
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "Missing message, a field too long, or an artifact from another build",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Permission denied",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Build not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "A screenshot was attached but artifact storage is not configured",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          },
+          "413": {
+            "description": "Screenshot larger than 5 MiB",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          },
+          "415": {
+            "description": "Screenshot is not a PNG, JPEG or WebP image",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          },
+          "429": {
+            "description": "Too much feedback sent recently",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "bearer_auth": []
+          }
+        ]
+      }
+    },
+    "/v1/builds/{build_id}/feedback/{feedback_id}/screenshot": {
+      "get": {
+        "tags": [
+          "Builds"
+        ],
+        "summary": "Get a build feedback screenshot",
+        "description": "Returns the screenshot attached to a feedback note, with the image\ntype detected from its bytes. Needs read access to the build's project.",
+        "operationId": "get_build_feedback_screenshot",
+        "parameters": [
+          {
+            "name": "build_id",
+            "in": "path",
+            "description": "Build ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "feedback_id",
+            "in": "path",
+            "description": "Feedback ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Screenshot image",
+            "content": {
+              "image/*": {
+                "schema": {
+                  "$ref": "#/components/schemas/BinaryPayload"
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Build, feedback or screenshot not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "The screenshot could not be read from artifact storage",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "bearer_auth": []
+          }
+        ]
+      }
+    },
     "/v1/builds/{build_id}/logs": {
       "get": {
         "tags": [
@@ -5894,13 +6125,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",
@@ -5914,11 +6146,11 @@
         ],
         "responses": {
           "200": {
-            "description": "Member list",
+            "description": "Environments and promotions",
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/ListProjectMembersResponse"
+                  "$ref": "#/components/schemas/ListProjectEnvironmentsResponse"
                 }
               }
             }
@@ -5942,10 +6174,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",
@@ -5961,25 +6194,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": {
@@ -5999,7 +6242,7 @@
             }
           },
           "409": {
-            "description": "User is already a member",
+            "description": "Key, or store and track, already used",
             "content": {
               "application/json": {
                 "schema": {
@@ -6016,13 +6259,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",
@@ -6032,21 +6276,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": {
@@ -6056,7 +6309,7 @@
             }
           },
           "404": {
-            "description": "Project not found",
+            "description": "Not found",
             "content": {
               "application/json": {
                 "schema": {
@@ -6064,10 +6317,294 @@
                 }
               }
             }
-          }
-        },
-        "security": [
-          {
+          },
+          "409": {
+            "description": "A promotion is in progress",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "bearer_auth": []
+          }
+        ]
+      },
+      "patch": {
+        "tags": [
+          "Environments"
+        ],
+        "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",
+            "in": "path",
+            "description": "Project ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "environment_id",
+            "in": "path",
+            "description": "Environment ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/UpdateProjectEnvironmentRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "description": "Updated environment",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$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": "Not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "Store and track already used",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "bearer_auth": []
+          }
+        ]
+      }
+    },
+    "/v1/projects/{project_id}/members": {
+      "get": {
+        "tags": [
+          "Project Members"
+        ],
+        "summary": "List project members",
+        "operationId": "list_project_members",
+        "parameters": [
+          {
+            "name": "project_id",
+            "in": "path",
+            "description": "Project ID",
+            "required": true,
+            "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": [
+          {
+            "bearer_auth": []
+          }
+        ]
+      },
+      "post": {
+        "tags": [
+          "Project Members"
+        ],
+        "summary": "Add a member to a project",
+        "operationId": "add_project_member",
+        "parameters": [
+          {
+            "name": "project_id",
+            "in": "path",
+            "description": "Project ID",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$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": []
           }
         ]
@@ -6342,6 +6879,292 @@
         ]
       }
     },
+    "/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"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "Not pending, or the build changed while it waited",
+            "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}/reject": {
+      "post": {
+        "tags": [
+          "Environments"
+        ],
+        "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",
+            "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": "Rejected 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"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "Not pending",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ApiError"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "bearer_auth": []
+          }
+        ]
+      }
+    },
     "/v1/projects/{project_id}/repository-workflows": {
       "get": {
         "tags": [
@@ -13332,6 +14155,70 @@
           }
         }
       },
+      "BuildFeedback": {
+        "type": "object",
+        "required": [
+          "id",
+          "build_id",
+          "author_email",
+          "message",
+          "has_screenshot",
+          "created_at"
+        ],
+        "properties": {
+          "app_version": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "artifact_id": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "author_email": {
+            "type": "string",
+            "description": "Email of the person who sent it."
+          },
+          "author_name": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "build_id": {
+            "type": "string"
+          },
+          "created_at": {
+            "type": "integer",
+            "format": "int64"
+          },
+          "device": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "has_screenshot": {
+            "type": "boolean",
+            "description": "Fetch it from `GET /v1/builds/{build_id}/feedback/{feedback_id}/screenshot`."
+          },
+          "id": {
+            "type": "string"
+          },
+          "message": {
+            "type": "string"
+          },
+          "os_version": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        }
+      },
       "BuildInsightsDay": {
         "type": "object",
         "description": "One day of finished builds, in the caller's UTC offset.",
@@ -14027,6 +14914,53 @@
           }
         }
       },
+      "CreateBuildFeedbackRequest": {
+        "type": "object",
+        "required": [
+          "message"
+        ],
+        "properties": {
+          "app_version": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "App version the tester installed, such as `2.4.0+118`."
+          },
+          "artifact_id": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "The build's artifact the tester installed. Must belong to this build."
+          },
+          "device": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "Device model, such as `Pixel 8` or `iPhone`."
+          },
+          "message": {
+            "type": "string",
+            "description": "What the tester saw. 1 to 4000 characters."
+          },
+          "os_version": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "Operating system and version, such as `Android 15` or `iOS 18.1`."
+          },
+          "screenshot_base64": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "Optional PNG, JPEG or WebP screenshot, base64 encoded, at most 5 MiB\ndecoded. Requires artifact storage."
+          }
+        }
+      },
       "CreateBuildRequest": {
         "type": "object",
         "required": [
@@ -14261,6 +15195,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": [
@@ -14307,6 +15278,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": [
@@ -14475,74 +15468,202 @@
           "project_id": {
             "type": "string"
           },
-          "provider": {
-            "$ref": "#/components/schemas/ScmProvider"
+          "provider": {
+            "$ref": "#/components/schemas/ScmProvider"
+          },
+          "reference": {
+            "type": "string",
+            "description": "Branch, tag, or commit requested for discovery."
+          },
+          "truncated": {
+            "type": "boolean",
+            "description": "True when more matching files existed than the bounded response could inspect."
+          },
+          "workflows": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/RepositoryWorkflowPreview"
+            }
+          }
+        }
+      },
+      "DurationPercentiles": {
+        "type": "object",
+        "description": "Median and 90th percentile of a duration, in seconds.",
+        "required": [
+          "samples"
+        ],
+        "properties": {
+          "p50_seconds": {
+            "type": [
+              "integer",
+              "null"
+            ],
+            "format": "int64"
+          },
+          "p90_seconds": {
+            "type": [
+              "integer",
+              "null"
+            ],
+            "format": "int64"
+          },
+          "samples": {
+            "type": "integer",
+            "format": "int64",
+            "description": "Builds the percentiles cover."
+          }
+        }
+      },
+      "EffectiveProjectRetentionResponse": {
+        "type": "object",
+        "required": [
+          "effective",
+          "has_override"
+        ],
+        "properties": {
+          "effective": {
+            "$ref": "#/components/schemas/RetentionPolicy"
+          },
+          "has_override": {
+            "type": "boolean"
+          },
+          "override_fields": {
+            "oneOf": [
+              {
+                "type": "null"
+              },
+              {
+                "$ref": "#/components/schemas/ProjectRetentionOverride"
+              }
+            ]
+          }
+        }
+      },
+      "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"
+            ]
           },
-          "reference": {
-            "type": "string",
-            "description": "Branch, tag, or commit requested for discovery."
+          "release_id": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "The release the promotion created, once completed."
           },
-          "truncated": {
-            "type": "boolean",
-            "description": "True when more matching files existed than the bounded response could inspect."
+          "requested_by_email": {
+            "type": [
+              "string",
+              "null"
+            ]
           },
-          "workflows": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/RepositoryWorkflowPreview"
-            }
-          }
-        }
-      },
-      "DurationPercentiles": {
-        "type": "object",
-        "description": "Median and 90th percentile of a duration, in seconds.",
-        "required": [
-          "samples"
-        ],
-        "properties": {
-          "p50_seconds": {
+          "source_environment_name": {
             "type": [
-              "integer",
+              "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"
           },
-          "p90_seconds": {
+          "version_code": {
             "type": [
               "integer",
               "null"
             ],
             "format": "int64"
           },
-          "samples": {
-            "type": "integer",
-            "format": "int64",
-            "description": "Builds the percentiles cover."
-          }
-        }
-      },
-      "EffectiveProjectRetentionResponse": {
-        "type": "object",
-        "required": [
-          "effective",
-          "has_override"
-        ],
-        "properties": {
-          "effective": {
-            "$ref": "#/components/schemas/RetentionPolicy"
-          },
-          "has_override": {
-            "type": "boolean"
-          },
-          "override_fields": {
-            "oneOf": [
-              {
-                "type": "null"
-              },
-              {
-                "$ref": "#/components/schemas/ProjectRetentionOverride"
-              }
+          "version_name": {
+            "type": [
+              "string",
+              "null"
             ]
           }
         }
@@ -15693,6 +16814,21 @@
           }
         }
       },
+      "ListBuildFeedbackResponse": {
+        "type": "object",
+        "required": [
+          "feedback"
+        ],
+        "properties": {
+          "feedback": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/BuildFeedback"
+            },
+            "description": "Oldest first."
+          }
+        }
+      },
       "ListBuildsResponse": {
         "type": "object",
         "required": [
@@ -15839,6 +16975,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": [
@@ -17039,6 +18198,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": [
@@ -17200,6 +18435,27 @@
           "viewer"
         ]
       },
+      "PromotionDecisionRequest": {
+        "type": "object",
+        "properties": {
+          "reason": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        }
+      },
+      "PromotionState": {
+        "type": "string",
+        "enum": [
+          "pending",
+          "promoting",
+          "completed",
+          "rejected",
+          "failed"
+        ]
+      },
       "PublishStore": {
         "type": "string",
         "enum": [
@@ -17448,6 +18704,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"
           },
@@ -17490,6 +18759,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",
@@ -20305,6 +21581,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": [
@@ -20874,6 +22191,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."