Uploads a ZIP-formatted shared flow configuration bundle to an organization. If the shared flow already exists, this creates a new revision of it. If the shared flow does not exist, this creates it.
Once imported, the shared flow revision must be deployed before it can be accessed at runtime.
The size limit of a shared flow bundle is 15 MB.
HTTP request
POST https://apigee.googleapis.com/v1/{parent=organizations/*}/sharedflows
Required. The name of the parent organization under which to create the shared flow. Must be of the form: organizations/{organizationId}
If the 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 parent:
apigee.sharedflows.create
Query parameters
Parameters
action
string
Required. Must be set to either import or validate.
name
string
Required. The name to give the shared flow
space
string
Optional. The ID of the space to associated with this shared flow. Any IAM policies applied to the space will affect access to this shared flow. Note that this field is only respected when creating a new shared flow. It has no effect when creating a new revision for an existing shared flow.
Request body
The request body contains an instance of HttpBody.
Response body
If successful, the response body contains a newly created instance of SharedFlowRevision.
[[["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-28 UTC."],[[["\u003cp\u003eThis endpoint facilitates the uploading of a ZIP-formatted shared flow configuration bundle to an organization, creating a new revision if the shared flow exists, or creating the shared flow if it does not.\u003c/p\u003e\n"],["\u003cp\u003eThe shared flow must be deployed after importing before it can be accessed, and the maximum size limit for a shared flow bundle is 15 MB.\u003c/p\u003e\n"],["\u003cp\u003eThe HTTP request for uploading a shared flow is a POST request to \u003ccode\u003ehttps://apigee.googleapis.com/v1/{parent=organizations/*}/sharedflows\u003c/code\u003e, using gRPC Transcoding syntax.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires both \u003ccode\u003eparent\u003c/code\u003e as a path parameter and \u003ccode\u003eaction\u003c/code\u003e and \u003ccode\u003ename\u003c/code\u003e as query parameters, and the request body should contain an instance of \u003ccode\u003eHttpBody\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful responses will include a newly created instance of \u003ccode\u003eSharedFlowRevision\u003c/code\u003e, and the operation requires the OAuth scope \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# Method: organizations.sharedflows.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nUploads a ZIP-formatted shared flow configuration bundle to an organization. If the shared flow already exists, this creates a new revision of it. If the shared flow does not exist, this creates it.\n\nOnce imported, the shared flow revision must be deployed before it can be accessed at runtime.\n\nThe size limit of a shared flow bundle is 15 MB.\n\n### HTTP request\n\n`POST https://apigee.googleapis.com/v1/{parent=organizations/*}/sharedflows`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body contains an instance of [HttpBody](/apigee/docs/reference/apis/apigee/rest/v1/organizations.environments.keystores.aliases#HttpBody).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [SharedFlowRevision](/apigee/docs/reference/apis/apigee/rest/v1/organizations.sharedflows.revisions#SharedFlowRevision).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`"]]
