If another revision of the same shared flow is currently deployed, set the override parameter to true to have this revision replace the currently deployed revision.
You cannot use a shared flow until it has been deployed to an environment.
For a request path organizations/{org}/environments/{env}/sharedflows/{sf}/revisions/{rev}/deployments, two permissions are required:
apigee.deployments.create on the resource organizations/{org}/environments/{env}
apigee.sharedflowrevisions.deploy on the resource organizations/{org}/sharedflows/{sf}/revisions/{rev}
HTTP request
POST https://apigee.googleapis.com/v1/{name=organizations/*/environments/*/sharedflows/*/revisions/*}/deployments
Required. Name of the shared flow revision to deploy in the following format: organizations/{org}/environments/{env}/sharedflows/{sharedflow}/revisions/{rev}
Query parameters
Parameters
override
boolean
Flag that specifies whether the new deployment replaces other deployed revisions of the shared flow in the environment. Set override to true to replace other deployed revisions. By default, override is false and the deployment is rejected if other revisions of the shared flow are deployed in the environment.
serviceAccount
string
Google Cloud IAM service account.
The service account represents the identity of the deployed proxy, and determines what permissions it has. The format must be {ACCOUNT_ID}@{PROJECT}.iam.gserviceaccount.com.
Authorization requires the following IAM permission on the specified resource serviceAccount:
iam.serviceAccounts.actAs
Request body
The request body must be empty.
Response body
If successful, the response body contains an instance of Deployment.
[[["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-07-09 UTC."],[[["This endpoint deploys a revision of a shared flow to a specified environment, making it usable."],["To replace an existing deployed revision of the same shared flow, the `override` parameter must be set to `true`."],["Deploying a shared flow requires two specific permissions: `apigee.deployments.create` and `apigee.sharedflowrevisions.deploy`, on specific resources."],["The request to deploy a shared flow revision is a `POST` request to a URL following a specific format, and it also supports several query parameters, including `override` and `serviceAccount`."],["The request body is empty, and the response body, if the request is successful, contains a deployment resource."]]],[]]
