Required. The parent resource for the External API resource. Format: projects/{project}/locations/{location}
Query parameters
Parameters
externalApiId
string
Optional. The ID to use for the External API resource, which will become the final component of the External 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 External 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 ExternalApi.
Response body
If successful, the response body contains a newly created instance of ExternalApi.
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/cloud-platform
IAM Permissions
Requires the following IAM permission on the parent resource:
[[["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-07-28 UTC."],[[["This endpoint creates a new External API resource within a specified project and location using a `POST` request to `https://apihub.googleapis.com/v1/{parent=projects/*/locations/*}/externalApis`."],["The `parent` path parameter is required, representing the project and location where the External API resource will reside, formatted as `projects/{project}/locations/{location}`."],["An optional `externalApiId` query parameter can be provided to specify the ID of the External API, otherwise a system-generated ID will be used."],["The request body must include an instance of the `ExternalApi` resource, and a successful response will return the newly created `ExternalApi` resource."],["Creating an External API resource requires the OAuth scope `https://www.googleapis.com/auth/cloud-platform` and the IAM permission `apihub.externalApis.create` on the `parent` resource."]]],[]]
