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."],[[["\u003cp\u003eThis endpoint creates a new External API resource within a specified project and location using a \u003ccode\u003ePOST\u003c/code\u003e request to \u003ccode\u003ehttps://apihub.googleapis.com/v1/{parent=projects/*/locations/*}/externalApis\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eparent\u003c/code\u003e path parameter is required, representing the project and location where the External API resource will reside, formatted as \u003ccode\u003eprojects/{project}/locations/{location}\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAn optional \u003ccode\u003eexternalApiId\u003c/code\u003e query parameter can be provided to specify the ID of the External API, otherwise a system-generated ID will be used.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must include an instance of the \u003ccode\u003eExternalApi\u003c/code\u003e resource, and a successful response will return the newly created \u003ccode\u003eExternalApi\u003c/code\u003e resource.\u003c/p\u003e\n"],["\u003cp\u003eCreating an External API resource requires the OAuth scope \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e and the IAM permission \u003ccode\u003eapihub.externalApis.create\u003c/code\u003e on the \u003ccode\u003eparent\u003c/code\u003e resource.\u003c/p\u003e\n"]]],[],null,[]]
