- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- IAM Permissions
Update an API resource in the API hub. The following fields in the [API][] can be updated:
display_name
description
owner
documentation
target_user
team
business_unit
maturity_level
attributes
The updateMask
should be used to specify the fields being updated.
Updating the owner field requires complete owner message and updates both owner and email fields.
HTTP request
PATCH https://apihub.googleapis.com/v1/{api.name=projects/*/locations/*/apis/*}
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters | |
---|---|
api.name |
Identifier. The name of the API resource in the API Hub. Format: |
Query parameters
Parameters | |
---|---|
updateMask |
Required. The list of fields to update. This is a comma-separated list of fully qualified names of fields. Example: |
Request body
The request body contains an instance of Api
.
Response body
If successful, the response body contains an instance of Api
.
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/cloud-platform
IAM Permissions
Requires the following IAM permission on the name
resource:
apihub.apis.update
For more information, see the IAM documentation.