Updates an existing API proxy revision by uploading the API proxy configuration bundle as a zip file from your local machine.
You can update only API proxy revisions that have never been deployed. After deployment, an API proxy revision becomes immutable, even if it is undeployed.
Set the Content-Type header to either multipart/form-data or application/octet-stream.
HTTP request
POST https://apigee.googleapis.com/v1/{name=organizations/*/apis/*/revisions/*}
Required. API proxy revision to update in the following format: organizations/{org}/apis/{api}/revisions/{rev}
If the API Proxy resource has the space attribute set, IAM permissions are checked against the Space resource path. To learn more, read the Apigee Spaces Overview.
Authorization requires the following IAM permission on the specified resource name:
apigee.proxyrevisions.update
Query parameters
Parameters
validate
boolean
Ignored. All uploads are validated regardless of the value of this field. Maintained for compatibility with Apigee Edge API.
Request body
The request body contains an instance of HttpBody.
Response body
If successful, the response body contains an instance of ApiProxyRevision.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-20 UTC."],[[["\u003cp\u003eThis API endpoint allows updating an existing, undeployed API proxy revision by uploading a zipped configuration bundle.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ename\u003c/code\u003e path parameter is required, specifying the exact API proxy revision to update using the format: \u003ccode\u003eorganizations/{org}/apis/{api}/revisions/{rev}\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request must include either \u003ccode\u003emultipart/form-data\u003c/code\u003e or \u003ccode\u003eapplication/octet-stream\u003c/code\u003e in the \u003ccode\u003eContent-Type\u003c/code\u003e header.\u003c/p\u003e\n"],["\u003cp\u003eThe API request is a POST operation to the specified URL, following gRPC Transcoding syntax, and it involves an HttpBody in the request.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful updates will return an \u003ccode\u003eApiProxyRevision\u003c/code\u003e instance, and authorization requires the \u003ccode\u003eapigee.proxyrevisions.update\u003c/code\u003e IAM permission and the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,[]]
