Method: organizations.apis.create

Creates an API proxy. The API proxy that is created using this call will not be accessible at runtime until the proxy is deployed to an environment.

This call can also be used to upload a ZIP-formatted API proxy configuration bundle from a local machine to an organization on Edge, if multipart/form-data is chosen as the content type and the name and action query parameters are provided. If the API proxy already exists, then create a new revision of the API proxy. If the API proxy does not exist, then create it.

Once imported, the API revision must be deployed before it can be accessed at runtime.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. The name of the parent organization under which to create this API proxy. Must be of the form: organizations/{organizationId}

Query parameters



The name of the API. Characters you can use in the name are restricted to: A-Za-z0-9._- .



Available actions: import, validate



Ignored. All uploads are validated regardless of the value of this field. It is kept for compatibility with existing APIs. Must be true or false if provided.

Request body

The request body contains an instance of HttpBody.

Response body

If successful, the response body contains a newly created instance of ApiProxyRevision.

Authorization Scopes

Requires the following OAuth scope: