Method: projects.locations.apis.create

Create an API resource in the API hub. Once an API resource is created, versions can be added to it.

HTTP request


The URL uses gRPC Transcoding syntax.

Path parameters



Required. The parent resource for the API resource. Format: projects/{project}/locations/{location}

Query parameters



Optional. The ID to use for the API resource, which will become the final component of the API's resource name. This field is optional.

  • If provided, the same will be used. The service will throw an error if the specified id is already used by another API resource in the API hub.
  • If not provided, a system generated id will be used.

This value should be 4-500 characters, and valid characters are /[a-z][A-Z][0-9]-_/.

Request body

The request body contains an instance of Api.

Response body

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

Authorization scopes

Requires the following OAuth scope:


IAM Permissions

Requires the following IAM permission on the parent resource:

  • apihub.apis.create

For more information, see the IAM documentation.