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

POST https://apihub.googleapis.com/v1/{parent=projects/*/locations/*}/apis

The URL usesgRPC Transcoding syntax.

Path parameters

Parameters
parent

string

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

Query parameters

Parameters
apiId

string

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 ofApi.

Response body

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

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

IAM Permissions

Requires the followingIAM permission on theparent resource:

  • apihub.apis.create

For more information, see theIAM documentation.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-07-28 UTC.