Method: organizations.apis.revisions.updateApiProxyRevision

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


The URL uses gRPC Transcoding syntax.

Path parameters



Required. API proxy revision to update in the following format: organizations/{org}/apis/{api}/revisions/{rev}

Authorization requires the following IAM permission on the specified resource name:

  • apigee.proxyrevisions.update

Query parameters



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.

Authorization scopes

Requires the following OAuth scope: